首页 / 安装部署
环境准备
系统、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 在占用。
下一步:一键安装。