进阶 uptime.kuma.pet 2026-11-20 10:30:00 · 9 阅读

第4章 Uptime Kuma 第4章:从 v2 迁移到 v3(Beta)

(Beta) 从 v2 迁移到 v3

警告

3.0.0-beta.1 是测试版本。

这是一次重大版本更新,包含破坏性变更。请务必先阅读本指南。

注意

开始之前

1. 首先停止 Uptime Kuma。 2. 备份整个数据目录。确保包含 `kuma.db` 和 `db-config.json`。 3. 测试备份是否可恢复。 4. 保留备份的额外副本。

v3 将就地升级数据库,没有降级路径。备份是唯一的重建手段。

破坏性变更

* Prometheus:`/metrics` 默认已禁用(由于 CPU 占用较高)。如需使用,请在 设置 → 通用 → Prometheus API 中启用。 * linux/arm/v7:自 Node.js 24 起不再受支持。如果你正使用 Raspberry Pi 2 或更早的 armv7 设备运行 Uptime Kuma,请不要升级到 v3。 * (非 Docker 部署):需要 Node.js 26.2.0 或更高版本。 * (非 Docker 部署):请使用 `node --run start` 启动。直接运行 `node server/server.js` 已不再有效。 * (非 Docker 部署):PM2 用户应使用 `pm2 start`,而非 `pm2 start server/server.js`。 * 身份验证:已迁移至 Better Auth。这对普通用户没有影响。但如果你曾使用第三方应用集成,由于新的认证方式,这些集成可能会失效。

Docker 标签

v3 拥有独立的测试版标签,与 v2 标签分开管理。

| 标签 | 描述 | | :--- | :--- | | `beta` | 最新的 v3 测试版(推荐用于测试) | | `beta-slim` | (精简版)最新的 v3 测试版 | | `beta-rootless` | 最新的 v3 测试版(Rootless) | | `beta-slim-rootless` | (精简版)最新的 v3 测试版(Rootless) | | `nightly` | 每日构建版本 |

迁移步骤(Docker)

1. 停止容器。

```bash docker stop uptime-kuma ```

2. 备份数据目录。 3. 将镜像标签更改为 `louislam/uptime-kuma:beta`。

```bash docker run -d --restart=unless-stopped -p :3001 -v :/app/data --name uptime-kuma louislam/uptime-kuma:beta ```

4. 查看日志。

```bash docker logs -f uptime-kuma ```

5. 打开 Web UI 并登录。

迁移步骤(Docker Compose)

1. 停止堆栈。

```bash docker compose down ```

2. 备份数据目录。 3. 将镜像标签更改为 `louislam/uptime-kuma:beta`。

```yaml services: uptime-kuma: image: louislam/uptime-kuma:beta .... ```

4. 启动堆栈。

```bash docker compose up -d ```

5. 查看日志。

```bash docker compose logs -f ```

6. 打开 Web UI 并登录。

迁移步骤(非 Docker / PM2)

1. 停止 Uptime Kuma。

```bash pm2 stop uptime-kuma ```

2. 备份数据目录。 3. 检查 Node.js 版本。需要 26.2.0 或更高版本。

```bash node --version ```

4. 将源码更新至 beta 标签。

```bash git fetch --all --tags git checkout 3.0.0-beta.1 --force ```

5. 安装依赖项及预构建的前端文件。

```bash npm install --omit dev --no-audit npm run download-dist ```

6. 首先移除现有进程。

```bash pm2 delete uptime-kuma ```

7. 旧的 `pm2 start server/server.js` 已不再有效。请使用以下命令启动:

```bash pm2 start pm2 save ```

8. 打开 Web UI 并登录。

常见问题

我可以直接从 v1 升级到 v3 吗? 可以。 当然,请先备份数据目录。 另外,请确保你已阅读 `/docs/Migration-From-v1-To-v2` 文档。

我可以降级到 v2 或 v1 吗? 不行。数据库是就地升级的。请恢复升级前制作的备份。

我应该使用哪个 Docker 标签? 在 beta 阶段,请使用 `louislam/uptime-kuma:beta`。

如果我使用的是 armv7 设备该怎么办? 自 Node.js 24 起,linux/arm/v7 不再受支持。不幸的是,选择有限:

* 停留在 v2 * 迁移到 64 位操作系统

从 v1 迁移到 v2 [上一页] | 反向代理 为了安全地将 Uptime Kuma 暴露在网络上,建议通过传统的 Web 服务器(如 nginx 或 Apache)进行反向代理。以下是些……

评论 (0)