Uptime Kuma 部署与配置指南
文章摘要
|
Uptime Kuma 部署与配置指南
一个轻量级的自托管服务监控工具，监控部署的各种容器状态，当你的服务挂掉时通过 Gotify 推送告警。
1 📌 前置条件
-
NAS 已安装 Docker 并正常运行
-
已部署 Gotify 或 ntfy（用于接收告警通知）
-
域名
uptime.com已解析到 NAS IP（如使用 Traefik 代理） -
Traefik 网络
traefik_public已存在
2 🐳 Docker Compose 部署
2.1 创建数据目录
mkdir -p /docker/uptime-kuma/data
2.2 编写 docker-compose.yml
version: '3.8'
services:
uptime-kuma:
image: louislam/uptime-kuma:2-slim
container_name: uptime-kuma
restart: unless-stopped
networks:
- traefik_public
ports:
- "3003:3001" # 自行更改外部映射端口，也可去掉不对外暴露，通过域名访问
volumes:
- /docker/uptime-kuma/data:/app/data
environment:
- TZ=Asia/Shanghai
labels:
- "traefik.enable=true"
- "traefik.http.routers.uptime.rule=Host(`uptime.com`)"
- "traefik.http.routers.uptime.entrypoints=websecure"
- "traefik.http.routers.uptime.tls=true"
- "traefik.http.routers.uptime.tls.certresolver=letsencrypt"
- "traefik.http.services.uptime.loadbalancer.server.port=3001"
networks:
traefik_public:
external: true
2.3 启动容器
docker-compose up -d
2.4 验证状态
docker ps | grep uptime-kuma
3 🌐 首次访问与初始化
-
访问
http://群晖IP:3003或https://uptime.com -
点击 Create Account 创建管理员账户
-
填写用户名、邮箱、密码，点击创建
-
登录进入仪表盘
4 🔔 配置 Gotify 通知
-
在 Uptime Kuma 设置中，进入 Notifications 页面
-
点击 Setup Notification
-
选择 Gotify
-
填写以下信息：
| 配置项 | 填写内容 |
|---|---|
| Name | Gotify（自定义） |
| Server URL | https://gotify.com（或你的 Gotify 地址） |
| Application Token | 在 Gotify 中为 Uptime Kuma 创建的应用 Token |
- 点击 Test，检查手机是否收到测试通知
5 📊 添加监控项（示例）
| 配置项 | 示例值 |
|---|---|
| Monitor Type | HTTP(s) |
| Friendly Name | AdGuard Home Web |
| URL | http://ip:port |
| Heartbeat Interval | 默认60 秒 |
| Notification | 选择已配置的 Gotify |
5.1 建议首批监控的服务
| 服务 | URL |
|---|---|
| NAS 自身 | ping 或 http://ip:port |
| Traefik | http://ip:port |
| AdGuard Home | http://ip:port |
| Portainer | http://ip:port |
6 ⚙️ 高级配置（按需）
| 配置项 | 说明 | 推荐值 |
|---|---|---|
| 有效状态码 | 视为成功的 HTTP 状态码范围 | 200-299（默认） |
| 证书到期通知 | SSL 证书快过期时提醒 | 按需开启 |
| 忽略 TLS/SSL 错误 | 自签名证书站点勾选此项避免误报 | 按需勾选 |
7 ✅ 验证与验收
-
Uptime Kuma 能正常访问
-
收到 Gotify 测试通知
-
添加的监控项显示为绿色（在线状态）
-
停用一个测试服务，确认收到“宕机”通知
8 🧹 常用维护命令
# 查看日志
docker logs uptime-kuma
# 重启容器
docker-compose restart uptime-kuma
# 停止并删除容器
docker-compose down
# 更新镜像
docker-compose pull
docker-compose up -d
9 📁 数据目录
| 路径 | 说明 |
|---|---|
/docker/uptime-kuma/data | SQLite 数据库和所有配置数据 |
⚠️ 定期备份此目录，防止监控配置丢失。