新游模板

一、准备服务器环境

苹果CMS V10 是 PHP + MySQL 程序，装之前先确认环境满足要求。安装向导第一步会自动检测，不达标会直接提示。

操作系统	CentOS 7+ / Ubuntu 18+ / Debian 10+（推荐 Linux）
Web 服务	Nginx 1.18+ 或 Apache 2.4+
PHP 版本	7.4 – 8.0（不支持 8.1 及以上）
数据库	MySQL 5.6+ 或 MariaDB 10.2+
必装扩展	curl、gd、openssl、mbstring、pdo_mysql
目录权限	runtime 目录需可写（755 或 777）
必需函数	不能禁用 scandir、file_get_contents、curl_exec

新手强烈推荐「Linux + 宝塔面板」组合，环境一键装好，省去手动编译的麻烦。Windows（IIS）也能跑，但伪静态规则要自己转换。

二、获取苹果CMS源码

两种获取方式，任选其一：

用本站模板包（推荐）：购买后自动发放的源码包已内置苹果CMS V10 与配套模板，开箱即用，无需再单独下载。
官方渠道下载：到苹果CMS 官方或 GitHub 获取 V10 完整源码包，下载后备用。

下载的压缩包先在本地解压看一下，确认根目录有 index.php、application/、template/ 等目录。如果解压后外面还套了一层文件夹，要进到里面一层再上传，否则会报 404。

三、上传源码到站点目录

宝塔 → 网站 → 添加站点，数据库选 MySQL，PHP 版本选 7.4 或 8.0。
进入站点根目录，上传源码压缩包并解压，然后删掉压缩包。
站点设置 → 网站目录：运行目录设为 public，并关闭「防跨站攻击(open_basedir)」。
runtime 目录设为 777，所有者 www。

SSH 快速授权（可选）复制

# 进入站点目录后执行
chmod -R 777 runtime
chown -R www:www runtime

「运行目录设为 public」是最容易漏的一步。漏了会导致打开域名直接 404 或列出目录文件。

四、运行安装向导

浏览器访问你的域名，会自动进入苹果CMS安装向导，共五步：

环境检测：系统自动检查 PHP 版本、扩展、目录权限。有红叉就按提示补齐后刷新重试。
同意协议：勾选同意后进入下一步。
数据库配置：填写数据库地址（一般 localhost）、库名、用户名、密码。系统会自动建库并导入数据表与初始数据。
设置管理员：填写后台登录账号与密码，务必记牢。
安装完成：系统自动锁定安装入口，按提示进入后台。

安装完成后建议删除或重命名 install 目录，避免被他人重复安装覆盖数据。

目录结构复制

application/  # 程序核心
public/       # 站点运行目录（必须设为运行目录）
  index.php   # 统一入口
  assets/     # CSS / JS / 图片
runtime/      # 缓存与日志（需可写）
template/     # 前台模板目录
upload/       # 上传的图片资源

五、后台初始化设置

登录后台（一般访问 域名/admin），先做这几项基础配置：

系统设置 → 站点信息：填写网站名称、关键词、描述、域名。
系统设置 → 参数配置：设置时区、默认语言、生成方式（静态/动态）。
视频/文章分类：建立自己的栏目分类，首页才会显示对应内容。
播放器与解析：按需配置默认播放器与解析接口。
清除缓存：改完配置到「系统工具」一键清缓存再刷新前台，否则可能不生效。

后台修改任何配置后，前台没变化的话，先清缓存再硬刷新浏览器（Ctrl+F5），十有八九是缓存问题。

六、应用购买的前端模板

本站模板放到 template/ 目录后，在后台切换即可生效：

把模板整个文件夹上传到 template/ 目录下。
后台 → 系统 → 模板管理（或「站点设置 → 模板方案」），能看到刚上传的模板。
选择该模板并保存，前台刷新即可看到新界面。
若模板带自己的设置项（首页风格、导航透明等），在对应设置页调整后清缓存。

模板文件夹权限保持 755、文件 644，权限过高部分服务器会拒绝加载，表现为前台样式全丢。

七、配置伪静态

伪静态让 URL 更简洁、利于收录。按服务器类型复制对应规则。

Nginx 规则

nginx.conf 复制

location / {
    if (!-e $request_filename) {
        rewrite ^(.*)$ /index.php?s=$1 last;
        break;
    }
}

Apache 规则（.htaccess）

.htaccess 复制

<IfModule mod_rewrite.c>
  RewriteEngine on
  RewriteBase /
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteRule ^(.*)$ index.php?s=$1 [QSA,PT,L]
</IfModule>

二级目录安装

二级目录规则复制

location /cms/ {
    if (!-e $request_filename) {
        rewrite ^/cms/(.*)$ /cms/index.php?s=$1 last;
    }
}

宝塔用户：站点设置 → 伪静态 → 粘贴上面规则 → 保存。改完记得在后台生成一次首页。

八、采集数据（可选）

站点框架搭好后，用采集功能填充内容：

后台 → 采集 → 添加采集规则（可导入第三方规则库）。
绑定分类：把采集到的数据对应到你建好的栏目。
先小批量试采 10 条，确认字段对应正确再全量采集。
采集完成后生成静态页，前台即可看到内容。

采集规则、资源接口类问题不属于模板售后范围，需自行准备或另行咨询。

九、常见报错修复

1. 打开域名 404 或 No input file specified

运行目录未设为 public，或伪静态未生效。检查站点运行目录与伪静态规则，保存后重启 Nginx。

2. 提示目录不可写

runtime 目录权限不足，设为 777 并将所有者改为 www；宝塔需先关闭防跨站攻击。

3. 提示 curl / gd / openssl 扩展未安装

宝塔 → PHP 设置 → 安装扩展，勾选后重启 PHP 服务，刷新安装页重新检测。

4. PHP 版本检测不通过

苹果CMS V10 不支持 PHP 8.1 及以上。宝塔 → 站点 → PHP 版本切换为 7.4 或 8.0。

5. 安装完成但前台样式错乱

伪静态未配置或静态资源路径错误。配置伪静态后到后台「系统工具」清除缓存，再 Ctrl+F5 刷新。

6. 后台登录失败

确认账号密码正确；如忘记密码，可删除数据库 mac_admin 表中记录后重新运行安装向导。

7. 提示「安装锁定」无法重装

删除 runtime/install.lock（或 install/install.lock）文件后重新访问安装向导。

8. PHP 8.0 报函数弃用警告

在 php.ini 中设置 error_reporting = E_ALL & ~E_DEPRECATED 屏蔽提示，并更新到最新模板版本。

苹果CMS V10 安装部署教程