苹果CMS采集视频本地化全流程实操 附工具配置及防卡细节

前期准备

必备条件确认

• 已搭建好的苹果CMS V10正式版（不要用测试版，稳定性差）
• 服务器/虚拟主机支持PHP 7.2-8.0、FFmpeg 4.0+、10G以上剩余磁盘空间
• 采集目标为允许本地转存资源的公开源（需自行确认版权合规）

基础工具获取

FFmpeg安装：根据环境选择对应方式

• 宝塔面板：软件商店搜索FFmpeg，点击一键安装
• Linux服务器（CentOS 7/8）：执行以下完整命令

  yum install -y epel-release
  yum install -y https://download1.rpmfusion.org/free/el/rpmfusion-free-release-7.noarch.rpm https://download1.rpmfusion.org/nonfree/el/rpmfusion-nonfree-release-7.noarch.rpm  CentOS7专用
  yum install -y https://download1.rpmfusion.org/free/el/rpmfusion-free-release-8.noarch.rpm https://download1.rpmfusion.org/nonfree/el/rpmfusion-nonfree-release-8.noarch.rpm  CentOS8专用
  yum install -y ffmpeg ffmpeg-devel

• Windows服务器/本地测试：从官网下载https://www.gyan.dev/ffmpeg/builds/ffmpeg-git-full.7z，解压后将bin目录下的ffmpeg.exe、ffprobe.exe、ffplay.exe放到苹果CMS根目录

验证FFmpeg是否成功：访问苹果CMS后台-系统-系统参数-接口配置，查看FFmpeg路径是否自动识别（Linux默认/usr/bin/ffmpeg，Windows自动留空即可），或者点击后台-采集-视频转码测试，若提示成功则说明可用

苹果CMS后台核心配置

系统参数配置

进入苹果CMS后台-系统-系统参数，按以下表格修改关键项，其他保持默认即可

配置组	配置项	配置值
接口配置	FFmpeg路径	宝塔自动填/usr/bin/ffmpeg，Linux手动确认该路径，Windows留空
接口配置	FFprobe路径	同上（默认/usr/bin/ffprobe）
上传配置	上传模式	本地
上传配置	视频上传目录	./upload/video/（注意末尾斜杠，必须提前在FTP/filezilla中创建该目录，权限设为777）
上传配置	视频转码格式	mp4（兼容性最强）
上传配置	是否开启视频采集自动转存	是
上传配置	视频转码线程数	1（低配服务器/虚拟主机设1，高配可设2-4）
上传配置	视频采集超时时间（秒）	600（可根据目标源速度调整，最高不超过3600）

修改后点击保存，再点击更新缓存

视频分类绑定

进入后台-视频-分类管理，提前创建与采集目标一致的分类（可后续在采集规则中手动绑定），每个分类需确保父分类、名称、排序、状态设置正确

采集规则编写与导入

使用现成转存类采集规则

若不想自己写规则，可到GitHub搜索「苹果CMS V10 本地转存 采集规则」，找标有202X可用的仓库下载，推荐规则类型为带m3u8解析+自动转存mp4的规则

导入规则步骤：

• 进入后台-采集-采集规则-导入规则
• 选择下载好的.json格式规则文件
• 点击确定导入，导入后点击规则名称右侧的测试按钮，检查分类、剧集、播放链接是否正常抓取

编写基础本地转存采集规则（可选）

以下为可直接复制的m3u8转mp4规则片段（仅需修改源站地址、分类匹配规则）：

{
"name": "示例公开源转存规则",
"url": "https://example.com/vod/list/{page}.html",
"type": "video",
"charset": "utf-8",
"parse": "1",
"auto": "1",
"download": "1",
"download_charset": "utf-8",
"download_playurl": "1",
"download_playtype": "m3u8",
"download_convert": "1",
"download_format": "mp4",
"area": [
{"name": "内地", "id": "1"},
{"name": "香港", "id": "2"}
],
"lang": [
{"name": "国语", "id": "1"},
{"name": "粤语", "id": "2"}
],
"class": [
{"name": "电影", "id": "1"},
{"name": "电视剧", "id": "2"}
]
}

规则编写完成后，保存为.json格式，按上述导入步骤操作即可

正式采集与本地化转存

采集视频信息

• 进入后台-采集-对应规则名称，点击采集视频
• 选择采集页码范围（建议先测试1-2页），点击开始采集
• 等待采集完成，采集到的视频会出现在视频-未审核列表中

批量审核与转存触发

本地转存默认在审核通过视频时自动触发，步骤如下：

• 进入后台-视频-未审核，勾选需要本地化的视频
• 点击顶部审核按钮，选择全部通过
• 进入后台-采集-任务管理，可查看当前转存任务进度
• 若任务进度卡顿超过超时时间，可点击重新执行按钮

转存成功后，视频播放链接会自动替换为本地./upload/video/路径下的mp4文件地址

常见问题解决

FFmpeg路径无法识别

• Linux：执行whereis ffmpeg查看真实路径，手动填写到后台系统参数中
• Windows：确保ffmpeg.exe放在苹果CMS根目录，同时检查PHP的open_basedir是否限制了根目录访问（宝塔可在网站设置-配置文件中删除open_basedir相关行）

转存任务失败

• 检查upload/video目录权限：Linux设为777（chmod -R 777 /www/wwwroot/你的网站目录/upload/video），Windows设为Everyone可写入
• 检查目标源播放链接是否失效：在后台-视频-已审核，点击视频右侧编辑，查看原始播放链接是否可正常访问
• 检查PHP执行时间限制：宝塔在网站设置-PHP版本-配置修改，将max_execution_time设为3600，max_input_time设为3600，memory_limit设为512M，修改后保存并重启PHP

转存后的视频无法播放

• 检查本地mp4文件是否存在：通过FTP/filezilla进入upload/video目录查看
• 检查视频编码：确保转码格式为H.264，可在后台-系统参数-接口配置中添加FFmpeg转码参数-vcodec libx264 -acodec aac（修改后更新缓存并重新转存）