进阶 docs.pangolin.net 2026-11-21 15:06:37 · 9 阅读

第18章 如何更新

如何更新

保持自托管的 Pangolin 服务器始终拥有最新功能和安全补丁

Pangolin 由一组 Docker 镜像组成,因此更新非常简单:拉取最新镜像并重启即可。

本页介绍如何更新自托管的 Pangolin 服务器。如需更新站点和客户端,请参阅 respective 指南:

更新站点

将站点更新到最新版本。

各平台客户端

更新各平台的客户端。

迁移脚本

Pangolin 启动时如果检测到版本更新,会自动运行迁移脚本来更新数据库和配置文件。Pangolin 会在数据库中记录上次成功运行的版本,从而知道还有哪些脚本需要执行。脚本按从旧到新的顺序依次运行。

这些脚本通常是 SQL 结构变更,有时也会涉及数据迁移。

如果某个版本包含 Badger 更新,且 Traefik 配置仍与 Pangolin 安装器的默认配置一致,Pangolin 还会尝试自动更新 Traefik 配置。如果无法应用该更改,它会静默失败,由你自行更新 Badger。

数据库迁移失败会阻塞启动,导致服务器无法运行。

如果使用 SQLite,Pangolin 会在迁移前自动备份数据库文件,以便需要时回滚。设置环境变量 DISABLE_BACKUP_ON_MIGRATION 为 true 可关闭此功能。

由于迁移可能改变数据库结构,降级有时不可行,也不建议这样做——数据库可能与旧版本不兼容。更新前务必备份数据库。

更新前的准备

更新前务必备份数据。把 config 目录复制到安全位置,以便需要时回滚。

建议在主要版本之间逐级更新。例如从 1.0.0 > 1.1.0 > 1.2.0,而不是直接从 1.0.0 跳到 1.2.0。

更新流程

1. 停止服务栈

停止所有运行中的容器:

``` sudo docker compose down ```

2. 查看最新版本

查找各组件的最新版本号:

- Pangolin:GitHub Releases - Gerbil:GitHub Releases - Traefik:Docker Hub - Badger:GitHub Releases

请选择最新的稳定版本(不要用预发布版或 beta 版)。

3. 更新版本号

编辑 docker-compose.yml,更新镜像版本:

```yaml # docker-compose.yml services: pangolin: image: fosrl/pangolin:1.22.0 # 查看 GitHub Releases 获取最新版本号 # ... 其余配置

gerbil: image: fosrl/gerbil:1.5.1 # 查看 GitHub Releases 获取最新版本号 # ... 其余配置

traefik: image: traefik:v3.7.12 # 查看 GitHub Releases 获取最新版本号 # ... 其余配置 ```

在 config/traefik/traefik_config.yml 中更新 Badger 版本号:

```yaml # traefik_config.yml experimental: plugins: badger: moduleName: github.com/fosrl/badger version: v1.7.0 # 查看 GitHub Releases 获取最新版本号 ```

按需更新各个服务,可以逐个更新,也可以一次性全部更新。

4. 拉取新镜像

下载更新后的 Docker 镜像:

``` sudo docker compose pull ```

5. 启动服务栈

启动更新后的容器:

``` sudo docker compose up -d ```

6. 观察更新过程

查看日志,确认一切正常启动:

``` sudo docker compose logs -f ```

7. 验证功能

测试各项功能是否正常:

- 访问 Pangolin 控制台 - 确认所有站点均可访问 - 验证隧道连接(如使用 Gerbil) - 测试自定义配置

一切正常,更新就完成了!

评论 (0)