PbootCMS双域名配置实操指南:一次部署,两个入口
详解PbootCMS如何让一个网站响应两个域名:从官网授权申请、后台填写规范、Web服务器配置到常见报错排查,全程基于v3.5.2真实环境验证。
为什么企业需要让一个网站响应两个域名?
中小企业在品牌拓展或区域运营中,常面临这样的实际需求:主域名(如 `www.company.com`)用于全国业务,而二级地域域名(如 `shanghai.company.com`)或拼音域名(如 `company-cn.com`)需同步指向同一套内容。这类场景不涉及镜像站或跳转,而是要求用户无论输入哪个域名,都能正常访问首页、栏目页与内容页,且后台统一管理、SEO权重不分散。
这并非简单的 DNS 解析或服务器别名设置,而是涉及 PbootCMS 授权机制、Web 服务配置与程序逻辑三者的协同。很多用户尝试仅修改 Nginx/Apache 的 `server_name` 或宝塔的“多域名绑定”,结果发现后台登录异常、验证码失效、甚至前台页面报错——根源在于授权校验环节未通过。
PbootCMS 的域名授权机制是关键前提
PbootCMS 自 v3.1.6 起引入了域名白名单授权机制,其核心逻辑是:系统启动时会比对当前请求的 `HTTP_HOST`(即浏览器地址栏中的域名)是否存在于后台填写的授权码列表中。若不匹配,部分功能(尤其是涉及安全验证的模块)将主动限制响应。
授权码本身由两组五位字符构成,格式为 `XXXXX,YYYYY`,中间用英文逗号分隔。每组对应一个已向官方平台注册并生成的合法域名。注意:这不是任意填写的字符串,必须是通过 pbootcms.com 官网「授权中心」为具体域名申请所得。
因此,“绑定两个域名”的本质,是将两个独立申请的授权码,按规范格式填入后台系统设置,并确保 Web 服务器层面允许这两个域名同时解析到该站点根目录。
后台配置步骤(以 PbootCMS v3.5.2 为例)
进入后台 → 系统管理 → 系统参数设置 → 基础设置 → 网站授权码
此处填写格式必须严格遵循:
12345,56789,abcde,fghij
其中 `12345,56789` 是第一个域名(如 `www.company.com`)的授权码,`abcde,fghij` 是第二个域名(如 `company-cn.com`)的授权码,两组之间用英文逗号隔开,不允许空格、中文逗号、换行或额外符号。
保存后无需重启服务,但建议清除浏览器缓存及后台运行缓存(后台 → 系统管理 → 清除缓存)。

Web 服务器端必须同步完成域名映射
仅修改后台授权码仍不足够。若服务器未识别第二个域名,请求根本无法到达 PHP 解析层,自然不会触发授权校验。
宝塔面板用户操作路径:
进入网站管理 → 找到对应站点 → 修改
在「域名管理」中点击「添加域名」,输入第二个域名(如 `company-cn.com`)
确保该域名已完成 DNS 解析(A 记录指向服务器 IP)
保存后,宝塔会自动更新 Nginx 配置中的 `server_name` 指令,例如:
server_name www.company.com company-cn.com;
手动配置 Nginx 用户(非宝塔环境):
编辑站点配置文件(如 `/www/wwwroot/company/conf/nginx.conf`),确认 `server` 块内包含:
server {
listen 80;
server_name www.company.com company-cn.com;
root /www/wwwroot/company;
# 其他 location 配置保持不变
}
修改后执行 `nginx -t && nginx -s reload` 验证并重载。
Apache 用户则需检查虚拟主机配置中 `ServerAlias` 是否已添加第二域名。
常见失败原因与对应排查点
现象:输入第二个域名可打开首页,但进入后台提示“授权失败”
→ 检查后台「网站授权码」字段是否漏掉第二组码,或误用了中文逗号。
现象:第二个域名访问时所有页面显示 404,但第一个域名正常
→ 登录服务器执行 `curl -I http://company-cn.com`,观察返回状态码。若为 404 且非 PHP 报错,则说明请求未被正确路由至 PbootCMS 入口文件,应检查 Web 服务配置中的域名绑定是否生效。
现象:两个域名均能访问前台,但表单提交失败或验证码不显示
→ 此类交互功能依赖 session 和 referer 校验,需确认两个域名的 Cookie 域名策略是否一致。建议在 `config/config.php` 中显式设置:
'cookie_domain' => '.company.com', // 注意开头的点号,表示泛域名
关于 PbootCMS环境部署 的延伸提醒
双域名运行对基础环境提出更高一致性要求。推荐在部署阶段即完成多域名适配规划:使用宝塔面板统一管理 SSL 证书(支持通配符或多个域名)、确保 PHP 的 `open_basedir` 设置覆盖全部域名对应路径、关闭可能干扰的 ModSecurity 规则。这些细节虽不直接出现在授权流程中,却是长期稳定运行的底层保障。
PbootCMS成品源码本身不区分单/多域名,其适配能力完全取决于部署阶段的配置精度与系统参数设置的完整性。
实际应用中的边界注意事项
该方案适用于同服务器、同根目录下的多域名共存,不适用于跨子目录(如 `/shanghai/`)或跨服务器部署;
两个域名共享同一数据库与全部内容,无法实现栏目级权限隔离;
常见问题
关于《PbootCMS双域名配置实操指南:一次部署,两个入口》的 FAQ
《PbootCMS双域名配置实操指南:一次部署,两个入口》这篇教程主要讲了什么?
详解PbootCMS如何让一个网站响应两个域名:从官网授权申请、后台填写规范、Web服务器配置到常见报错排查,全程基于v3.5.2真实环境验证。
按照《PbootCMS双域名配置实操指南:一次部署,两个入口》教程操作遇到报错怎么办?
请优先核对代码或配置是否完全复制。如果是环境或权限问题,建议查阅本站的“常见问题排查”板块,或通过侧边栏联系客服获取技术支持。
本站的 PbootCMS 教程是免费的吗?
是的,乐帮模板提供的所有 PbootCMS 教程、标签手册与排错指南均完全免费开放阅读。我们致力于帮助大家降低建站门槛。
这篇教程里的代码可以直接复制到我的网站使用吗?
可以直接使用。复制代码时,请注意将代码中的 ID、栏目编码(scode)等占位符,替换为您自己网站的真实数据即可。