跳转到内容

升级与回滚

升级只替换二进制与静态资源,保留 /etc/ff1/ 配置、FF1_SECRET_KEY、SQLite 数据与管理员账号。

重新运行安装命令即可原地升级(安装命令见开通邮件个人中心 → 我的授权,不公开在文档中)。升级会:

  • 替换 FF1 Master 二进制与 web/dl/
  • 不覆盖 /etc/ff1/ 配置、FF1_SECRET_KEY、SQLite 数据
  • 重启 ff1-master
  1. 备份数据目录与 /etc/ff1/
  2. 阅读 更新日志 是否有破坏性变更
  3. 低峰期操作

若新版异常:停服 → 恢复上一版二进制与备份 → 启动验证。跨大版本升级前保留上一版安装包。

节点二进制来自 Master /dl/,与 Master 版本对齐:

  1. 先升级 Master,使 /dl/ 内为新版
  2. 各节点重新执行安装脚本覆盖,或 systemctl restart ff1-agent
  3. 控制台确认节点在线、配置下发 无异常

滚动建议:分批重启节点,避免同一条隧道链上多个节点同时离线。

  • 不要手动覆盖整个 /etc/ff1/ 目录,会丢配置
  • FF1_SECRET_KEY 不可变,升级脚本不会重置
  • 长期应 Master 与 Core 一起升级,避免协议不一致

Q:升级后控制台 502? A:journalctl -u ff1-master 查启动或数据错误。

Q:能只升级 Core 不升级 Master 吗? A:短期可以;长期双端一起升。