本指南适用于 1.1.0 · Build 404。首次安装使用全新部署包,已有站点使用热更新包。
一、准备站点
- 准备 Linux x86_64 服务器、域名及 HTTPS。
- 为站点选择 PHP 8.1–8.4 NTS,启用环境检测要求的扩展。
- 将部署包完整解压到站点根目录,运行目录指向
public/。 - 使用随包的 Nginx/宝塔配置示例设置伪静态,并保留面板为该站配置的 PHP 转发规则。
- 给网站运行用户必要的运行、上传及安装/更新写权限,访问
/install.html。
正式包已含页面与运行依赖,无需自行编译前端。不要混用历史版本的入口、路由、依赖或静态资源。
二、安全运行组件一键安装
在哪里执行
在服务器终端先进入站点根目录,这一层同时包含 app/ 和 public/:
cd /www/wwwroot/example.com
上方为示例路径,请替换为自己的站点目录。然后复制当前版本安装向导环境检测页的完整一键命令执行;使用 root 或具备 sudo 权限的服务器账号。
当前版本命令示例
以下命令适用于本页标注的 Build 404。其他版本请以对应安装向导提供的命令为准,以免使用过期校验值。
sudo bash -c 'set -eu; t=$(mktemp); trap "rm -f -- \"$t\"" EXIT; status=$(curl --disable --fail --silent --show-error --proto "=http" --connect-timeout 10 --max-time 120 http://kededl.mercuryseek.cn/install.sh -o "$t" --write-out "%{http_code}"); [ "$status" = 200 ]; test -s "$t"; printf "%s %s\n" cfc6eb2d1a34e3322b6db875aebefacadbc2a067f0c874d94bd7e25dc87815de "$t" | sha256sum -c - >/dev/null; bash "$t"'
官方下载源为 http://kededl.mercuryseek.cn/,安装脚本与版本文件均位于站点根目录,不需要额外子目录。命令从官方下载、校验后执行;校验失败应停止,不能跳过校验或直接执行未知文件。
执行过程中会发生什么
- 识别站点实际使用的 PHP 版本与运行环境。
- 下载并校验对应版本的运行组件。
- 写入运行配置并刷新 PHP-FPM 服务。
- 执行可用性检查,输出成功或具体错误信息。
安装或失败退出时会清理临时下载文件,正式安装到 PHP 环境的运行组件必须保留。客户部署包与更新包不附带组件源文件。
执行完成后
返回安装向导,点击 我已执行,重新检测,等待页面重新读取站点实际运行状态。终端提示成功不等于所有 PHP-FPM 进程均已使用新配置,网页复检结果仍需通过。
若更换站点 PHP 版本,应重新执行对应版本向导给出的安装命令并复检。单纯升级程序后如环境检测正常,无需重复安装组件。
常见安装失败
| 提示或现象 | 处理 |
|---|---|
| CLI 未探测 | 以站点 PHP-FPM 的检测结果为准;该项单独出现不表示 PHP 版本不受支持 |
| 当前运行环境不受支持 | 核对 Linux x86_64、PHP 8.1–8.4 NTS,并确认选择的是当前站点的 PHP |
| 下载失败 | 检查服务器 DNS、出站网络及官方下载源是否可达 |
| SHA-256 校验失败 | 停止执行,重新从对应版本向导复制命令;持续失败时提交脱敏报告 |
| Operation not permitted / 权限不足 | 确认使用 root/sudo;让服务器管理员检查面板安全策略、文件保护或只读挂载 |
| 终端成功但网页仍未就绪 | 确认命令在正确站点目录执行、站点选中的 PHP 已刷新,随后重新检测 |
| 授权模块文件存在但无法加载 | 先完成组件安装与网页复检;仍失败时按故障处理提交报告 |
不要因权限报错就随意停用整机安全策略或删除 PHP 配置文件。
三、伪静态与访问路径
优先使用当前交付包的部署配置,避免沿用只覆盖旧前端的通用规则。
- PHP 请求必须交给该站选中的 PHP-FPM。
/home、/store、/login、/register、/console等页面应支持直接访问与刷新。- API 请求应返回业务响应,不能统一改写为前台 HTML 页面。
- 自定义后台地址后,使用系统保存的新入口;旧默认入口不作为备用地址。
- 配置、日志、备份及上传目录中的脚本不允许通过 Web 读取或执行。
宝塔修改配置后先检查配置语法再重载 Nginx。若只在 CDN/反向代理后异常,请核对回源站点、转发规则与缓存,禁止缓存安装、登录和后台 API 响应。
四、完成安装与配置
向导顺序:服务条款 → 环境检测 → 数据库 → 授权码 → 管理员 → 安装完成。
数据库不存在时尝试自动建库,前提是数据库账号拥有建库权限。安装完成后保存后台地址、核对站点信息,按业务需要配置支付、通知与主题。
五、备份与更新
更新前分别备份数据库、站点配置、上传资料和自定义扩展,并确认备份可恢复。程序回滚不等同于完整业务数据恢复。
通过后台 系统更新 查看本版更新内容、执行进度及日志。更新后检查前台、后台、登录、支付、工单和任务状态。详见系统更新与备份恢复。
六、日志与支持
优先查看页面提供的错误报告、更新日志与时间点;服务器管理员可配合查看 PHP-FPM、Nginx 及应用日志。发送给技术支持前,应去除密码、令牌、授权码和客户资料。