EyouCMS多站点分站配置全流程实操指南详解

一、前置环境检查与准备

在进行EyouCMS分站配置之前，必须确保服务器环境满足运行要求，否则后续配置会出现各种未知报错。请按照以下清单逐项检查：

• PHP版本：建议使用PHP 7.1或7.4版本（需确保PHP已安装并正常运行）。
• 必要扩展：检查PHP是否已开启GD库（图片处理）、Curl（远程请求）、Mbstring（字符编码）等扩展。
• 目录权限：确保EyouCMS安装目录具有写入权限，特别是/data、/runtime、/public/uploads目录，权限需设置为755或777。
• 主站运行状态：确保主站（默认站点）已经可以正常访问，后台能正常登录。

二、域名解析与服务器绑定

分站配置的第一步是在域名服务商和Web服务器层面完成域名指向。本教程以分站域名sub.example.com为例，主站域名为www.example.com。

1. 域名解析配置

登录你的域名服务商控制台（如阿里云、腾讯云），找到example.com域名，进入解析列表。

• 点击添加记录。
• 记录类型选择：CNAME（如果解析到服务器域名）或 A（如果解析到服务器IP）。
• 主机记录填写：sub（即分站的前缀）。
• 记录值填写：服务器IP地址或主域名。
• TTL保持默认，点击保存。

2. Web服务器绑定（Nginx为例）

登录服务器，打开Nginx配置文件（通常在/www/server/panel/vhost/nginx/或/etc/nginx/conf.d/）。EyouCMS分站通常与主站共用一套程序代码，因此root路径指向必须与主站完全一致。

新建或编辑分站对应的配置文件sub.example.com.conf，内容如下：

```nginx server { listen 80; server_name sub.example.com; 核心配置：root路径必须与主站保持一致，通常指向public目录 root /www/wwwroot/www.example.com/public; index index.php index.html index.htm; 开启rewrite支持伪静态 if (!-e $request_filename) { rewrite ^(.)$ /index.php?s=$1 last; break; } location ~ \.php$ { fastcgi_pass unix:/tmp/php-cgi-74.sock; 根据实际PHP版本调整sock路径 fastcgi_index index.php; include fastcgi.conf; } location ~ ..(gif|jpg|jpeg|png|bmp|swf)$ { expires 30d; } access_log /www/wwwroot/sub.example.com.log; } ```

配置完成后，执行命令nginx -t检查语法，无误后执行nginx -s reload重载配置。如果是Apache环境，需确保httpd.conf中开启了mod_rewrite模块，并添加对应的VirtualHost配置，DocumentRoot同样指向主站的public目录。

三、后台添加与管理分站

服务器配置生效后，即可进入EyouCMS后台进行逻辑层面的分站添加。

1. 进入站点管理模块

使用管理员账号登录EyouCMS后台，点击顶部菜单栏的系统，在下拉菜单中选择站点管理。

2. 新增分站

在站点管理列表页，点击右上角的新增站点按钮。在弹出的表单中，准确填写以下信息：

• 站点名称：用于后台识别的名称，例如“移动端分站”或“英文站”。
• 站点域名：填写刚才解析并绑定的域名sub.example.com。注意：只需填写域名，不要带http://或结尾的斜杠。
• 站点目录：这是分站的核心标识。
  • 如果是独立域名模式（推荐），此栏目通常留空，系统会自动通过域名识别。
  • 如果是二级目录模式（如www.example.com/en），则填写目录名称en。本教程按独立域名模式处理，此处留空。
• 站点标题/关键词/描述：填写该分站专属的SEO信息。
• 模板风格：选择该分站将要使用的模板风格目录名称（例如：default_en）。
• 状态：选择开启。

填写完毕后，点击提交。

四、分站模板与资源配置

为了让分站显示不同的界面，需要准备独立的模板文件，并确保资源路径正确。

1. 准备分站模板

通过FTP或文件管理器，进入网站根目录下的/template/pc/（PC端）或/template/mobile/（移动端）目录。

• 复制一份default文件夹。
• 将复制的文件夹重命名为分站对应的模板风格目录名，例如sub_style。
• 进入该目录，修改index.htm等文件中的HTML代码，调整Logo、Banner等视觉元素，确保与主站有所区分。

2. 关联模板风格

回到EyouCMS后台的站点管理列表，找到刚才添加的分站，点击右侧的编辑按钮。在“模板风格”下拉框中，选择刚才创建的sub_style，点击保存。

3. 处理静态资源路径

分站通常会共用主站的静态资源（CSS、JS、图片）。如果分站需要独立的静态资源，建议在/public/目录下新建一个与模板风格同名的文件夹（如/public/sub_style/），并在模板文件中引用：

```html ```

如果共用资源，直接使用/public/static/...路径即可，无需修改。

五、分站内容独立化配置（可选）

默认情况下，EyouCMS分站可以共用主站的数据表，也可以通过栏目归属来实现内容分离。如果需要分站显示完全独立的内容，请执行以下步骤：

1. 创建分站专属栏目

进入内容 -> 栏目管理。点击新增栏目。

• 栏目名称：例如“分站新闻”。
• 所属模型：选择文章模型或产品模型。
• 绑定站点：这一步至关重要，在高级设置或属性选项中，找到“绑定站点”或“适用站点”选项，勾选刚才创建的分站，取消勾选主站。

2. 发布内容

进入内容发布，选择刚才创建的“分站新闻”栏目进行文章发布。此时，这些内容只会在sub.example.com域名下被渲染，主站不会调用这些数据。

六、伪静态规则配置与测试

为了SEO优化，分站必须配置伪静态规则，去除URL中的index.php。

1. 后台开启伪静态

进入后台系统 -> 系统设置 -> URL设置。勾选开启伪静态，并选择URL模式为rewrite模式。点击保存。

2. 验证分站访问

打开浏览器，访问http://sub.example.com。

• 现象1：页面显示与主站不同，且URL不带index.php，说明配置成功。
• 现象2：显示404 Not Found。请检查Nginx配置中的if (!-e $request_filename)规则是否正确，且是否已重载Nginx。
• 现象3：显示主站内容。请检查后台站点管理中，该域名的“站点目录”设置是否为空（独立域名模式），并确认模板风格是否正确分配。
• 现象4：样式/图片全丢。按F12查看控制台，发现资源请求到了主域名。这是模板代码中使用了硬编码的绝对路径。需检查模板文件，将http://www.example.com...替换为相对路径/public/...。

七、常见故障排查清单

如果在配置过程中遇到问题，请按以下顺序排查：

1. 域名DNS是否生效？使用ping命令ping sub.example.com，看是否解析到服务器IP。
2. 服务器是否监听80端口？检查防火墙或安全组（如阿里云安全组）是否放行80端口。
3. 权限问题？确保/runtime目录下自动生成了分站对应的缓存目录。如果没有，请手动赋予755权限。
4. 配置冲突？如果服务器安装了宝塔面板，请确保宝塔面板的站点设置中没有勾选“强制HTTPS”或其他重定向规则干扰了分站访问。
5. 清除缓存：每次修改后台配置或模板后，务必在后台点击系统 -> 清除缓存，防止浏览器或服务器缓存了旧的配置数据。