先说结论:如果你有闲置的云服务器,想在十几分钟内搭出一个属于自己、界面还好看的网站监控面板,Uptime Kuma 是当前性价比最高的选择——开源、单容器部署、支持 HTTP / TCP / Ping / DNS / 关键词等监控类型,告警能推到邮件、Telegram、企业微信和自定义 Webhook。
它不能替代专业的可用性探针(节点少、没有全国多点拨测),但用来盯自己的几个站、几台机器、几个接口是否活着,完全够用。这篇把部署、反代、告警、备份完整走一遍,中间踩过的坑也一并写出来。
一、Uptime Kuma 适合谁,不适合谁
先帮你判断要不要花这个时间:
- 适合:自己有服务器和几个站点、想把监控数据握在手里、不想为「每分钟一次检测」付订阅费的人。自建服务一多(照片库、下载工具、自建网盘),用一个面板统一盯着比逐个点开看省心得多——比如 immich 自托管照片库 这类服务,挂了没人告诉你才是真麻烦。
- 不太适合:需要多地域拨测、要 SLA 报告、要电话告警的企业场景。这类还是用商业服务更省心。
它和我以前用过的免费监控比,最大的差别是状态页可以自定义:你能给客户或朋友一个干净的公开状态页,显示「哪些服务正常、最近 30 天可用率多少」,而不用暴露后台细节。
二、部署前要准备什么
- 一台云服务器(1 核 1G 起步就够,监控本身很轻)。
- 装好 宝塔面板,方便管 Docker、Nginx 和证书。
- 装好 Docker 管理器(宝塔软件商店里有)。
- Nginx 1.20 或更高版本(用宝塔自带的即可)。
- 一个已经解析到这台服务器的子域名,比如 status.yourdomain.com。
如果你还没装宝塔,安装和基础优化的步骤可以看这篇 宝塔面板安装后的 7 条优化指南,很多默认配置对生产环境不友好,先调完再装监控更省事。
三、Docker 一键部署
SSH 连上服务器,把下面两行贴进去回车即可。第一行创建数据卷,第二行启动容器:
参数解释一下,别漏:
--restart=always:服务器重启后容器自动起来,少了这个重启一次监控就断了。-v uptime-kuma:/app/data:数据卷挂载,这是最关键的一行,不挂的话容器一删配置全没。-p 3001:3001:宿主机端口映射,3001 被别人占了就改成 3002 之类。louislam/uptime-kuma:1:指定主版本 1,避免自动跳到不兼容的大版本。
四、首次访问与账号安全
浏览器打开 http://你的服务器IP:3001,第一次会让你创建管理员账号。三步别省:
- 立刻设置强密码,不要用默认或弱口令。这个面板一旦被扫到,等于把你所有服务的健康状况和部分配置暴露出去。
- 在宝塔「安全」里只放行需要的端口,3001 建议只临时开放,配好域名反代后就关掉。
- 开启两步验证(如果有),面板支持的情况下务必打开。
打不开页面,九成是端口没放行或安全组没开。先查宝塔防火墙,再查云厂商控制台的安全组,两层都要放行。
五、配置监控项
点「添加新的监控项」,最常用的四类:
| 类型 | 监控什么 | 建议 |
|---|---|---|
| HTTP(s) | 网址是否返回 200 | 可加「关键词」判断,防止返回 200 但内容是错误页 |
| TCP | 端口是否可连 | 盯数据库、SSH、自建服务的端口 |
| Ping | 主机是否可达 | 盯整台机器,服务器挂了也能发现 |
| DNS | 解析是否正常 | 盯域名解析被改或失效 |
两个参数建议照着设:检测间隔 60 秒(再密意义不大,还会增加负担)、重试次数 2 次(避免一次网络抖动就告警炸群)。
关键词监控值得重点说:只判断 HTTP 200 是不够的,很多站点出错时依然返回 200,只是页面变成了「数据库连接失败」。加一个「页面必须包含某某关键词」的条件,能抓到这类假活。
六、绑定域名与 HTTPS 反代
直接用 IP:3001 访问不安全也不好看,用宝塔的网站功能做反代即可:
- 宝塔「网站」→ 添加站点,域名填 status.yourdomain.com,不建数据库、不建 PHP。
- 进站点设置 →「反向代理」→ 目标 URL 填
http://127.0.0.1:3001,发送域名填$host。 - 在「SSL」里申请 Let’s Encrypt 证书,开启强制 HTTPS。
- 反代生效后,回到安全设置把 3001 端口关掉。
反代后如果出现「一直加载不出来」或者 WebSocket 连接失败(表现为状态不实时更新),需要在反代配置里加上 WebSocket 支持。宝塔的反代默认已开启,老版本可能要手动加 proxy_set_header Upgrade $http_upgrade; 那几行。
七、告警通知怎么配才不烦人
Uptime Kuma 支持的通知渠道很多,按「到达率 × 打扰程度」排,我的建议是:
- Telegram Bot:到达最快、配置最简单,适合个人。建一个 bot、拿 token、填 chat id 就行。
- 邮件(SMTP):最通用,但容易被判垃圾邮件。用企业邮箱或专门的发信服务更稳。
- 企业微信 / 钉钉机器人:团队协作场景首选,群里所有人都能看到。
- Webhook:想接到自己的系统里做二次处理时用,最灵活。
关键不是接多少渠道,而是分级:核心站点(首页、支付页)出问题走即时通知;次要服务只记录不推送。不然一天几十条告警,你很快就学会无视它,监控就白装了。
八、备份与升级
数据都在那个 Docker 卷里,备份就一句话:
建议每周跑一次,并把压缩包同步到另一台机器或对象存储。只备份在同一条磁盘上等于没备份。
升级前先备份,然后 docker pull louislam/uptime-kuma:1 拉新镜像,删掉旧容器重建(数据卷在,配置不丢)。升级后第一次打开可能会做数据迁移,别急着关页面。
九、常见问题
3001 端口打开是空白页或者连接被拒绝?
先看容器是否在跑:docker ps 里有没有 uptime-kuma。容器在跑但访问不了,多半是宝塔防火墙或云厂商安全组没放行 3001,两层都要检查。容器没跑就看 docker logs uptime-kuma 的报错。
重启服务器后监控全停了?
启动命令里漏了 --restart=always。补上的方法是删掉容器重建,或者 docker update --restart=always uptime-kuma。
删掉容器后配置全没了?
说明当初没挂数据卷。Uptime Kuma 的数据在容器内的 /app/data,必须用 -v uptime-kuma:/app/data 映射出来。重建时务必带上这一行。
绑定域名后状态页打不开或数据不刷新?
反代没配 WebSocket 支持。Uptime Kuma 的实时状态依赖 WebSocket,缺少 Upgrade 头会导致页面能开但数据不更新。在 Nginx 反代配置里补上 Upgrade 和 Connection 两个头即可。
告警一直误报怎么办?
把「重试次数」调到 2 或 3,检测间隔从 60 秒放宽到 120 秒。另外确认监控项的超时时间不要设得太短,跨境访问本身就有波动。
它能监控多少条?会不会很吃资源?
几百条监控在一个 1 核 1G 的机器上跑压力不大,真正吃资源的是你自己设的检测频率。默认 60 秒一次、重试 2 次是比较平衡的设置,不建议无脑调到 10 秒。
相关推荐:
📦 附:夸克网盘资源库 · 持续更新
我做资源库的标准很苛刻:分类清晰、链接有效、持续更新——这份夸克网盘资源导航表三点都占:直到这篇发布前都还在更新,失效链接会被及时清理,新资源持续入库,找资源不用再到处碰运气。
- 📚 资源库入口:夸克网盘资源导航表(在线表格,收藏即用)
- 💾 建议先收藏本文或保存表格,需要时随时回来取用;表格会持续更新,值得定期逛一逛。
- 📢 觉得有用,欢迎转载分享给需要的朋友(转载注明出处即可)。





