第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
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)进行反向代理。以下是些……