Uptime Kuma 是一个美观、功能强大的自建监控工具,类似于 Uptime Robot
GitHub地址:https://github.com/louislam/uptime-kuma
第一步:准备工作 (更新系统并安装 Docker)
更新系统包
打开终端,以 root 用户或使用 sudo 执行以下命令,确保系统是最新的。
sudo apt update && sudo apt upgrade -y
安装 Docker 依赖
sudo apt install -y apt-transport-https ca-certificates curl gnupg lsb-release
添加 Docker 的官方 GPG 密钥
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
设置 Docker 稳定版仓库
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
安装 Docker Engine
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
启动 Docker 并设置开机自启
sudo systemctl enable docker --now
(可选)将当前用户添加到 docker 组
sudo usermod -aG docker $USER
重要: 执行此命令后,你需要完全注销并重新登录,或者重启系统,才能使组权限生效
第二步:部署 Uptime Kuma
- 可以创建项目目录
sudo mkdir -p /opt/uptime-kuma
cd /opt/uptime-kuma
- 笔者这里就默认执行了
docker run -d --restart=always -p 3001:3001 -v uptime-kuma:/app/data --name uptime-kuma louislam/uptime-kuma:2
- 设置反向代理后,直接网页打开
- 首次运行设置
- 你将会看到 Uptime Kuma 的欢迎页面。
- 你需要创建一个管理员账户。输入用户名和密码,然后点击 “Create”。
- 开始使用
创建账户后,你会直接登录到 Uptime Kuma 的主仪表板。现在你可以:- 添加监控项:点击 “Add New Monitor”。
- 设置通知:在 “Settings” -> “Notifications” 中配置 Telegram、Discord、电子邮件等通知方式,以便在服务下线时收到警报。
- 设置通知:
运维工程师,你好!
系统平台监测到贵单位IT设备或相关服务异常!请及时查看处理,谢谢!
🖥️ 服务名称:{{NAME}}
🌐 监控地址:{{hostnameOrURL}}
🔴 当前状态:{{STATUS}}
⏰ 故障时间:{{heartbeatJSON}}
💬 错误信息:{{monitorJSON}}
📊 平均延迟:{{msg}}
请立即登录管理后台查看详情并处理:
{{PING_URL}}
技术支持:https://www.hao0564.com
售后工单:https://www.help0564.com



第四步:维护与管理
- 查看日志
# 如果使用 docker run
docker logs uptime-kuma
# 如果使用 docker compose
docker compose logs
- 停止服务
# docker run 方式
docker stop uptime-kuma
# docker compose 方式
docker compose down
- 重启服务
# docker run 方式
docker restart uptime-kuma
# docker compose 方式
docker compose restart
- 更新 Uptime Kuma
- 更新非常简单,只需要拉取最新的镜像并重新启动容器即可。
# 进入 docker-compose.yml 所在目录
cd /opt/uptime-kuma
# 拉取最新镜像
docker compose pull
# 重新启动服务(会使用新镜像)
docker compose up -d
# 清理旧的镜像以释放空间
docker image prune
总结
你已经成功在 Debian 系统上使用 Docker 部署了 Uptime Kuma。你现在拥有一个功能强大、界面美观的自建监控平台,可以用来监控你的网站、API、数据库等各种服务的可用性。
- 数据持久化:通过
-v卷挂载,确保了你的监控配置和数据安全。 - 自动重启:
--restart=always保证了服务的高可用性。 - 易于更新:Docker Compose 让更新过程变得非常简单。
- 防火墙:如果你的服务器开启了防火墙(如
ufw),请确保放行3001端口:sudo ufw allow 3001
Debian / Ubuntu 安装 Docker 以及 Docker Compose 教程:https://www.hao0564.com/5537.html
