本文说明如何把 ZoneCMS 安装到服务器或本地环境（phpstudy / 宝塔等）。请按顺序操作，网站根目录必须指向 public。

一、环境要求

项目要求
PHP≥ 7.2.5（推荐 7.4 / 8.0）
扩展PDO_MySQL、GD、curl、JSON、mbstring、openssl
MySQL≥ 5.7（或 MariaDB 兼容版本）
目录权限runtime/、public/（及上传目录）可写

二、上传与网站根目录（最关键）

  1. 将程序解压到服务器，例如 /www/wwwroot/yoursite/zonecms/
  2. 在面板里新建站点时，网站根目录必须指向：.../zonecms/public
  3. 不要把根目录指到 zonecms 上一层或程序根目录，否则会出现 404、无法进后台
正确示例：根目录 = D:\www\zonecms\public 或 /www/wwwroot/xxx/public。
错误示例：根目录 = D:\www\zonecms

三、配置伪静态（安装前先配）

伪静态未配好时，可能打不开安装页、后台或栏目链接。请先按下一篇文档「伪静态规则（必读）」配好，再访问安装地址。

  • Nginx / 小皮面板：使用 public/nginx.htaccess 中的规则，或参考程序根目录 nginx.conf.sample
  • Apache：确保已启用 mod_rewrite，并使用 public/.htaccess

四、浏览器安装向导（3 步）

打开：

http://你的域名/install
或
http://localhost/install

步骤 1：环境检测

全部显示通过后点「下一步」。若有红色失败项，按提示开启 PHP 扩展或修改目录权限。

步骤 2：数据库与管理员

字段说明
数据库主机 / 端口本机一般 127.0.0.1 / 3306
数据库名请先在 MySQL 中建好空库，再填写名称
用户名 / 密码对该库有权限的账号
表前缀默认 zone_content_，一般不用改
站点域名不含 http://，如 www.example.com 或 localhost
管理员账号 / 密码后台登录用，密码请设强一些

点「开始安装」，等待完成。成功后会写入 .env 与 public/install.lock。

步骤 3：安装完成

  1. 点「进入后台」，用刚才的管理员账号登录
  2. 依次：站点设置 → 栏目管理 → 发布内容
  3. 再打开前台检查效果

五、安装后注意

  • 不要反复打开 /install；有安装锁后正常无法重装
  • 安装页提示的计划任务（如 php think geo:auto）可稍后配置，不影响先建站发文章
  • 正式上线后建议删除或禁止访问安装入口，并做好数据库备份

六、装完进不了后台？

  1. 确认根目录是 public
  2. 确认伪静态已配置并重启 Nginx/Apache
  3. 确认 public/install.lock 存在（没有可新建空文件）
  4. 直接访问：/admin/login 或 /admin/login/index

若使用宝塔面板上线演示站，请继续阅读下一篇：宝塔面板安装详细教程（上线演示站）。