苹果CMS V10 从零安装教程（宝塔面板）

一、准备环境

苹果CMS V10 是 PHP + MySQL 程序。推荐组合：Nginx 1.20+ / PHP 7.4 / MySQL 5.6+。

• PHP 别用 8.0 以上：很多老插件和采集插件不兼容，会莫名报错。7.4 是兼容性最好的版本。
• 必装扩展：curl、gd、openssl、mbstring、pdo_mysql、fileinfo。
• fileinfo 常被漏装：宝塔 → 软件商店 → PHP 7.4 设置 → 安装扩展 → 找到 fileinfo 装上。
• 不能禁用 scandir、file_get_contents、curl_exec 这几个函数。

二、创建站点

1. 宝塔 → 网站 → 添加站点，域名填你的域名，数据库选 MySQL，PHP 版本选 7.4。
2. 记下自动创建的数据库名、用户名、密码，下一步要填。

三、上传源码

1. 下载 V10 源码包（认准官方或可信渠道），本地先解压看一下。
2. 把 upload 文件夹里面的所有文件上传到站点根目录。
3. 最常见的坑：解压后外面多套了一层文件夹（变成 maccms10/maccms10/xxx）。必须进到里面一层再传，否则会报 404 或安装检测不过。
4. 站点设置 → 网站目录：运行目录设为 public，并关闭「防跨站攻击 open_basedir」。
5. runtime 目录设为 755 或 777，所有者 www。

四、运行安装向导

1. 浏览器访问 你的域名/install.php，勾选协议进入环境检测。
2. 重点看目录权限是否全部可写。某项显示「不可写」，回宝塔把该目录权限改 755、所有者改 www。
3. 填数据库信息。服务器地址填 127.0.0.1 或 localhost，不要填服务器公网 IP。
4. 设置管理员账号密码，别用 admin / 123456。
5. 提示安装成功后：立刻删除 install.php，并改掉后台入口文件名（默认 admin.php 容易被爆破）。

五、后台初始化

1. 系统 → 网站参数配置：填网站名称、域名（不带末尾斜杠）、关键字、描述。
2. 系统 → 性能优化：缓存机制选 File（装了 Redis 就选 Redis）。
3. 系统 → URL 设置：URL 模式先保持动态，等伪静态配好再切。
4. 模板：把模板文件夹上传到 /template/ 目录，再到后台模板管理启用。

装完先别急着采集。前台能正常打开、后台能正常保存，再往下走采集那一步。