苹果CMS搬家+宝塔一键迁移避坑实录，从采集源配置到稳定入库的九问九答

问：我原来的服务器快到期了，想用宝塔“一键迁移”把整个苹果CMS站点搬走，但总怕数据丢、采集失效，到底怎么迁才稳？
答：别慌，先别急着点那个“一键迁移”按钮，宝塔的迁移功能本质是打包网站目录+导出数据库，但对苹果CMS这种带定时任务、采集插件和伪静态规则的站点，得做三步预处理，第一步，在旧服务器后台“系统-数据备份”里，手动备份一次完整数据库（不是宝塔的自动备份，要选“物理备份”模式），同时把/application/database.php里的数据库密码记下来，第二步，进入宝塔文件管理器，找到/www/wwwroot/你的域名/整个目录，下载前先删除runtime和data下的缓存子目录（否则迁移后会出现模板错乱），第三步，用宝塔“网站”页面的“迁移”功能时，目标服务器务必先创建同版本PHP（推荐7.4或8.0，别用8.2，苹果CMS老版常有兼容问题）和MySQL 5.7，迁移完立刻去改.env文件里的数据库连接信息。

问：迁移完成后，采集源全部失效，资源站显示“获取失败”，是不是IP被封了？
答：大概率不是IP封禁，而是采集接口的域名白名单变了，很多第三方资源站（比如OK资源、非凡资源）的后台都绑定你的服务器IP或域名，迁移后服务器IP变了，采集接口直接拒绝响应。操作指引： 先登录资源站官网（一般发卡网或官方QQ群公告里有管理入口），在“站点管理”里修改你的IP和回调域名，如果找不到入口，直接联系资源站客服，把新IP和站点域名发过去，让他们手动刷新白名单，检查苹果CMS后台“系统-采集参数配置”里，采集接口URL中的域名是否还是旧域名——有些资源站接口是动态鉴权的，URL里的domain参数必须符合新服务器信息，比如http://api.zyz.com/api.php/provide/vod/?domain=你的新域名。

问：采集规则总是抓不全数据，比如只采集到影片名，但播放器链接是空的，怎么改规则？
答：这是典型的采集字段映射错位，苹果CMS的采集规则文件在/application/extra/collector.php或后台“采集-资源库”里，每个资源站返回的JSON或XML结构不同，比如有的返回vod_play_url，有的是vod_url，还有多播放器嵌套的vod_play_from: m3u8$线路1$线路2。修改技巧： 打开“资源库”对应资源的“自定义规则”，把vod_play_url字段改成资源站实际返回的键名，如果资源站返回的播放地址带加密参数（比如?token=xxx），你需要在vod_play_url后加|md5强制解密，更稳妥的办法：用浏览器访问采集接口URL，复制返回的源码，对照苹果CMS默认规则模板，逐行比对字段，记住一个口诀：“先查from（播放器类型），再查url（地址），最后看note（备注）。” 比如接口返回"vod_play_from": "qiyi"，规则里就写qiyi，并添加qiyi播放器代码。

苹果CMS搬家+宝塔一键迁移避坑实录，从采集源配置到稳定入库的九问九答

问：我每天手动点一次“采集”，麻烦且容易漏，怎么设置定时采集才能稳定入库？
答：用宝塔的“计划任务”绑定苹果CMS自带的PHP命令行。具体操作： 宝塔面板左侧“计划任务”-“添加任务”，类型选“Shell脚本”，执行时间设每天凌晨3点（避开资源站更新高峰），脚本内容填：
php /www/wwwroot/你的域名/think %2F collect --action=all --collector=all --limit=2000
注意：--limit值别太大，否则一次采集过多会导致内存溢出，如果你只想采特定资源库，把--collector=all改成--collector=资源库ID（后台资源库里能看到ID），在苹果CMS后台“系统-定时任务”里，确认采集锁开启，防止多个任务并发冲突。进阶技巧： 每天分两次采，凌晨3点采最新，上午11点采补漏（用--reptile=2只采“无播放地址”的资源）。

