升级与维护指南
在执行版本升级或运维操作前,请先备份主数据库,并确认当前站点配置已成功发布至各边缘节点。
从 v3.6.x 升级至 v4.0.0
OpenFlare 自 v4.0.0 起采用基于 Pingora 的边缘网关(OpenFlare Edge)全面替代原 OpenResty 架构。升级前请记录原节点的专属令牌,自定义的 OpenResty 性能参数需在控制台「性能策略」中重新配置。
迁移步骤
- 升级控制面 Server:升级 Server 至 v4.0.0+,确认数据库迁移自动执行完毕,且控制端已成功生成 Pingora 站点配置快照。
- 逐台迁移边缘节点:
- 停止旧版本 Agent 及 OpenResty 服务,释放 TCP
80与443端口:sudo systemctl stop openflare-agent openresty 2>/dev/null || true sudo systemctl disable openflare-agent openresty 2>/dev/null || true - 在控制台节点详情中复制边缘节点部署命令,或参考 OpenFlare Edge 部署指南 部署新网关。使用原节点的专属令牌可保留原节点 ID、统计数据及域名绑定关系。
- 停止旧版本 Agent 及 OpenResty 服务,释放 TCP
- 验证并灰度推进:
- 确认新节点状态变为在线,且成功加载有效快照。
- 验证经过该节点的 HTTP 与 HTTPS 请求转发正常,确认无误后推进下一台节点。
Server 控制面升级
1. 数据库备份
在拉取新版本前,务必备份主数据库:
# PostgreSQL 备份
docker compose exec postgres pg_dump -U openflare openflare > openflare_backup_$(date +%Y%m%d).sql
# SQLite 单机版备份
cp ./openflare-data/openflare.db ./openflare-data/openflare_backup_$(date +%Y%m%d).db2. Docker Compose 容器升级
拉取最新发布镜像并重启服务:
docker compose pull
docker compose up -d
docker compose ps
docker compose logs -f openflare启动过程中,Server 会通过内置 migrator 自动应用未执行的数据库迁移脚本(涵盖 PostgreSQL 与 SQLite 双数据库引擎),并在启动后根据数据库当前配置自动重新编译站点快照。
3. 源码部署升级
git fetch --tags
git checkout <target-version-tag>
# 重新编译前端静态资源
cd frontend && pnpm install && pnpm build:embed && cd ..
# 重启 Server
go run ./cmd/server allPingora 边缘节点更新
方式 1:控制台远程更新
- 进入管理后台「节点管理」,打开目标边缘节点详情。
- 点击「更新边缘节点」,选择正式版或预览版目标版本,确认后提交更新任务。
- 控制面将在下一次心跳周期(默认 10 秒内)将更新指令下发至节点。节点下载新版本、校验 SHA-256 摘要、排空现有连接并平滑重启。
- 若节点当前处于离线状态,指令将保留至节点恢复心跳后执行。
[!TIP] 自动更新机制:在节点的「编辑」对话框中开启「自动更新节点」,节点在就绪后每 6 小时自动检测 GitHub Releases 较新的正式版并静默升级。手动触发的任务优先级高于自动更新。
方式 2:主机脚本就地更新
在 Linux 节点上执行更新脚本,脚本将自动检测已有安装目录与状态目录,原子替换 /opt/openflare-edge/current 二进制并重启 systemd 服务:
# 远程下载执行
curl -fsSL https://raw.githubusercontent.com/Rain-kl/OpenFlare/main/scripts/update-openflare-edge.sh | sudo bash
# 指定特定版本更新
curl -fsSL https://raw.githubusercontent.com/Rain-kl/OpenFlare/main/scripts/update-openflare-edge.sh | sudo bash -s -- --version edge-v0.1.3方式 3:Docker 容器节点更新
拉取最新边缘节点镜像并重建容器(数据卷保留节点身份与缓存):
docker pull ghcr.io/rain-kl/openflare-edge:latest
docker stop openflare-edge && docker rm openflare-edge
docker run -d --pull always --name openflare-edge --restart unless-stopped \
-p 80:8080 -p 443:8443 \
-v openflare-edge-data:/var/lib/openflare-edge \
-e OPENFLARE_EDGE_SERVER_URL=https://control.example.com \
-e OPENFLARE_EDGE_TOKEN_TYPE=node \
-e OPENFLARE_EDGE_TOKEN='<节点专属令牌>' \
ghcr.io/rain-kl/openflare-edge:latestRelay 与 Tunnel 客户端更新
在管理后台对应的节点详情页中,可查看当前运行版本并执行更新,或开启自动更新。对于基于 Docker 运行的 Relay 和 OpenFlared:
# 更新 Relay
docker pull ghcr.io/rain-kl/openflare-relay:latest
docker stop openflare-relay && docker rm openflare-relay
# 使用原参数重新运行 docker run ...
# 更新 OpenFlared
docker pull ghcr.io/rain-kl/openflared:latest
docker stop openflared && docker rm openflared
# 使用原参数重新运行 docker run ...异常回滚与故障排查
若升级后服务未正常拉起:
- 查看边缘节点日志:
sudo journalctl -u openflare-edge -n 100 --no-pager - 容灾快照保留机制:OpenFlare Edge 在启动失败时不会覆盖本地
/var/lib/openflare-edge/snapshot.json快照文件,确保在排查期间持续按有效快照提供服务。 - 回滚 Edge 版本:通过脚本传入历史稳定版本标签执行降级:
sudo bash scripts/install-openflare-edge.sh --version edge-v0.1.2 ...