首页 / 安装部署

环境准备

系统、CPU 架构、PostgreSQL 版本、服务器规格、端口与防火墙要求,以及部署前的检查命令。

快速结论

项目 推荐配置
操作系统 64 位 Linux 服务器版,优先选长期维护版本
CPU 架构 x86_64 / amd64(不支持 arm64 与 32 位)
数据库 PostgreSQL 18(16/17 也推荐)
服务管理 必须有 systemd(服务名 facy.service)
权限 root 或可 sudo 的账号
网络 服务器能访问 download.facycms.com,且装有 curl 或 wget

支持的 Linux 系统

支持等级:推荐(新部署首选)/ 支持(可上生产)/ 兼容(存量过渡)/ 不支持。

发行版 版本 等级
Ubuntu LTS 26.04、24.04 推荐
Ubuntu LTS 22.04、20.04、18.04 支持(18.04 为下限,仅用于存量过渡)
Debian 13 推荐
Debian 12、11 支持(11 为下限)
Rocky / AlmaLinux / RHEL 10、9 推荐
Rocky / AlmaLinux / RHEL 8 支持
CentOS 10、9、8 支持
CentOS 7 不支持
Ubuntu 非 LTS、桌面版 Linux、无 systemd 的精简容器系统 任意 不支持

暂不支持 Docker

目前不提供 Docker 镜像或 docker-compose,也不支持精简容器系统。请使用物理机、云主机或虚拟机部署。

PostgreSQL 要求

PostgreSQL 版本 等级
18 推荐
17、16 推荐
15、14 支持
9.5 – 13 兼容(历史下限,不要用于新部署)
9.4 及以下 不支持

数据库初始化要求:

项目 要求
默认库名 facycms
默认端口 5432
编码 UTF8
建议时区 Asia/Shanghai
必要扩展 pg_trgm(用于标题检索加速)
账号权限 初始化阶段需要建表、建索引、创建扩展和读写数据

如果你自己准备数据库(不用全量安装脚本),可以这样创建并检查:

sh
createdb -E UTF8 -T template0 facycms
psql --version
psql -d facycms -c "CREATE EXTENSION IF NOT EXISTS pg_trgm;"
psql -d facycms -c "\dx"

服务器规格建议

场景 CPU 内存 说明
测试环境 1 核 1 GB 仅功能验证
中小型站点 2 核 4 GB 推荐生产起步
较高负载 8 核+ 16 GB+ 建议独立资源盘

磁盘不要只按程序包估算:封面与上传资源、日志与回调记录、数据库与索引、备份文件、采集与翻译产生的数据都会持续增长。

端口与防火墙

端口 用途 开放建议
6166 前台默认端口 直连模式下对用户开放;走 Nginx 时只需本机可访问
6188 后台管理端口 只对管理员 IP / VPN / 内网开放
5432 PostgreSQL 只允许本机/内网访问
80 / 443 HTTP / HTTPS 公网入口 由发财CMS 或 Nginx 之一监听,不能两者都占

另外还需要允许的网络访问:Let's Encrypt HTTP-01 验证(公网能访问 /.well-known/acme-challenge/)、第三方支付平台回调到你的回调地址、采集/远程图片/翻译服务/订阅验证所需的出站访问。

部署前检查命令

在服务器上执行下面的命令,逐项核对:

sh
cat /etc/os-release        # 系统版本是否在支持范围
uname -m                   # 必须是 x86_64
systemctl --version        # systemd 可用
psql --version             # 已有数据库时确认版本
ss -lntp                   # 6166、6188、5432 以及 80/443 是否被占用
df -h                      # 磁盘空间
free -h                    # 内存

重点确认:架构是 x86_64;systemctl --version 正常输出;6166、6188、5432 没被其他服务占用;如果打算让发财CMS 直接监听 80/443,没有 Nginx/Apache 在占用。

下一步:一键安装。

发财CMS 使用教程