发财CMS 使用教程
首页 / 运维与参考

常用命令与日常运维

facy / facyManager 命令速查:服务管理、日志排查、数据库配置、端口与 HTTPS 开关、重置超级管理员密码、关键目录。

本页命令默认按 Linux + systemd 的标准安装(安装目录 /usr/local/facy)编写。如果 facyManager 没有在 PATH 里,用完整路径 /usr/local/facy/facyManager(安装包会创建 /usr/local/bin/facy 与 /usr/local/bin/facyManager 软链接)。

关键目录一览

路径 说明
/usr/local/facy/facy 主程序(同一个进程提供后台 6188 与前台 6166)
/usr/local/facy/facyManager 管理命令行工具
/usr/local/facy/web/ 后台与前台页面产物(升级时会被替换)
/usr/local/facy/data/core/admin.conf 超级管理员配置
/usr/local/facy/data/core/database.conf 数据库连接配置
/usr/local/facy/data/system/config.yaml 系统配置(端口、日志、静态目录等)
/usr/local/facy/static/ 上传资源
/usr/local/facy/logs/ 应用日志(默认 app.log)

data/、static/、logs/ 是运行期数据,安装和升级不会覆盖或删除。

程序版本

sh
facy -v        # 或 facy --version,只输出版本号,不启动服务

服务管理(systemd)

服务名 facy.service,默认以 root 运行,工作目录 /usr/local/facy,异常退出 5 秒后自动重启(Restart=on-failure)。

操作 命令
查看状态 systemctl status facy.service
是否运行 systemctl is-active facy.service
是否开机自启 systemctl is-enabled facy.service
启动 / 停止 / 重启 `systemctl start
开启 / 取消开机自启 `systemctl enable

修改端口、HTTPS 开关或数据库配置后,需要 systemctl restart facy.service。

日志排查

目的 命令
实时日志 journalctl -u facy.service -f
最近 100 行 journalctl -u facy.service -n 100 --no-pager
本次开机以来 journalctl -u facy.service -b --no-pager
仅错误级别 journalctl -u facy.service -p err -n 100 --no-pager

另外应用也会把日志写入 /usr/local/facy/logs/(目录与文件名由 config.yaml 的 log.dir、log.filename 决定)。

facyManager

text
facyManager reset-password [-data-dir path] [-admin-conf path]
facyManager upgrade [-timeout 30m]
facyManager db show [-data-dir path] [-database-conf path]
facyManager db set -host host -port port -database name -username user [-password password] [-data-dir path] [-database-conf path]
facyManager db ping [-data-dir path] [-database-conf path] [-timeout 5s]
facyManager config frontend-port -port port [-data-dir path] [-system-conf path]
facyManager config https -enabled true|false [-data-dir path] [-system-conf path]

数据目录不在默认位置时,统一加 -data-dir /实际/data目录;只想指定某个文件就用 -admin-conf / -database-conf / -system-conf。

重置超级管理员密码

sh
facyManager reset-password

生成 12 位随机密码(含大小写字母和数字)写入超级管理员配置,并在终端输出「管理员账号」和「新密码」;同时把 Google 验证器开关改为关闭(原密钥保留)。拿到新密码登录后,请立刻到「账号设置 → 修改密码」改成自己的密码。

数据库配置

sh
facyManager db show                      # 查看当前连接配置
facyManager db set -host localhost -port 5432 -database facycms -username postgres -password '你的数据库密码'
facyManager db ping                      # 仅执行 SELECT 1,不建表、不迁移、不改数据
facyManager db ping -timeout 10s

数据库密码为空时可省略 -password。修改后:facyManager db ping && systemctl restart facy.service。

前台端口与 HTTPS

sh
facyManager config frontend-port -port 6168      # 修改前台 HTTP 端口(默认 6166)
facyManager config https -enabled true           # 开启前台 HTTPS 服务(443)
facyManager config https -enabled false          # 关闭
systemctl restart facy.service
  • 前台经 Nginx/宝塔反代时,改端口后要同步修改反代的 proxy_pass;
  • 公网 80/443 已被 Nginx/宝塔占用时,通常应关闭发财CMS 自己的 HTTPS 服务,避免端口冲突;
  • 后台端口 6188 在 config.yaml 的 server.port,不通过 facyManager 修改。详见域名、反向代理与 HTTPS。

常见维护组合

场景 命令
改数据库并验证 facyManager db set ... → facyManager db ping → systemctl restart facy.service
升级到最新版 facyManager upgrade → systemctl status facy.service(见升级)
忘记超管密码 facyManager reset-password → 用输出的新密码登录 → 改密码
端口被占用 `ss -lntp
服务起不来 systemctl status facy.service、journalctl -u facy.service -n 100 --no-pager 看报错(多为数据库连不上或端口占用)

日常巡检清单

  1. systemctl is-active facy.service 为 active;
  2. 磁盘空间(上传资源、备份、日志都会增长):df -h;
  3. 后台「备份日志」最近一次本地备份和远程同步为成功(数据备份);
  4. HTTPS 证书未处于「即将到期」(30 天内);
  5. 后台「统计概览」访问与订单曲线无异常断崖(数据统计)。
发财CMS 使用教程