独立站插件（dulizhan）使用说明

版本：1.0.0 ｜ 作者：Zsens Admin ｜ 适用宿主：Zsens Admin（社区版）

把社区的分类或独立页面绑定到单独域名，访问该域名时呈现为一个拥有独立站点名称、Logo、副标题、Favicon 与 SEO 的完整新站点。内容仍然来自主站，无需复制数据、无需再部署一套程序。

一、功能概览

• 分类建站：把一个社区分类绑定为某个域名的首页，域名下展示该分类的帖子列表。
• 单页建站：把一个独立页面（如「关于我们」「服务条款」）绑定为域名首页。
• 独立品牌：每个域名可单独设置站点名称、副标题、Logo、Favicon。
• 独立 SEO：每个域名可单独设置 SEO 标题、关键词、描述。
• 完整社区能力：绑定域名下同样可以使用帖子详情、发帖、回复、会员中心、登录注册等全部前台功能，样式沿用当前主题。
• 后台隔离：后台入口只能从主域名进入，绑定域名下访问 /admin 一律 404。
• 多站共存：一个主站可绑定任意多个域名，每个域名独立配置、独立启停。

二、工作原理

1. 每次前台请求进入路由阶段时，插件读取当前请求的 Host；
2. SiteResolver 对 Host 做归一化（去协议、端口、路径、尾点、www.），在启用中的绑定记录里查找；
3. 命中后，为该域名注册 ThinkPHP 域名路由，路由规则镜像社区全部前台路由，并额外注册 / 作为站点首页；
4. 前台控制器继承社区前台控制器，在初始化阶段覆盖站点品牌与 SEO 变量；
5. 域名组内未命中的路径统一返回 404，避免回落到主站路由（同时阻断后台入口）。

绑定记录有 5 分钟缓存；后台的新增、编辑、删除、启停操作会立即清除缓存。

三、安装与启用

1. 把 plugins/dulizhan 目录整体上传到项目的 plugins/ 下；
2. 后台「应用中心 → 独立站 → 安装」；
3. 安装完成后插件默认启用，左侧菜单出现「独立站」；
4. 可在「应用中心 → 独立站 → 配置」中通过「启用独立站」开关全局启停。

卸载会删除 {前缀}dulizhan_site 表，绑定配置将不可恢复，请先备份。

四、部署前置条件

绑定域名能否访问，取决于服务器与 DNS 配置，请逐项确认：

1. DNS 解析

在域名服务商处为绑定域名添加解析记录，指向本站服务器：

使用 CDN 时按 CDN 要求配置 CNAME。

2. Web 服务器绑定域名

Nginx：把域名加入站点 server_name，根目录仍指向本系统 public：

server {
    listen 80;
    server_name bbs.example.com www.bbs.example.com;
    root /www/zsadmin/public;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php$is_args$args;
    }

    location ~ \.php$ {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

Apache：在站点 VirtualHost 中加入 ServerName / ServerAlias，DocumentRoot 指向 public，并沿用主站伪静态规则。

3. 伪静态

绑定域名的伪静态规则与主站保持一致即可，无需额外配置。

4. HTTPS

若使用 HTTPS，请为该域名单独配置证书（或使用泛域名证书），否则浏览器会出现证书告警。

五、后台添加绑定

后台 → 独立站 → 新增：

保存规则：

• 域名格式必须合法，且不能绑定后台当前所在域名；
• 同一域名只能绑定一条记录（数据库唯一索引）；
• www 与裸域名自动同时生效，无需分别添加；
• 保存、删除、启停后缓存自动刷新，立即生效。

六、域名下的访问规则

SEO 覆盖细节：

• 分类站：站点 SEO 标题/关键词/描述非空时，覆盖该分类自身的 SEO；为空则沿用分类 SEO。
• 单页站：站点 SEO 只作用于绑定的目标单页；站内其它单页仍使用各自页面的 SEO。

七、缓存与生效

• 绑定记录缓存 5 分钟（dulizhansitesv1）；
• 后台任何增删改、启停操作都会立即清缓存；
• 如果直接修改数据库，需等待最多 5 分钟或清理系统缓存；
• Favicon 更换后浏览器可能仍显示旧图标，强制刷新或清除浏览器缓存即可。

八、常见问题

九、数据结构

表 {前缀}dulizhan_site：

十、文件结构

plugins/dulizhan/
├── plugin.json              插件信息
├── install.sql              绑定表结构
├── icon.svg                 插件图标
├── routes.php               域名路由注册 + 后台路由
├── DulizhanPlugin.php       安装 / 卸载 / 配置 / 菜单
├── controller/
│   ├── Site.php             前台控制器（品牌覆盖、分类站、单页站）
│   └── admin/
│       ├── Base.php         后台基类
│       └── Index.php        绑定列表 / 新增 / 编辑 / 删除 / 启停
├── model/
│   └── Site.php             绑定模型
├── service/
│   ├── SiteResolver.php     域名解析、归一化与缓存
│   └── SiteRoutes.php       前台路由镜像
└── view/admin/
    ├── index.html           绑定列表
    └── form.html            新增 / 编辑表单