正文

苹果CMS网站搭建全攻略，从零到上线，手把手带你避开所有坑

小海不是菜
小海不是菜 V管理员 /860阅读/3评论
0726
文章最后更新时间2026年07月26日，若文章内容或图片失效，请留言反馈！

适用人群

正在读这篇文章的你，可能是一个刚接触建站的新手，想用苹果CMS搭建一个属于自己的视频网站，却面对一堆技术术语手足无措；也可能你之前用过其他CMS，但被苹果CMS的配置细节搞晕过几次，没关系，这篇教程就是为你准备的，不需要你会写代码，不需要懂服务器运维，只要你有一台服务器（或虚拟主机）、一个域名，跟着下面的每一步操作，就能把网站稳稳地搭起来，并且避开90%新手都会踩的坑。

第一步：准备工作（别嫌啰嗦，这一步省了后面全白干）

在动手之前,先把三样东西准备好：

  1. 服务器环境：苹果CMS对PHP版本有要求，推荐使用 PHP 7.3 ~ 8.0，MySQL 5.6 或以上，Nginx 或 Apache 都行，如果你用的是宝塔面板（推荐新手用），在创建站点时把PHP版本选为7.4，数据库选MySQL 5.7,这是最稳妥的组合。
  2. 苹果CMS源码包：去官方GitHub或国内镜像站下载最新的“苹果CMS v10”版本（也叫Maccms v10），下载后得到一个zip压缩包，千万别直接在Windows里解压再上传,后面会告诉你怎么处理。
  3. 域名和SSL证书：如果只是为了测试，用IP地址也能装，但后期采集和播放会遇到跨域问题，强烈建议绑定一个域名，并开启HTTPS（宝塔里一键申请免费SSL证书）。

第二步：上传源码（一个细节错误导致网站白屏）

假设你已经在宝塔面板里创建好了站点，根目录是 /www/wwwroot/你的域名。

  1. 直接上传zip包：进入宝塔的文件管理，找到站点根目录，点击“上传”，把刚才下载的苹果CMS zip包传上去。注意：不要解压到本地再一个一个上传，那样容易漏文件,而且上传速度慢。
  2. 解压到目录：上传完毕后，右键点击这个zip文件，选择“解压到当前目录”，解压完成后，你会看到一个类似 maccms10-xxx 的文件夹，进入这个文件夹，把里面的所有文件和文件夹（包括 admin.php、application、template 等）全部选中，点击“剪切”，然后回到站点根目录，点击“粘贴”,删除那个多余的文件夹和zip包。
  3. 设置权限：在宝塔文件管理里，选中根目录下所有文件，点击“权限”，设置为 755（目录）和 644（文件），如果面板有“防篡改”功能，先关闭,否则后续安装无法写入。

常见踩坑：很多人解压后不移动文件，导致访问域名时看到的是文件夹列表，或者出现“404”，站点根目录下直接就是 index.php、admin.php 这些文件,而不是再套一层文件夹。

苹果CMS网站搭建全攻略，从零到上线，手把手带你避开所有坑

苹果CMS网站搭建全攻略，从零到上线，手把手带你避开所有坑

第三步：安装苹果CMS（这一步卡住的人最多）

在浏览器地址栏输入你的域名（或IP），会自动跳转到安装界面，如果没跳转，手动访问 /install.php。

  1. 环境检测：页面会检测PHP扩展是否齐全，常见缺少的是 fileinfo、redis 等，在宝塔的PHP设置里，点击“安装扩展”，把 fileinfo 和 redis 勾上并安装，如果提示“不支持CURL”，那也是PHP配置问题,同样在宝塔里开启。
  2. 数据库信息填写：提前去宝塔的数据库管理里创建一个数据库，记下数据库名、用户名、密码，把这三项填到安装页面的对应框里。主机地址保持默认 localhost，数据库前缀可以改成 mac_（避免和其他表冲突）。
  3. 管理员账号：设置一个自己记得住的账号和密码，建议别用admin，容易被扫，点击“安装”后，等几秒，看到“安装成功”提示,就完成了。

常见踩坑：安装过程中提示“数据库连接失败”，99%的原因是数据库密码填错了，或者数据库名不对，去宝塔后台重新复制一下密码,注意大小写和特殊字符。

第四步：后台登录与基础配置

