first commit

2026-06-03 10:09:03 +08:00
commit 81f5039458
6266 changed files with 188236 additions and 0 deletions
@@ -0,0 +1,348 @@
+# 多租户二级域名绑定官网系统 - 配置指南
+
+## 一、后端配置（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 ~^(?<subdomain>.+)\.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 ~^(?<subdomain>.+)\.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`