发财CMSfacycms.com Telegram频道

常用管理命令

安装后常用管理命令集中速查: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/ 是运行期数据,安装和升级不会覆盖或删除。

程序版本

查看版本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 facy.service
停止systemctl stop facy.service
重启systemctl restart facy.service
开启开机自启systemctl enable facy.service
取消开机自启systemctl disable facy.service

修改端口、HTTPS 开关或数据库配置后,需要重启服务才会生效。

日志排查

实时日志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

facyManager 是管理命令行工具,下面按用途分组列出,每条都可以单独复制。

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

重置超级管理员密码

重置超管密码facyManager reset-password

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

升级

升级到最新版facyManager upgrade
指定超时时间facyManager upgrade -timeout 30m

升级流程见升级。

数据库配置

查看连接配置facyManager db show
修改连接配置facyManager db set -host localhost -port 5432 -database facycms -username postgres -password '你的数据库密码'
测试连接facyManager db ping
测试连接(指定超时)facyManager db ping -timeout 10s
改完后验证并重启facyManager db ping && systemctl restart facy.service

db ping 仅执行 SELECT 1,不建表、不迁移、不改数据。数据库密码为空时可省略 -password。

前台端口与 HTTPS

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

常见维护组合

改数据库并验证facyManager db ping && systemctl restart facy.service
升级后确认状态facyManager upgrade && systemctl status facy.service
忘记超管密码facyManager reset-password
查端口占用ss -lntp | grep -E '6188|6166|:80|:443'
服务起不来:看状态systemctl status facy.service
服务起不来:看日志journalctl -u facy.service -n 100 --no-pager

端口被占用时,找到占用者后调整端口或关闭占用服务;服务起不来多数是数据库连不上或端口被占用,看日志里的报错即可定位。升级的完整说明见升级。

日常巡检清单

  1. 服务运行正常:
是否运行systemctl is-active facy.service
磁盘空间df -h
  1. 后台「备份日志」最近一次本地备份和远程同步为成功(数据备份);
  2. HTTPS 证书未处于「即将到期」(30 天内);
  3. 后台「统计概览」访问与订单曲线无异常断崖(数据统计)。