安装完成后，访问 你的域名/admin.php,用刚才设置的管理员账号登录。

  1. 系统设置 → 网站参数：这里把网站名称、关键词、描述填好，网址域名一定要填你的完整域名（带https://）,否则后续生成的播放链接会出错。
  2. 播放器设置：苹果CMS默认自带两个播放器（ckplayer和dplayer），建议把默认播放器选为“ckplayer”，并开启“解析播放”，如果你的网站主要依靠第三方采集源,这里不需要动太多。
  3. URL模式设置：在“系统设置 → URL配置”中，选择“伪静态模式”。但先别急着保存，因为伪静态需要配合服务器规则,下一步再处理。

第五步：伪静态配置（最容易导致404的环节）

苹果CMS支持Nginx和Apache的伪静态规则，如果你用的是Nginx（宝塔默认）,需要手动添加规则：

  1. 在宝塔面板里找到你的站点，点击“设置”→“伪静态”。
  2. 选择“选择预设模板”，找到“苹果CMS”或“Maccms”，如果列表里没有,就手动复制以下代码：
location / {
    if (!-e $request_filename) {
        rewrite ^/index.php(.*)$ /index.php?s=$1 last;
        rewrite ^/admin.php(.*)$ /admin.php?s=$1 last;
        rewrite ^/api.php(.*)$ /api.php?s=$1 last;
        rewrite ^(.*)$ /index.php?s=$1 last;
    }
}

保存后，回到苹果CMS后台，刚才的“URL配置”里，点“保存”并“生成缓存”，此时去前台随便点一个分类链接，应该能正常打开,不再是404。

常见踩坑：很多人保存了伪静态配置，但忘了重启Nginx服务，宝塔里点击“重启”按钮，或者用命令行 nginx -s reload，如果你用的是Apache，规则不同，去官方文档找 .htaccess 文件。

第六步：采集数据（让网站有内容）

空站点没意义，苹果CMS最强大的地方就是采集，推荐使用“官方资源库”或第三方采集接口。

  1. 后台找到“采集”→“自定义资源库”，添加一个资源库地址，例如一些公开的采集站接口，格式是 http://xxx.com/inc/...，注意，很多采集接口需要配套的“资源库插件”才能用，去苹果CMS官方论坛找对应的PHP文件上传到 application/extra 目录。
  2. 添加完成后，在“采集”→“资源库列表”里点击“一键采集”，第一次采集建议只选“电影”或“电视剧”，数量设为100部，不要贪多,否则服务器超时。
  3. 采集完成后，去前台看看是否正常播放，如果播放页面报错“视频地址获取失败”，通常是播放器配置或解析接口的问题，回到后台“播放器设置”，为当前播放器填写一个公共解析接口（https://jx.aidouer.net/?url=）,保存后重新生成页面。

常见踩坑：采集时卡在50%不动，原因是PHP执行时间太短，宝塔里找到PHP设置，把 max_execution_time 改为300，memory_limit 改为256M,然后重启PHP服务。

第七步：模板与前端美化（让网站不像裸奔）

默认模板比较简陋，建议去官方资源站下载免费或付费模板，下载后是一个zip压缩包，不要解压，直接在后台“系统”→“模板管理”里上传安装，安装后记住模板的目录名（default 或 new_skin），然后在“系统设置”→“网站参数”里把“模板目录”改成这个目录名。

注意：有些模板需要额外插件支持，比如幻灯片、会员系统等，仔细看模板的说明文档，可能需要手动修改一些PHP文件，新手如果不想折腾，就先用默认模板,把网站跑顺了再换。

第八步：安全与维护（防挂马、防被黑）

  1. 修改后台路径：默认 /admin.php 太显眼，容易被攻击，在宝塔里把 admin.php 重命名为一个复杂名字（abc123xyz.php），然后在苹果CMS后台“系统设置”→“安全配置”里修改“后台入口文件名”为同样的名字。
  2. 关闭调试模式：找到 /application/database.php，把 'debug' => true 改为 false。
  3. 定期备份：宝塔面板有自动备份功能，每天备份数据库和网站文件,防止数据丢失。

最后提醒：遇到问题怎么办？

如果你按照上面的步骤操作，网站应该已经跑起来了,但建站过程中总是会有意外，

  • 采集时提示“资源库不存在”：检查资源库地址是否可访问,有些接口需要付费。
  • 前台点击播放闪退：F12打开浏览器控制台，看有没有JS报错,多半是模板文件缺失或播放器路径不对。
  • 后台修改配置后不生效：记得每次修改后台配置后，都点一下“生成缓存”或“更新缓存”。

苹果CMS没有你想象中那么复杂，它只是一个工具，跟着这篇教程一步步走，最多半小时，一个能正常播放视频的网站就能出现在你眼前，别怕,动手才是最好的老师。