Docker部署Kuma Mieru监控面板

2026-05-11 6 admin

前言

对于运行 NAS 或自建服务器的用户而言，服务可用性监控是基础设施运维的重要一环。如果你已经在使用 Uptime Kuma 监控网站、API 或网络设备，却希望拥有一个更现代、更直观的数据展示界面，那么由社区开源的 Kuma Mieru 第三方仪表盘将是一个极佳的选择。

Kuma Mieru 基于 Next.js 16、TypeScript 与 Recharts 构建，界面采用 HeroUI 组件框架，支持实时自动刷新、响应式布局以及深色/亮色/系统主题切换。项目以 MPL-2.0 协议开源，个人与家庭用户可自由使用。

重要前提：Kuma Mieru 本身不具备监控采集能力，它通过读取 Uptime Kuma 的公开状态页面来渲染数据。因此，你必须先完成 Uptime Kuma 的部署和状态页配置，才能继续本文的后续步骤。

准备工作

一台已启用 Docker 的 NAS 或 Linux 服务器（本文以群晖为例）
确认宿主机的 3211 和 3883 端口当前未被占用
确保后续部署的 Kuma Mieru 容器能够通过内网访问到 Uptime Kuma

第一部分：部署 Uptime Kuma 并生成状态页

步骤 1：Docker CLI 快速安装

通过 SSH 登录群晖后，执行以下命令完成 Uptime Kuma 的部署：

# 创建持久化数据目录
mkdir -p /volume1/docker/uptime-kuma

# 进入该目录
cd /volume1/docker/uptime-kuma

# 运行容器
docker run -d \
   --restart unless-stopped \
   --name uptime-kuma \
   -p 3211:3001 \
   -v $(pwd):/app/data \
   louislam/uptime-kuma

提示：-v $(pwd):/app/data 将容器内的数据映射到宿主机，防止容器重建后监控配置丢失。

步骤 2：初始化系统并添加监控项

浏览器访问 http://<群晖IP>:3211，根据页面引导创建管理员账号。
登录后台，添加你的第一个监控目标。以监控博客为例：
显示名称：老苏博客
URL：https://laosu.tech
保存后稍等片刻，待系统完成首次数据采集。

步骤 3：创建公开状态页面

Kuma Mieru 需要抓取的是 Uptime Kuma 的公开状态页，而非登录后的管理后台。

在 Uptime Kuma 后台左侧菜单进入「状态页面」。
点击新增状态页，填写如下信息：
名称：例如 page1
路径：建议与名称保持一致，例如 page1
在监控项下拉框中，勾选刚才添加的站点（若此前仅添加了一个站点，此处只会显示一项）。
保存配置后，你将获得如下格式的公开地址： http://<群晖IP>:3211/status/page1 请务必记录此 URL，下一步配置 Kuma Mieru 时必填。

第二部分：部署 Kuma Mieru 可视化面板

步骤 4：拉取并启动容器

回到 SSH 终端，执行以下命令部署 Kuma Mieru：

docker run -d \
  --name kuma-mieru \
  -p 3883:3000 \
  -e UPTIME_KUMA_URLS="http://192.168.0.197:3211/status/page1" \
  -e KUMA_MIERU_TITLE="Kuma Mieru" \
  ghcr.io/alice39s/kuma-mieru

参数解析： - UPTIME_KUMA_URLS：填写上一步获取到的状态页完整地址，此项为必填。 - KUMA_MIERU_TITLE：自定义浏览器标签页及页面主标题，选填。

步骤 5：环境变量进阶配置

如需进一步个性化，可参考下表扩展环境变量：

| 变量名 | 必填 | 说明 | 示例 | |:

Docker部署Kuma Mieru监控面板

评论 (0)

发表评论