首页 / 运维与参考
升级到新版本
使用 facyManager upgrade 升级、升级会覆盖和保留什么、升级前的备份与升级后的验证、回退思路。
升级会改动什么
安装包与升级流程只替换这三项:
| 会被替换 | 不会被覆盖/删除 |
|---|---|
/usr/local/facy/facy |
/usr/local/facy/data/(超管、数据库、系统配置) |
/usr/local/facy/facyManager |
/usr/local/facy/static/(上传资源) |
/usr/local/facy/web/ |
/usr/local/facy/logs/(日志) |
数据库内容不会因升级被清空;新版本启动时由程序自行完成必要的数据库迁移。升级时服务会重启。
升级前:先备份
升级虽不覆盖运行数据,仍建议:
- 到后台「数据备份 → 本地备份」点「立即备份」,数据库、上传资源、系统配置三项都勾选,并确认「备份日志」为成功(见数据备份与恢复);
- 有远程备份的先「立即同步」;
- 记录当前版本:
facy -v; - 在访问低峰操作,并提前告知运营人员——重启会让站点短暂不可用。
执行升级
sh
facyManager upgrade该命令会:下载官方安装脚本 https://download.facycms.com/facycms/install.sh 到系统临时目录 → 赋予执行权限 → 执行 → 结束后删除临时脚本。整个过程有总超时,默认 30 分钟,网络慢可以调整:
sh
facyManager upgrade -timeout 60m升级过程中如果脚本提示输入,按终端提示操作。需要能访问 download.facycms.com;服务器无法访问外网时需要自行下载新版 deb/rpm 包并用包管理器安装(deb 用 dpkg -i,rpm 用 rpm -Uvh,包地址格式见安装部署)。
升级后验证
sh
facy -v
systemctl status facy.service
journalctl -u facy.service -n 100 --no-pager然后在浏览器检查:
- 后台能正常登录,仪表盘数据正常;
- 前台首页、视频播放、登录注册正常;
- 「数据备份」「支付管理」「订阅管理」等关键页面能正常打开;
- 浏览器强制刷新(Ctrl+F5)——后台是单页应用,旧页面缓存可能让新旧资源混用;如果开启了「前台访问加速」(应用配置),到APP 管理点「刷新缓存」。
升级失败怎么办
| 现象 | 处理 |
|---|---|
| 下载脚本失败/超时 | 检查服务器网络与 DNS;加大 -timeout;或手动下载安装包 |
| 升级后服务起不来 | journalctl -u facy.service -n 100 --no-pager 查看原因,常见为数据库连不上(facyManager db ping)或端口被占用 |
| 页面显示异常 | 强制刷新浏览器、清理 CDN/Cloudflare 缓存 |
| 需要回退 | 安装旧版本的 deb/rpm 包覆盖程序文件,再按恢复步骤恢复升级前的备份数据库。数据库一旦被新版本迁移,直接回退程序不一定兼容,务必依赖升级前的备份 |
不要手动改 `web/` 目录
web/ 会在每次升级时被整体替换,在里面做的手工修改会丢失。需要改页面内容请使用后台的页面配置。
版本信息
升级前后可用 facy -v 查看当前版本。各版本变更见更新说明。