采集模块集体“罢工”，报错“获取远程数据失败”
报错现象： 搬家到新服务器后，后台采集器全部失效，手动采集时提示“获取远程数据失败”或“连接超时”，但前台页面访问正常。
原因分析：
虚拟主机通常默认开启allow_url_fopen，而独立服务器（尤其是宝塔面板默认配置）常因安全考虑被禁用或未安装cURL扩展，新服务器的防火墙或安全组未放行采集目标站的IP段，也会导致请求被拦截。
苹果CMS搬家后五宗罪，从虚拟主机到服务器，这五个坑千万别踩
解决步骤：
- 登录SSH,执行
php -m | grep curl，若无输出则安装cURL扩展（宝塔面板可直接在软件商店- PHP设置-安装扩展中勾选curl）。 - 检查PHP配置文件
php.ini，将allow_url_fopen = On，并重启PHP-FPM。 - 在宝塔安全组或云服务器控制台,确认出站规则未限制TCP 80/443端口。
- 若采集源为HTTPS站点,检查服务器根证书是否更新，必要时在
php.ini中设置curl.cainfo路径。
播放器黑屏或“视频加载失败”，但直接访问MP4地址却正常
报错现象： 前台视频页能显示播放器外壳，但点击播放后黑屏，或提示“视频加载失败，请检查地址”，直接复制播放器里的MP4地址到浏览器却能正常播放。
原因分析：
大概率是搬家后服务器缺少伪静态规则（或Nginx/Apache配置未同步），导致播放器请求的.m3u8或解析接口路径被404，如果原虚拟主机用Apache，新服务器用Nginx，重写规则必须转写。
解决步骤：
- 确认网站使用的伪静态文件（如
nginx.conf或.htaccess），在服务器对应站点配置中完整粘贴原规则，并重启Web服务。 - 检查播放器配置里的“解析接口”域名是否与新服务器的站点域名一致，注意HTTP/HTTPS协议不能混用。
- 若使用本地存储视频,检查
/data/目录的读写权限，执行chown -R www:www /www/wwwroot/你的站点/。 - 在后台“视频-播放器设置”中，将默认解析协议改为HTTP（如从https改http），避免SSL证书链不完整导致取流失败。
后台登录页面一直“打转”或提示“验证码错误”
报错现象： 搬家后，后台登录页能打开，但输入账号密码后一直Loading，或明明验证码正确却报错。
原因分析：
最常见的是Session存储路径权限问题，虚拟主机通常Session文件写在临时目录，而服务器上可能设为/tmp，但该目录被系统定期清理或权限不足，缓存目录runtime/未随搬家迁移，或新环境缺少fileinfo扩展导致验证码生成异常。
解决步骤：
- 清空
runtime/目录下的所有文件，然后手动创建index.html防止目录列表暴露，并赋权755。 - 修改
config.php中的'SESSION_OPTIONS'，将'path'设置为站点内的可写目录，如/www/wwwroot/站点/runtime/session/，并创建该目录。 - 在宝塔软件商店安装
fileinfo扩展，并重启PHP。 - 检查
data/admin/下的管理员密码文件是否为原虚拟主机导出的内容，如果数据库搬家时漏导，直接补SQL。
首页能开，但内页全部“404”或“空白页”
报错现象： 首页正常加载，但点击任何栏目或播放页，要么404，要么纯白屏；后台能打开但内容页编辑框不显示。
原因分析：
这是典型的伪静态未生效或服务器Rewrite模块未加载，更隐蔽的问题是，如果原虚拟主机使用了“应用分发”式路径（如index.php?s=/vod/detail/id/1），新服务器未开启pathinfo支持，就会直接报404。
解决步骤：
- 确认Nginx配置中添加
include enable-php.conf和rewrite ^(.*) /index.php?s=$1 last;（苹果CMS官方Nginx规则）。 - 宝塔面板中,找到站点设置-伪静态，选择“苹果CMS”模板并保存，再强制刷新浏览器。
- 若页面空白,打开PHP错误显示，在
php.ini中设置display_errors = On并重启，根据具体报错禁用对应的opcache或调整memory_limit为256M。 - 检查数据库
vod表是否存在或损坏，用phpmyadmin执行REPAIR TABLE vod;。
环境检测通不过，“缓存目录不可写”或“PDO_MySQL未安装”
报错现象： 搬家安装时，环境检测页面红色叉号，提示缓存目录不可写、PDO扩展缺失或版本过低。
原因分析：
虚拟主机一般默认PHP 5.6或7.0，而新服务器装了PHP 8.x，某些老版本苹果CMS的兼容性问题暴露；PHP运行用户如果是nobody而目录属主是www，就会报不可写。
解决步骤：
- 在宝塔中创建新站点时,PHP版本选择与旧虚拟主机一致（如PHP 7.2或7.4），不要盲目用最新版。
- 手动安装PDO_MySQL扩展：在宝塔软件商店- PHP-设置-安装扩展中勾选，或命令行执行
docker-php-ext-install pdo_mysql。 - 执行
chown -R www:www /站点目录，并设置runtime/和data/为755，必要时chmod -R 777 runtime（仅临时测试，安全风险自行评估）。 - 若提示“GD库未安装”，则安装
gd扩展；若提示“curl扩展未安装”，参照问题一。
老张最后补一句：
搬家不是把文件用FTP拖过去就完事的，数据库里也藏着虚拟主机的绝对路径（比如/home/wwwroot/xxx），如果你采集的资源或上传的图片存的是绝对地址，记得在后台“系统-数据库-批量替换”中将旧路径替换为新服务器路径，否则，就算上面五个坑都填平了，你也可能在看图裂的风景。
