服务器更换 IP 后 pbootCMS 授权域名绑定失效怎么解

更换服务器 IP 本身通常不会直接导致 PbootCMS 授权失效，因为授权是绑定域名的，但迁移过程中伴随的环境变化（如 PHP 版本、缓存、解析未生效）会让系统误判，重点检查域名解析指向和后台授权码状态。

先说结论：授权绑定的是域名而非 IP，更换 IP 后失效多为解析未同步或环境兼容性问题，需重新验证授权。

先备份：操作前务必备份数据库与网站文件，防止误操作。
先确认：域名 A 记录是否已正确解析到新服务器公网 IP。
再处理：检查 PHP 版本兼容性，必要时在后台重新提交授权码。
后验证：清除系统缓存后，访问前台及后台确认授权提示消失。

操作前备份指南

在进行任何配置修改或文件删除前，请务必备份当前环境，以便出现问题时快速回滚。

# 1. 备份数据库（以 MySQL 为例）
mysqldump -u 数据库用户名 -p 数据库名 > /home/backup/db_backup.sql

# 2. 备份网站文件
tar -zcf /home/backup/www_backup.tar.gz /www/wwwroot/你的域名

排查与修复步骤

按顺序排查，避免盲目操作导致问题复杂化。

检查域名解析
登录域名解析管理平台，确认 A 记录的值已修改为新服务器的公网 IP。注意区分内网 IP 与公网 IP，内网 IP 无法用于外部访问。修改后等待 TTL 生效，通常几分钟到几小时不等。
确认网站根目录路径
在执行删除命令前，务必确认当前所在目录。使用pwd命令查看路径，避免误删系统文件。
```
cd /www/wwwroot/你的域名
pwd
```
清除缓存文件
通过 FTP 或 SSH 删除网站根目录下/runtime/cache/文件夹中的所有文件。不要删除runtime目录本身，只清空内部缓存文件。
```
# 示例命令（请根据 pwd 确认路径后执行）
rm -rf /www/wwwroot/你的域名/runtime/cache/*
```
核对 PHP 环境
登录服务器管理面板（如宝塔），查看当前站点 PHP 版本。建议使用 PHP 7.2 或 7.4 版本。部分授权检测逻辑在过高或过低版本下可能存在兼容性差异，避免使用已停止维护的 PHP 7.0。
重新提交授权
登录 PbootCMS 后台，进入“系统设置 > 基础配置 > 授权设置”。即使之前填过，也建议重新复制官网生成的授权码填入。确保授权域名与当前访问域名完全一致（包含 http 或 https 前缀）。

怎么验证是否生效

完成上述步骤后，通过以下方式确认修复：

前台访问：浏览器无痕模式访问网站首页，确认不再出现“未授权”或相关提示信息。
后台状态：登录后台，查看授权设置页面，确认授权状态显示为已授权，且授权域名显示正确。
日志检查：如果仍有问题，查看/runtime/log/下的日志文件，确认是否有授权接口请求失败的报错。

常见风险与坑

PHP 版本风险：PHP 7.0 已停止维护，存在安全漏洞且新版 CMS 可能不支持，建议切换至 PHP 7.2 或 7.4 版本测试。
中文域名未转码：如果域名包含中文，直接在后台填写可能提示“域名格式有误”。需先将中文域名转为 Punycode 格式（如xn--开头），用转码后的字符串进行授权。
sn.html 误区：有教程建议在根目录创建sn.html来自定义未授权提示。这只能掩盖提示信息，并不能真正解决授权失效问题，生产环境不建议长期依赖此方法。
多站点配置：如果开启了多站点功能，需确保config/site.php中配置的域名与当前解析一致，否则插件可能无法正确识别站点 ID 导致授权校验异常。