常见问题 FAQ

安装与启动 #

Q:支持哪些系统?支持 Docker 吗? A:只按 64 位 Linux 服务器版(x86_64/amd64) 设计,推荐 Ubuntu 24.04/26.04、Debian 13、Rocky/AlmaLinux 9/10 等,依赖 systemd 和 PostgreSQL;不支持桌面版 Linux、arm64、32 位。当前官方没有提供 Docker 镜像或 compose 文件,请按安装部署使用安装脚本或 deb/rpm 包。详见环境准备。

Q:安装完访问不了后台? A:依次检查:(1)systemctl status facy.service 是否 active;(2)后台地址是 http://服务器IP:6188,云服务器安全组/防火墙要放行 6188;(3)ss -lntp | grep -E '6188|6166' 看端口是否被别的程序占用;(4)journalctl -u facy.service -n 100 --no-pager 看报错,最常见是数据库连不上(facyManager db ping)。

Q:前台端口和后台端口分别是多少? A:后台 6188,前台 6166(同一个 facy 进程里两个服务)。前台端口可用 facyManager config frontend-port -port N 修改,后台端口在 /usr/local/facy/data/system/config.yaml 的 server.port。见架构和常用命令。

Q:打开后台是白屏? A:web/admin 目录缺失或浏览器缓存了旧资源。重新安装/升级程序包,浏览器 Ctrl+F5 强刷。

Q:全量安装脚本创建的数据库账号是什么? A:installFull.sh 会创建 PostgreSQL 角色和库 facycms;出于安全,正式环境请在安装后修改默认密码(参见安装部署)并用 facyManager db set 同步配置。

登录与权限 #

Q:一直提示验证码错误? A:点击验证码图片刷新后重新输入;验证码有时效。

Q:忘记超级管理员密码? A:服务器上执行 facyManager reset-password,终端会输出新的 12 位随机密码,并同时关闭 Google 验证器(原密钥保留)。登录后立刻改密码。详见首次登录。

Q:普通管理员登不上,超级管理员可以? A:「团队协作」是订阅功能,订阅未生效时只有超级管理员能登录。见角色与权限。

Q:启用 IP 白名单后自己进不去了? A:只有名单内 IP 能登录后台。从名单内的网络登录,或联系有权限的管理员调整;务必在启用前把自己的出口 IP 加进去。见账户与安全。

Q:某个菜单点不开或没有按钮? A:多半是权限码不足:后台权限形如 admin.<模块>.<功能>.<动作>,管理员所在的组需要勾选相应权限;也可能该功能需要订阅授权(页面会提示「待解锁」)。

域名、HTTPS 与代理 #

Q:怎么让前台用 80/443 访问? A:两种方案:让发财CMS 直接监听 80/443(安装时选择启用,然后在「证书管理」申请证书),或用 Nginx/宝塔监听 80/443 反代到 127.0.0.1:6166。二者不要同时占用 80/443。见域名、反向代理与 HTTPS和主机配置。

Q:自动申请证书失败? A:确认域名已解析到本机、外网能访问 80 端口、/.well-known/acme-challenge/ 没被防火墙/Nginx/Cloudflare 拦截;Cloudflare 下先用「DNS only(灰云)」申请成功后再切橙云。

Q:开启「强制 HTTPS」后无限重定向或打不开? A:证书还没就绪,或反向代理没有传递 X-Forwarded-Proto。先让证书可用,并在 Nginx 里加 proxy_set_header X-Forwarded-Proto $scheme;。

Q:开启「仅允许已配置域名访问」后站点打不开? A:当前使用的域名没有加入规则列表。开启前必须先添加。域名白名单只拦截**前台(6166/80/443)**请求,后台 6188 不受影响:用 http://服务器IP:6188 登录后台,到「主机配置 → 域名管理」补上前台域名并保存即可。

内容、播放与封面 #

Q:采集后视频没有分类/前台看不到? A:先在采集管理里把源分类绑定到本地分类;未绑定的分类下的视频不会在公共采集接口里输出,前台展示也依赖分类与区块配置(页面配置)。

Q:封面不显示或大量封面失败? A:详见封面与切片加速。看「封面图处理配置」:下载间隔是否过快、重试次数是否合理、远程源是否 404。不要轻易开启「失败自动删除视频」。修正后可用「重新下载全部图片」(需先关闭封面下载总开关)。见系统设置。

Q:切片加速提示「点播加速未生效」? A:详见切片加速。需要订阅有效、采集源使用默认播放器,并到「订阅管理 → 订阅功能」开启「HLS 索引缓存」。直播不依赖该开关。

Q:修改了页面配置前台没变化? A:先确认已点击保存;浏览器强刷;如果开启了「前台访问加速」,到APP 管理点「刷新缓存」并保存;有 CDN 的话清理 CDN 缓存。

支付与会员 #

Q:用户付款成功但订单没到账? A:支付渠道的异步通知需要打到 你的前台域名/payment/callback/渠道ID(GET/POST 都支持)。检查:渠道后台配置的回调地址是否正确且公网可访问;「回调日志」里有没有收到;必要时在「订单管理」里人工回调。见支付管理。

Q:没有「支付商户」菜单? A:对应菜单名是「提供商配置」。

备份与升级 #

Q:备份失败,日志提示数据库备份失败? A:数据库备份调用服务器上的 pg_dump,需要安装 PostgreSQL 客户端工具且能连接到库;其次检查本地保存目录是否可写、磁盘空间是否充足。见数据备份。

Q:后台能一键恢复备份吗? A:不能,后台只有备份和同步。恢复要在服务器上手动执行,步骤见数据恢复。

Q:怎么升级?会丢数据吗? A:facyManager upgrade。只替换 facy、facyManager、web/,不会覆盖 data/、static/、logs/;仍建议升级前备份。见升级。

Q:升级后页面异常? A:浏览器强刷、清理 CDN 缓存、刷新「前台访问加速」缓存,再查看 journalctl -u facy.service -n 100 --no-pager。

其他 #

Q:OpenAPI 返回 401? A:依次核对:App ID、签名算法是否在应用里启用、时间戳偏差、body_hash(POST)、签名计算是否使用 sha256(secret) 作为密钥。临时开启应用的「输出详细错误」看原因。见OpenAPI。

Q:教程里的界面和我看到的不一样? A:界面可能因订阅状态、语言、数据量略有差异。功能名称与路径请以你实际安装的版本为准。