新手必看：苹果CMS安装配置全流程实操指南

一、环境准备与服务器基础搭建

苹果CMS（MacCMS）是基于PHP+MySQL开发的内容管理系统，主要用于视频站点搭建。为了实现零门槛操作，本指南使用宝塔面板（BT Panel）作为服务器管理工具，它能可视化配置环境，避免手动敲命令出错。

你需要准备一台服务器。推荐使用阿里云、腾讯云或华为云的轻量应用服务器，系统选择CentOS 7.6 64位或Ubuntu 20.04。服务器配置建议为2核4G，内存过低可能导致采集或视频处理卡死。

1. 安装宝塔面板

购买服务器后，使用SSH工具（如Xshell或Putty）登录服务器。执行以下命令安装宝塔面板：

如果你是CentOS系统，请执行：

```bash yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && sh install.sh ```

如果你是Ubuntu系统，请执行：

```bash wget -O install.sh http://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh ```

安装完成后，终端会显示外网面板地址和username、password信息，请务必复制保存。在浏览器中访问面板地址，登录宝塔面板。

2. 安装LNMP环境

登录宝塔面板后，会自动弹出“安装套件”窗口。请选择LNMP架构（推荐），具体软件版本选择如下：

• Nginx：1.24 或最新稳定版
• MySQL：5.6 或 5.7（不要使用8.0，苹果CMS兼容性最佳为5.6）
• PHP：7.4（推荐使用7.2-7.4版本，性能稳定且兼容所有插件）

点击“一键安装”，等待安装进度条走完（通常需要10-20分钟）。安装期间不要关闭浏览器页面。

3. 安装PHP扩展

环境安装完毕后，点击左侧菜单栏的“软件商店”，找到已安装的PHP 7.4，点击“设置”。在弹出的窗口中切换到“安装扩展”选项卡。

勾选以下必须的扩展并点击安装：

• fileinfo：用于文件处理，必须安装。
• openssl：用于加密传输，必须安装。
• pdo_mysql：用于数据库连接，必须安装。
• mbstring：用于字符串处理。
• curl：用于远程采集。
• gd：用于图片处理。

安装完所有扩展后，切换到“禁用函数”选项卡，将列表中的putenv、proc_open、pcntl_alarm、pcntl_signal选中并点击“删除”按钮。这一步非常关键，否则后续安装程序可能报错。

二、创建网站与上传源码

1. 创建站点

在宝塔面板左侧点击“网站”，选择“添加站点”。填写以下信息：

• 域名：输入你的域名（如 example.com），如果没有域名，暂时输入服务器IP地址。
• 数据库：选择“MySQL”，设置数据库名、用户名和密码（请务必复制保存，稍后安装要用）。
• PHP版本：选择 PHP-74。

点击“提交”。此时宝塔会自动在网站根目录（通常是/www/wwwroot/你的域名）生成index.html等文件。

2. 下载苹果CMS源码

苹果CMS目前主流版本为v10。为了保证源码纯净，建议通过官方渠道下载。在宝塔面板中，进入“文件”菜单，找到刚才创建的网站根目录，选中目录下的所有默认文件（index.html, 404.html等），点击右上角的“删除”。

点击根目录路径右侧的“远程下载”按钮。在弹出的对话框中，输入苹果CMS v10的下载地址。你可以使用以下稳定的Gitee镜像地址：

```text https://gitee.com/magicccc/maccms10/repository/archive/v10.0.0.zip ```

点击“确定”，等待下载完成。下载列表会出现压缩包，点击右侧的“解压”按钮。解压后会生成一个文件夹，进入该文件夹，选中所有文件，点击“剪切”，返回网站根目录，点击“粘贴”。确保程序文件（如application、public、static等文件夹）直接位于根目录下，而不是嵌套在子文件夹中。删除下载的压缩包和解压留下的空文件夹。

三、执行安装程序

源码部署完毕后，在浏览器中访问你的域名或IP，后面加上/install.php，例如：http://你的域名/install.php。

如果环境配置正确，页面会显示苹果CMS的安装协议界面。勾选“我已阅读并同意以上协议”，点击“下一步”。

进入“环境检测”页面，系统会自动检测PHP版本、扩展和目录权限。如果所有项目都显示绿色对勾，点击“下一步”。如果有红色叉号，请根据提示返回宝塔面板检查PHP扩展或目录权限（通常runtime目录需要755或777权限）。

