圣堂之魂
开始部署

部署总则


一、部署要求

  1. 拥有一台云服务器(最低配置 1H1G);
  2. 拥有一个域名和 SSL 证书;
  3. 已进行备案(国内服务器需要进行 ICP 和公安备案),成功开通 80、443 建站端口;
  4. 已安装 OpenResty(建议在 Docker 环境中运行)和 PHP-FPM;
  5. 了解基本的 Linux 命令和 Docker 操作。

从 V1.9.3 版本后,不再提供一键部署的 Nginx 配置。请使用当前源码版本自带的 ./backend/nginx/nginx.md 手动挂载,不要复制其他版本教程中的配置。

Nginx 配置、api/config.php 和项目源码必须来自同一版本。尤其不要遗漏 su_url 10minternal_token_path 对应的令牌路径、/api/ping 路由和 1-5 位短码规则,否则可能出现容量校验失败、内部同步失败或短链无法访问。

原生部署理论可行,但不提供支持。如果你跑通了,欢迎提 Issue 附上配置;如果跑不通,也欢迎提 Issue,但请把问题描述清楚。说不清楚的不受理。

作者使用 Docker 部署。


二、检查环境(Docker)

使用以下命令检查依赖是否就绪:

docker ps | grep -E "openresty|php"

如果这条指令没有任何输出或只有一行输出,则说明你没有正在运行中的 OpenResty 或 PHP-FPM 的 Docker 容器,请先完成这一步再回来。如果你不知道怎么安装它们,那大概率也用不上这个服务。


本页目录