问：有没有备用采集源推荐思路？我怕主源挂了，站就瘫痪。
答：千万别死盯一家。推荐策略： 按“片库大小、更新速度、带宽占用”分三级，第一级：用主采集源（比如OK资源），优点是片库全，缺点是高峰期卡，第二级：备用源选“免鉴权”接口（比如量子资源、酷云资源），这些接口不限制IP，采集失败率低，但清晰度可能差一档，第三级：手动补充源，比如豆瓣电影Top250这种静态列表，用“自定义URL采集”导入。操作指引： 在苹果CMS的“资源库”里新建两个同类型资源，把主源设为“启用”，备用源设为“手动同步且优先级低”，当主源连续3次采集失败，自动切换逻辑会启用备用源——这个功能在“系统-采集参数-故障转移”里开启，设置“失败次数=3，恢复周期=2小时”，建议每周手动跑一次备用源的“单部影片补采”，用--collector=备用源ID --limit=500,避免备用源视频失效。

问：采集时经常“卡死”或“超时”，怎么优化？
答：先看PHP超时设置，宝塔后台“软件商店-PHP设置-配置修改”里，把max_execution_time调成300秒，memory_limit调成512M，在苹果CMS后台“系统-性能优化”里，开启“多进程采集”（需要安装Swoole扩展）和“断点续采”，如果资源站接口响应慢，在采集规则里加curl_timeout参数，比如curl_timeout=30。把采集的临时文件放到独立分区：在/www/server/temp建个目录，然后在采集规则里定义save_path，避免占满系统盘导致MySQL崩溃。终极方案： 如果采集源单次返回超5000条数据，强制分页抓取，每页500条，用page_interval=3设置翻页间隔（秒）,防止被资源站拉黑。

问：采集入库后，前台上看到的影片只有简介，没有播放列表，但后台数据明明有，这是为什么？
答：检查播放器配置，苹果CMS的播放器代码在“系统-播放器配置”里，采集源返回的vod_play_from值是m3u8，但你站点默认播放器只启用了resolve（解析接口），没启用m3u8。操作指引： 后台“播放器配置”里，把m3u8和ckm3u8的“前台启用”按钮打开，并在“默认播放器”下拉框选m3u8，如果播放地址是mp4格式，还需要启用mp4播放器，有些采集源会返回http://example.com/电影名.m3u8这种不带真实线路的假地址，需要在规则里加play_parse参数，让苹果CMS自动解析。常见错误： 采集时勾选了“不采集播放地址”,重新采集一遍别勾。

问：搬家后，网站列表页能打开，但搜索功能失效了，怎么办？
答：大概率是MySQL的全文索引没重建，苹果CMS用的是like查询，但搬家后数据表的字符集可能从utf8mb4变成utf8，导致中文搜索乱码。修复步骤： 登录宝塔的phpMyAdmin，选中你的CMS数据库，执行：
ALTER TABLE vod CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
再执行：
REPAIR TABLE vod;
然后去后台“系统-更新缓存”，清理runtime目录，如果搜索还是慢，在vod表给vod_name字段加索引：
ALTER TABLE vod ADD INDEX name_index(vod_name(20));
注意： 苹果CMS的搜索默认是“模糊搜索+分页”，如果资源库数据量超过10万条，务必开启“搜索缓存”功能,否则性能崩。

问：最后一个问题，采集源被封了IP，怎么彻底解决？
答：先确认是不是误封，用浏览器直接访问采集接口URL，如果返回403或forbidden，就是封了。解决方案： ① 换IP——如果你的服务器是阿里云或腾讯云，可以直接换弹性公网IP（按量付费，几分钟生效），② 用代理采集——在采集规则里curl_proxy字段填一个Scoks5代理，比如curl_proxy=http://用户:密码@代理IP:端口，③ 降低采集频率——把定时任务改成每6小时一次，并且每次--limit=500，④ 联系资源站管理员，说明你是个人站，提供网站备案号和真实联系方式，一般会解封。终极思路： 搭建一个中转采集缓存层——用另一台低配服务器跑一个“采集爬虫”存成本地json文件，主站直接读json，避免频繁访问资源站，这个可以用宝塔的opcache配合file_get_contents实现，不过属于进阶玩法,新手慎用。