Kuma Mieru 是一款基于 Next.js 16、TypeScript 和 Recharts 构建的第三方 Uptime Kuma 监控仪表盘。
本项目使用 Recharts 解决了 Uptime Kuma 内建公开状态页面不够直观、没有延迟图表等痛点。
中文版 | English Version
Warning
新版 (v1.1.4+) 重构了时间处理逻辑，请注意修改 Uptime Kuma 后台设置的 Display Timezone (显示时区) 为 UTC+0 时区。
- Kuma Mieru 🚥
- 实时监控，自动刷新 🔃：状态显示实时更新，无需手动刷新，随时掌握最新动态。
- 美观响应式界面 🎨：采用 HeroUI 组件 构建，界面更加现代，完美适配各种设备屏幕。
- 交互式图表 📈：利用 Recharts 图表库实现数据可视化，可以 交互式 地查看各节点的延迟、状态等数据。
- 多主题支持 💡：提供 暗色 / 亮色 / 系统 多种主题，满足不同偏好。
- 维护公告：支持 Uptime Kuma 的 事件公告 和 状态更新 特性，实时同步更高效。
| Dark Mode | Light Mode |
|---|---|
 |
 |
Fork 本仓库到您的 GitHub 用户下，如图所示：
- 在这里 Fork 本仓库
- 点击
Create fork按钮
Note
请确保您 Fork 的仓库是公开的，否则后续可能无法快速同步本仓库的更新。
请放心，您所有的配置均使用环境变量配置，Fork 的代码库 不会泄漏 您的任何配置信息。
进入 https://vercel.com/new ，选择 Import 刚才 Fork 的仓库，如图所示：
- 点击
Environment Variables添加UPTIME_KUMA_URLS（推荐）环境变量，如图所示：
- 点击
Deploy按钮即可一键部署到 Vercel
- 进入你 Fork 的 GitHub 仓库，点击
Sync fork按钮 - 点击
Update branch按钮，即可自动同步本仓库的最新代码
与 Vercel 部署 类似，只需将仓库导入到 Cloudflare 即可。
特别注意：
1.
Build command 请使用 bun run deploy:cloudflare 命令，否则无法正常部署。2. 一定要配置环境变量，详请参考 环境变量配置 一节。
只需简单几步，即可快速启动 Kuma Mieru：
-
克隆仓库
git clone https://github.com/Alice39s/kuma-mieru.git cd kuma-mieru -
安装依赖
Kuma Mieru 使用 Bun 作为包管理器，您需要先安装 Bun：
# Linux/macOS curl -fsSL https://bun.sh/install | bash # Windows powershell -c "irm bun.sh/install.ps1 | iex"
然后再安装依赖包：
bun install
-
配置环境变量 复制
.env.example文件为.env：cp .env.example .env
.env文件中 必填 的环境变量，可参考 环境变量配置 章节。 -
启动开发服务器
bun run dev
-
访问仪表盘 打开浏览器，访问 http://localhost:3883 即可查看您的 Kuma Mieru 监控仪表盘。
-
部署上线
bun run build bun run start
-
克隆仓库
git clone https://github.com/Alice39s/kuma-mieru.git cd kuma-mieru -
配置环境变量 复制
.env.example文件并创建.env文件：cp .env.example .env
参考 环境变量配置 章节，配置必要的环境变量。
-
启动服务
docker compose up -d
服务将在
http://0.0.0.0:3883上运行。 -
查看日志
docker compose logs -f
-
更新镜像
docker compose pull docker compose up -d
docker pull ghcr.io/alice39s/kuma-mieru:1复制 .env.example 文件并创建 .env 文件：
cp .env.example .env请参考 环境变量配置 章节，优先配置 .env 中的 UPTIME_KUMA_URLS 变量。
docker run -d \
--name kuma-mieru \
-p 3883:3000 \
-e UPTIME_KUMA_URLS="https://example.kuma-mieru.invalid/status/default|https://example.kuma-mieru.invalid/status/secondary" \
-e KUMA_MIERU_TITLE="Kuma Mieru" \
ghcr.io/alice39s/kuma-mieru:1Warning
Docker 镜像推荐使用 ghcr.io/alice39s/kuma-mieru:1（主版本通道）。
v1 主版本内将尽可能保持向前兼容；v2 将是包含重大 Breaking Changes 的版本。
不推荐固定到次版本/补丁版本（例如 :1.6 或 :1.6.2），除非您有明确的灰度与回滚策略。
首先，假设您的 Uptime Kuma 状态页面 URL 为：
https://example.kuma-mieru.invalid/status/test1
推荐配置：
UPTIME_KUMA_URLS=https://example.kuma-mieru.invalid/status/test1
如果有多个状态页，可以使用 | 分隔完整 URL：
UPTIME_KUMA_URLS=https://example.kuma-mieru.invalid/status/test1|https://example.kuma-mieru.invalid/status/test2
环境变量说明如下（含向后兼容）：
| 变量名 | 必填 | 说明 | 示例/默认值 |
|---|---|---|---|
| UPTIME_KUMA_URLS | Yes* | 推荐。完整状态页 URL，支持使用 | 分隔多个 URL（可来自不同 Kuma 实例） |
https://example.kuma-mieru.invalid/status/default|https://example.kuma-mieru.invalid/status/secondary |
| UPTIME_KUMA_BASE_URL | Yes* | 兼容旧版。Uptime Kuma 实例基础 URL（当未设置 UPTIME_KUMA_URLS 时启用） |
https://example.kuma-mieru.invalid |
| PAGE_ID | Yes* | 兼容旧版。状态页 ID，支持逗号分隔多个页面（当未设置 UPTIME_KUMA_URLS 时启用） |
default,status-asia |
| KUMA_MIERU_EDIT_THIS_PAGE | No | 是否展示 "Edit This Page" 按钮（新变量名） | false |
| KUMA_MIERU_SHOW_STAR_BUTTON | No | 是否展示 "Star on Github" 按钮（新变量名） | true |
| KUMA_MIERU_TITLE | No | 自定义页面标题（新变量名） | Kuma Mieru |
| KUMA_MIERU_DESCRIPTION | No | 自定义页面描述（新变量名） | A beautiful and modern uptime monitoring dashboard |
| KUMA_MIERU_ICON | No | 自定义页面图标 URL（新变量名） | /icon.svg |
| FEATURE_EDIT_THIS_PAGE | No | 兼容旧版，等价于 KUMA_MIERU_EDIT_THIS_PAGE |
false |
| FEATURE_SHOW_STAR_BUTTON | No | 兼容旧版，等价于 KUMA_MIERU_SHOW_STAR_BUTTON |
true |
| FEATURE_TITLE | No | 兼容旧版，等价于 KUMA_MIERU_TITLE |
Kuma Mieru |
| FEATURE_DESCRIPTION | No | 兼容旧版，等价于 KUMA_MIERU_DESCRIPTION |
A beautiful and modern uptime monitoring dashboard |
| FEATURE_ICON | No | 兼容旧版，等价于 KUMA_MIERU_ICON |
/icon.svg |
| ALLOW_INSECURE_TLS | No | 是否跳过上游 Uptime Kuma HTTPS 证书校验（仅用于受信任的自签名环境） | false（默认，强校验） / true（跳过校验，有安全风险） |
| REQUEST_TIMEOUT_MS | No | 全局上游请求超时（毫秒，默认值 8000） | 8000 |
| REQUEST_RETRY_MAX | No | 全局上游请求最大重试次数（默认值 3） | 3 |
| REQUEST_RETRY_DELAY_MS | No | 全局上游请求重试基础间隔（毫秒，默认值 500） | 500 |
| SSR_STRICT_MODE | No | 是否启用严格 SSR 失败模式（多页面全部失败时触发全局错误页） | true / false （默认） |
| NEXT_PUBLIC_ERROR_PAGE_DEV_MODE | No | 是否在错误页显示完整堆栈 | false（默认） / true |
| ALLOW_EMBEDDING | No | 是否允许在 iframe 中嵌入（运行时生效，重建镜像后无需重新 build） | false (禁止) / true (允许所有，不推荐) / example.com,app.com (白名单) |
| STRICT_IMAGE_REMOTE_PATTERNS | No | 是否启用严格远程图片域名白名单（构建时生效） | false（默认，放开所有远程图片域名） / true（仅允许 generate-image-domains 生成的域名） |
* UPTIME_KUMA_URLS 与 UPTIME_KUMA_BASE_URL + PAGE_ID 二选一即可。若同时配置，优先使用 UPTIME_KUMA_URLS。
修改 .env 后请执行 docker compose up -d --force-recreate 让容器重新注入环境变量。
Warning
默认情况下（STRICT_IMAGE_REMOTE_PATTERNS=false）会放开 next/image 的远程图片域名限制，以避免 Docker 运行时域名变化导致图片加载失败。
如果你运行在高安全要求环境，建议在自建镜像时设置 STRICT_IMAGE_REMOTE_PATTERNS=true，并确保构建阶段可生成完整域名白名单。
Note
经测试，本项目兼容 Uptime Kuma 的最新稳定版本 (v1.23.0+)
如您使用的版本较低，请参考 Uptime Kuma 官方文档 尝试升级到最新稳定版 (v1.23.0+)，注意备份好数据。
Kuma Mieru 与备受好评的开源监控工具 Uptime Kuma 无缝集成，您只需要：
- 安装并配置 Uptime Kuma
- 在 Uptime Kuma 设置中修改
Display Timezone(显示时区) 为任意UTC+0时区 - 在 Uptime Kuma 中创建 "状态页面"
- 在
.env文件中配置环境变量
由于 Uptime Kuma 后端传递到前端的时间 没有携带时区信息，为了方便开发，Kuma Mieru 会 自动将时间转换为 UTC+0 时区 并显示。
如果您发现时区偏移，请前往 Uptime Kuma 设置中修改 Display Timezone (显示时区) 为任意 UTC+0 时区。
Kuma Mieru 设计之初就是为了解决 Uptime Kuma 的不足，所以 v1 暂时不考虑支持其他监控数据源。
不过 v2 版本可能会考虑支持 Uptime Robot / Better Stack 等其他监控工具的 API 接口。
非常欢迎您为 Kuma Mieru 项目作出贡献！
如果您有任何想法或建议，请参阅 CONTRIBUTING.md 了解详细的贡献方式。
本项目采用 MPL-2.0 (Mozilla Public License Version 2.0) 开源许可证。