一、搭建前的准备工作
1.1 确认所需环境
苹果CMS v10仅支持以下环境，需提前安装好PHP集成环境包简化操作：
- PHP版本：7.0-7.4（推荐7.2，兼容性最优）
- MySQL版本：5.5-8.0（推荐5.7）
- Web服务器：Apache/Nginx（集成环境默认Apache）
1.2 下载软件与资源
直接访问官方GitHub仓库获取最新稳定版：https://github.com/magicblack/maccms10/releases ，下载maccms10.zip压缩包，不要下载源代码包。
二、本地/服务器搭建步骤
2.1 本地搭建（以phpStudy V8为例）
- 打开phpStudy V8，点击左侧「网站」→「创建网站」
- 填写配置项：
- 域名：本地测试可填maccms.test（无需备案）
- 端口：80（若被占用可填8080等）
- 根目录：点击「浏览」新建一个纯英文/数字的文件夹（如D:\maccms）
- FTP：关闭
- 数据库：勾选创建，填写数据库名、用户名、密码（建议都为maccms10），字符集选utf8mb4
- PHP版本：选7.2
- 点击「确认」创建网站，找到根目录，删除默认生成的index.html
- 将下载的maccms10.zip解压，把解压后文件夹内的所有文件（不是整个文件夹）复制到根目录
- 在phpStudy V8点击「启动」→选中刚才的网站，点击「启动」
2.2 服务器搭建（以宝塔面板为例）
- 登录宝塔面板，点击左侧「软件商店」→安装PHP7.2、MySQL5.7、Nginx/Apache
- 点击左侧「网站」→「添加站点」，填写配置：
- 域名：填写已备案解析到服务器的域名
- 数据库：勾选MySQL，字符集utf8mb4，用户名密码自定义
- PHP版本：选7.2
- 点击「提交」，找到站点根目录，删除默认文件
- 点击根目录的「上传」，上传maccms10.zip，上传后点击「解压」，删除压缩包
三、安装苹果CMS v10
- 本地访问http://maccms.test（或对应端口），服务器访问绑定的域名，进入安装引导页
- 点击「我已阅读并同意」
- 检查环境配置，所有检测项必须为绿色√，若有红色×，需返回修改：
- 如提示「目录不可写」，本地右键根目录→属性→安全→编辑→Users→勾选「完全控制」→应用；服务器在宝塔面板根目录点击「权限」→设置权限为755（递归子目录）
- 填写数据库信息：
- 数据库服务器：本地填localhost，服务器填127.0.0.1
- 数据库名、用户名、密码：用之前创建的
- 数据库前缀：默认mac_即可，无需修改
- 填写管理员信息：
- 用户名：不要用admin，建议自定义
- 密码：至少8位，包含大小写字母+数字
- 邮箱：可找回密码的邮箱
- 点击「立即安装」，等待3-5秒，提示安装成功后，务必删除根目录的install文件夹（防止被重新安装）
四、后台基础配置
安装成功后点击「进入后台」，或直接访问域名/admin.php，输入管理员账号密码登录。
4.1 基础网站配置
- 点击左侧「系统」→「网站参数配置」
- 填写核心配置：
- 网站名称：自定义你的视频站名称
- 网站地址：完整的http/https开头的域名
- 管理员邮箱：可修改
- 缓存方式：选File（本地/小型站）或Redis（大型站需安装Redis扩展）
- 点击「保存」
4.2 安全配置
- 点击左侧「系统」→「后台安全配置」
- 修改后台入口文件名：把admin.php改成纯英文/数字的文件名（如mymac.php），修改后根目录会自动生成新文件，删除原来的admin.php
- 开启后台IP白名单（可选但推荐）：添加你常用的公网IP
- 开启后台登录验证码：选开启
- 点击「保存」
五、配置采集（快速填充内容）
采集是苹果CMS的核心功能，这里用官方推荐的第三方采集接口演示。
5.1 添加采集接口
- 点击左侧「采集」→「采集接口管理」
- 点击「添加接口」
- 填写配置（以某稳定影视源为例，接口地址可从网络合法渠道获取）：
- 接口名称：自定义（如稳定影视源）
- 接口地址：http://api.example.com/api.php/provide/vod/（替换为合法真实接口）
- 接口类型：选苹果CMS
- 状态：开启
- 点击「保存」
5.2 执行采集
- 点击左侧「采集」→「采集数据管理」
- 找到刚才添加的接口，点击「测试」，确认能获取数据后，点击「采集」
- 选择采集方式：
- 手动采集：逐页/逐分类采集，适合测试
- 定时采集：点击左侧「系统」→「定时任务管理」，点击「添加任务」，任务类型选「采集接口」，绑定刚才的接口，设置采集时间（如每2小时一次），保存后开启任务
- 采集完成后，点击左侧「视频」→「视频数据管理」，可看到填充的视频内容
六、前台基础使用
采集完成后，直接访问域名即可看到默认的前台模板，支持以下操作：
- 分类筛选：点击顶部导航栏的分类（如电影、电视剧）
- 搜索视频：在搜索框输入关键词
- 播放视频：点击视频封面或标题，进入详情页选择播放源即可
七、常见问题解决
- 问题1：访问后台404：检查是否修改了后台入口文件名，且访问了新的文件名；检查是否删除了install文件夹
- 问题2：采集不到数据：检查接口地址是否正确、是否失效；检查防火墙是否屏蔽了接口地址；检查数据库是否正常连接
- 问题3：播放视频失败：检查采集的播放源是否失效；检查是否开启了防盗链（在系统→防盗链配置中关闭测试）