在“数据库配置”页面，填写之前在宝塔创建站点时生成的数据库信息：

• 数据库服务器：保持默认 localhost
• 数据库端口：3306
• 数据库名：输入宝塔显示的数据库名
• 数据库用户名：输入宝塔显示的用户名
• 数据库密码：输入宝塔显示的密码
• 管理员账号：设置你的后台登录用户名
• 管理员密码：设置你的后台登录密码

点击“立即安装”。几秒钟后，页面会提示安装成功。为了安全，请务必通过宝塔文件管理器删除网站根目录下的install.php文件，防止他人恶意重装系统覆盖数据。

四、伪静态配置与安全设置

安装完成后，直接访问前台或后台可能会出现样式错乱或链接无法跳转的情况，这是因为没有配置伪静态规则。

1. 配置Nginx伪静态

在宝塔面板点击“网站”，找到你的站点，点击“设置”。切换到“伪静态”选项卡。在输入框中填入以下苹果CMS v10专用规则：

```nginx if (!-e $request_filename){ rewrite ^/index.php(.)$ /index.php?s=$1 last; rewrite ^/api.php(.)$ /api.php?s=$1 last; rewrite ^/(.)$ /index.php?s=$1 last; } ```

点击“保存”。此时，网站的前台链接应该可以正常访问了。

2. 后台路径修改

默认的后台地址通常是/admin.php，为了防止被恶意扫描爆破，建议修改后台入口文件名。在宝塔“文件”管理中，进入网站根目录，找到admin.php文件，右键点击“重命名”。将其修改为一个复杂的名字，例如myadmin2024.php。

以后登录后台，请访问：http://你的域名/myadmin2024.php。

五、采集资源与播放器配置

空站没有任何内容，苹果CMS的核心功能之一是采集。这需要配置“资源库”。

1. 添加采集资源

登录苹果CMS后台。点击顶部菜单“采集”，选择“自定义采集”或“资源库管理”。这里演示使用“资源库管理”。

点击“添加资源库”按钮。你需要找一个提供苹果CMS接口的网站（通常称为“采集站”或“资源站”）。在表单中填写：

• 资源库名称：随意填写，如“测试资源”
• 资源库地址：输入采集站的API地址（例如：http://example.com/api.php）
• 播放器类型：根据资源站要求选择，通常为“m3u8”或“mp4”

点击“测试连接”。如果提示连接成功，说明该资源库可用。点击“保存”。

2. 执行采集操作

在“资源库管理”列表中，找到刚添加的资源，点击右侧的“操作”列中的“采集”按钮。

进入采集页面，你可以选择“当天”、“本周”或“全部”进行采集。建议先勾选“分类绑定”，将资源站的分类（如电影、电视剧）映射到你网站后台的分类。

点击“开始采集”。页面会实时滚动显示采集进度。等待进度条走完，提示采集完成。

3. 配置播放器

采集的数据通常只有播放地址，没有播放器代码。你需要配置一个支持M3U8的通用播放器。

在后台点击“系统” -> “播放器配置”。苹果CMS v10支持多种播放器配置方式。通常选择“DPlayer”或“CK”。

以配置DPlayer为例，在“播放器代码”框中，确保代码能正确调用变量。如果你不懂代码，可以使用现成的播放器JS包。将播放器JS文件上传到网站目录，并在“系统参数” -> “播放器配置”中设置对应的调用代码。

一个简单的配置逻辑是：确保你的视频分类绑定了正确的播放器编码。在“视频分类管理”中，编辑分类，选择“播放器”为你配置好的那个编码（如dplayer）。

六、常见问题排查

如果在操作中遇到问题，请按以下步骤排查：

1. 页面空白：检查PHP版本是否为7.4，是否禁用了putenv和proc_open函数，是否安装了fileinfo扩展。

2. 无法连接数据库：检查宝塔数据库密码是否正确，确保数据库用户权限足够。

3. 采集不播放：检查资源站是否失效，检查播放器配置是否正确，检查浏览器控制台（F12）是否有跨域（CORS）报错。如果有跨域问题，需要在Nginx配置中添加允许跨域的头信息。

通过以上步骤，一个完整的苹果CMS视频站点就已经搭建完成，并且具备了基本的采集和播放能力。