# 多租户二级域名绑定官网系统 - 配置指南 ## 一、后端配置（ThinkPHP） ### 1. 中间件配置 文件：`tp/app/common/middleware/DomainParse.php` 需要修改的配置项（第14-15行）： ```php $adminDomains = ['admin.xxx.com']; // 后台域名 $platformDomains = ['www.xxx.com']; // 平台官网域名 ``` 根据实际情况修改为你购买的域名。 ### 2. 已创建的API接口 | 接口 | 路径 | 方法 | 说明 | |------|------|------|------| | 主域名列表 | `/admin/domain/pool` | GET | 获取域名池列表 | | 启用的主域名 | `/admin/domain/pool/getEnabledDomains` | GET | 获取可用主域名 | | 创建主域名 | `/admin/domain/pool/create` | POST | 添加主域名 | | 更新主域名 | `/admin/domain/pool/update` | POST | 编辑主域名 | | 删除主域名 | `/admin/domain/pool/delete/:id` | DELETE | 删除主域名 | | 切换主域名状态 | `/admin/domain/pool/toggleStatus` | POST | 启用/禁用 | | 租户域名列表 | `/admin/domain/tenant` | GET | 获取所有租户域名 | | 我的域名 | `/admin/domain/tenant/myDomains` | GET | 租户获取自己的域名 | | 申请域名 | `/admin/domain/tenant/apply` | POST | 租户申请二级域名 | | 审核域名 | `/admin/domain/tenant/audit` | POST | 管理员审核 | | 切换租户域名状态 | `/admin/domain/tenant/toggleStatus` | POST | 禁用域名 | --- ## 二、前端配置（Vue） ### 1. 页面路由 需要在后台管理系统中添加菜单： | 菜单名称 | 路径 | 组件 | |----------|------|------| | 主域名池 | `/cms/domain/pool` | `apps/cms/domain/pool.vue` | | 域名审核 | `/cms/domain/audit` | `apps/cms/domain/audit.vue` | | 我的域名 | `/tenant/domain` | `basicSettings/tenants/domain.vue` | ### 2. 菜单SQL（可选） ```sql -- 主域名池管理菜单 INSERT INTO `mete_menu` (`name`, `title`, `path`, `component`, `parent_id`, `sort`, `status`) VALUES ('DomainPool', '主域名池', '/cms/domain/pool', 'apps/cms/domain/pool', 0, 0, 1); -- 租户域名审核菜单 INSERT INTO `mete_menu` (`name`, `title`, `path`, `component`, `parent_id`, `sort`, `status`) VALUES ('DomainAudit', '域名审核', '/cms/domain/audit', 'apps/cms/domain/audit', 0, 0, 1); ``` --- ## 三、Nginx 配置 ### 完整配置示例 ## 注意啊！要先把ssl申请下来再用上面的配置，不然报错！！！ ## 注意啊！要先把ssl申请下来再用上面的配置，不然报错！！！ ## 注意啊！要先把ssl申请下来再用上面的配置，不然报错！！！ ``` yunzer.com.cn server { listen 80; listen 443 ssl; listen 443 quic; http2 on; server_name yunzer.com.cn ~^(?.+)\.yunzer\.com\.cn$; index index.php index.html index.htm default.php default.htm default.html; root /www/wwwroot/api.yunzer.cn/public; #CERT-APPLY-CHECK--START include /www/server/panel/vhost/nginx/well-known/yunzer.com.cn.conf; #CERT-APPLY-CHECK--END include /www/server/panel/vhost/nginx/extension/yunzer.com.cn/*.conf; #SSL-START SSL相关配置，请勿删除或修改下一行带注释的404规则 #error_page 404/404.html; #HTTP_TO_HTTPS_START set $isRedcert 1; if ($server_port != 443) { set $isRedcert 2; } if ( $uri ~ /\.well-known/ ) { set $isRedcert 1; } if ($isRedcert != 1) { rewrite ^(/.*)$ https://$host$1 permanent; } #HTTP_TO_HTTPS_END ssl_certificate /www/server/panel/vhost/cert/yunzer.com.cn/fullchain.pem; ssl_certificate_key /www/server/panel/vhost/cert/yunzer.com.cn/privkey.pem; ssl_protocols TLSv1.1 TLSv1.2 TLSv1.3; ssl_ciphers EECDH+CHACHA20:EECDH+CHACHA20-draft:EECDH+AES128:RSA+AES128:EECDH+AES256:RSA+AES256:EECDH+3DES:RSA+3DES:!MD5; ssl_prefer_server_ciphers on; ssl_session_tickets on; ssl_session_cache shared:SSL:10m; ssl_session_timeout 10m; add_header Strict-Transport-Security "max-age=31536000"; add_header Alt-Svc 'quic=":443"; h3=":443"; h3-29=":443"; h3-27=":443";h3-25=":443"; h3-T050=":443"; h3-Q050=":443";h3-Q049=":443";h3-Q048=":443"; h3-Q046=":443"; h3-Q043=":443"'; error_page 497 https://$host$request_uri; #SSL-END #ERROR-PAGE-START 错误页配置，可以注释、删除或修改 error_page 404 /404.html; #error_page 502 /502.html; #ERROR-PAGE-END #PHP-INFO-START PHP引用配置，可以注释或修改 include enable-php-82.conf; #PHP-INFO-END #REWRITE-START URL重写规则引用,修改后将导致面板设置的伪静态规则失效 include /www/server/panel/vhost/rewrite/yunzer.com.cn.conf; #REWRITE-END # 禁止访问的敏感文件 location ~* (\.user.ini|\.htaccess|\.htpasswd|\.env.*|\.project|\.bashrc|\.bash_profile|\.bash_logout|\.DS_Store|\.gitignore|\.gitattributes|LICENSE|README\.md|CLAUDE\.md|CHANGELOG\.md|CHANGELOG|CONTRIBUTING\.md|TODO\.md|FAQ\.md|composer\.json|composer\.lock|package(-lock)?\.json|yarn\.lock|pnpm-lock\.yaml|\.\w+~|\.swp|\.swo|\.bak(up)?|\.old|\.tmp|\.temp|\.log|\.sql(\.gz)?|docker-compose\.yml|docker\.env|Dockerfile|\.csproj|\.sln|Cargo\.toml|Cargo\.lock|go\.mod|go\.sum|phpunit\.xml|phpunit\.xml|pom\.xml|build\.gradl|pyproject\.toml|requirements\.txt|application(-\w+)?\.(ya?ml|properties))$ { return 404; } # 禁止访问的敏感目录 location ~* /(\.git|\.svn|\.bzr|\.vscode|\.claude|\.idea|\.ssh|\.github|\.npm|\.yarn|\.pnpm|\.cache|\.husky|\.turbo|\.next|\.nuxt|node_modules|runtime)/ { return 404; } #一键申请SSL证书验证目录相关设置 location ~ \.well-known{ allow all; } #禁止在证书验证目录放入敏感文件 if ( $uri ~ "^/\.well-known/.*\.(php|jsp|py|js|css|lua|ts|go|zip|tar\.gz|rar|7z|sql|bak)$" ) { return 403; } location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$ { expires 30d; error_log /dev/null; access_log /dev/null; } location ~ .*\.(js|css)?$ { expires 12h; error_log /dev/null; access_log /dev/null; } # 传递子域名参数给TP location ~ [^/]\.php(/|$) { include enable-php-82.conf; fastcgi_param HTTP_SUBDOMAIN $subdomain; fastcgi_param HTTP_MAIN_DOMAIN yunzer.com.cn; } # TP路由重写（正确格式，无$s变量） if (!-e $request_filename) { rewrite ^(.*)$ /index.php?$1 last; } access_log /www/wwwlogs/yunzer.com.cn.log; error_log /www/wwwlogs/yunzer.com.cn.error.log; } ``` ``` dh2.fun server { listen 80; listen 443 ssl; listen 443 quic; http2 on; server_name dh2.fun ~^(?.+)\.dh2\.fun$; index index.php index.html index.htm default.php default.htm default.html; root /www/wwwroot/api.yunzer.cn/public; #CERT-APPLY-CHECK--START include /www/server/panel/vhost/nginx/well-known/dh2.fun.conf; #CERT-APPLY-CHECK--END include /www/server/panel/vhost/nginx/extension/dh2.fun/*.conf; #SSL-START SSL相关配置，请勿删除或修改下一行带注释的404规则 #error_page 404/404.html; #HTTP_TO_HTTPS_START set $isRedcert 1; if ($server_port != 443) { set $isRedcert 2; } if ( $uri ~ /\.well-known/ ) { set $isRedcert 1; } if ($isRedcert != 1) { rewrite ^(/.*)$ https://$host$1 permanent; } #HTTP_TO_HTTPS_END ssl_certificate /www/server/panel/vhost/cert/dh2.fun/fullchain.pem; ssl_certificate_key /www/server/panel/vhost/cert/dh2.fun/privkey.pem; ssl_protocols TLSv1.1 TLSv1.2 TLSv1.3; ssl_ciphers EECDH+CHACHA20:EECDH+CHACHA20-draft:EECDH+AES128:RSA+AES128:EECDH+AES256:RSA+AES256:EECDH+3DES:RSA+3DES:!MD5; ssl_prefer_server_ciphers on; ssl_session_tickets on; ssl_session_cache shared:SSL:10m; ssl_session_timeout 10m; add_header Strict-Transport-Security "max-age=31536000"; add_header Alt-Svc 'quic=":443"; h3=":443"; h3-29=":443"; h3-27=":443";h3-25=":443"; h3-T050=":443"; h3-Q050=":443";h3-Q049=":443";h3-Q048=":443"; h3-Q046=":443"; h3-Q043=":443"'; error_page 497 https://$host$request_uri; #SSL-END #ERROR-PAGE-START 错误页配置，可以注释、删除或修改 error_page 404 /404.html; #error_page 502 /502.html; #ERROR-PAGE-END #PHP-INFO-START PHP引用配置，可以注释或修改 include enable-php-82.conf; #PHP-INFO-END #REWRITE-START URL重写规则引用,修改后将导致面板设置的伪静态规则失效 include /www/server/panel/vhost/rewrite/dh2.fun.conf; #REWRITE-END # 禁止访问的敏感文件 location ~* (\.user.ini|\.htaccess|\.htpasswd|\.env.*|\.project|\.bashrc|\.bash_profile|\.bash_logout|\.DS_Store|\.gitignore|\.gitattributes|LICENSE|README\.md|CLAUDE\.md|CHANGELOG\.md|CHANGELOG|CONTRIBUTING\.md|TODO\.md|FAQ\.md|composer\.json|composer\.lock|package(-lock)?\.json|yarn\.lock|pnpm-lock\.yaml|\.\w+~|\.swp|\.swo|\.bak(up)?|\.old|\.tmp|\.temp|\.log|\.sql(\.gz)?|docker-compose\.yml|docker\.env|Dockerfile|\.csproj|\.sln|Cargo\.toml|Cargo\.lock|go\.mod|go\.sum|phpunit\.xml|phpunit\.xml|pom\.xml|build\.gradl|pyproject\.toml|requirements\.txt|application(-\w+)?\.(ya?ml|properties))$ { return 404; } # 禁止访问的敏感目录 location ~* /(\.git|\.svn|\.bzr|\.vscode|\.claude|\.idea|\.ssh|\.github|\.npm|\.yarn|\.pnpm|\.cache|\.husky|\.turbo|\.next|\.nuxt|node_modules|runtime)/ { return 404; } #一键申请SSL证书验证目录相关设置 location ~ \.well-known{ allow all; } #禁止在证书验证目录放入敏感文件 if ( $uri ~ "^/\.well-known/.*\.(php|jsp|py|js|css|lua|ts|go|zip|tar\.gz|rar|7z|sql|bak)$" ) { return 403; } location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$ { expires 30d; error_log /dev/null; access_log /dev/null; } location ~ .*\.(js|css)?$ { expires 12h; error_log /dev/null; access_log /dev/null; } # 传递子域名参数给TP location ~ [^/]\.php(/|$) { include enable-php-82.conf; fastcgi_param HTTP_SUBDOMAIN $subdomain; fastcgi_param HTTP_MAIN_DOMAIN dh2.fun; } # TP路由重写（正确格式，无$s变量） if (!-e $request_filename) { rewrite ^(.*)$ /index.php?$1 last; } access_log /www/wwwlogs/dh2.fun.log; error_log /www/wwwlogs/dh2.fun.error.log; } ``` ## 注意啊！要先把ssl申请下来再用上面的配置，不然报错！！！ ## 注意啊！要先把ssl申请下来再用上面的配置，不然报错！！！ ## 注意啊！要先把ssl申请下来再用上面的配置，不然报错！！！ --- ## 四、DNS 解析配置 在你的域名服务商（阿里云、腾讯云等）控制台添加： | 记录类型 | 主机记录 | 记录值 | |----------|----------|--------| | A | @ | 服务器IP | | A | www | 服务器IP | | A | admin | 服务器IP | | CNAME | * | @ | 其中 `*` 表示泛解析，会匹配所有二级域名。 --- ## 五、使用流程 ### 1. 管理员操作 1. 登录后台管理系统 2. 进入「主域名池」管理，添加已购买的主域名（如 `xxx.com`） 3. 审核租户申请的二级域名 ### 2. 租户操作 1. 租户登录后台 2. 进入「我的域名」页面 3. 选择主域名，填写二级前缀，提交申请 4. 等待管理员审核 5. 审核通过后，访问 `http://二级域名.xxx.com` 即可访问官网 ### 3. 访问规则 - `admin.xxx.com` → 后台管理系统 - `www.xxx.com` / `xxx.com` → 平台官网 - `其他二级域名` → 对应租户的官网 --- ## 六、注意事项 1. **泛域名解析**：确保DNS已配置泛解析 `*.yourdomain.com` 2. **域名状态**：只有状态为"已生效"的域名才能正常访问 3. **软删除**：所有删除操作都是软删除，数据不会真正删除 4. **tenant_id**：所有数据通过 `tenant_id` 做租户隔离 --- ## 七、文件清单 ### 后端 - `tp/app/admin/controller/Cms/Domain/DomainPoolController.php` - `tp/app/admin/controller/Cms/Domain/TenantDomainController.php` - `tp/app/admin/route/routes/domain.php` - `tp/app/common/middleware/DomainParse.php` ### 前端 - `backend/src/api/domain.js` - `backend/src/views/apps/cms/domain/pool.vue` - `backend/src/views/apps/cms/domain/audit.vue` - `backend/src/views/basicSettings/tenants/domain.vue`