Uptime Kuma 是一款轻量级的开源监控工具,支持 HTTP、TCP、Ping 等多种协议,能实时监测网站、服务器、API 接口的运行状态。它适合个人开发者或中小企业运维人员使用,占用资源少(单实例内存低于 100MB),操作简单且可视化界面直观。
默认情况下,Uptime Kuma 需要在本地网络内访问管理界面。若服务器不在身边,很难及时调整监控参数或查看告警详情。结合内网穿透工具,可以将本地的监控服务暴露到公网,无论身在何处,只要有网络就能登录管理界面,实现全天候监控。
环境准备
本教程以 CentOS 7 为例,任何支持 Docker 的系统均可使用。确保已安装 Docker 引擎,可通过以下命令测试环境是否正常工作:
docker run hello-world
部署监控服务
在服务器上创建安装目录并编写配置文件。路径可根据实际需求修改。
mkdir -p /root/dockertest/kuma
cd /root/dockertest/kuma
touch docker-compose.yml
编辑 docker-compose.yml 文件,写入以下内容:
version: '3.3'
services:
uptime-kuma:
image: louislam/uptime-kuma
container_name: uptime-kuma
volumes:
- /root/dockertest/kuma/data:/app/data
ports:
- 5702:3001
此配置将容器端口 3001 映射到宿主机的 5702 端口,数据持久化保存在 /root/dockertest/kuma/data 目录下。
启动服务:
docker-compose up -d
运行完毕后,执行 docker ps 确认容器状态。浏览器访问 http://服务器 IP:5702,输入用户名密码即可进入管理界面。
在界面中点击左上角添加按钮,配置监控 URL 和名称。系统支持多种通知方式,建议配置邮件或飞书等报警功能,以便及时接收异常信息。
配置公网访问
本地部署的服务默认无法从外网访问。此时需要安装内网穿透工具将本地服务映射至公网。
安装与基础配置
使用一键脚本安装工具:
curl -L https://www.cpolar.com/static/downloads/install-release-cpolar.sh | sudo bash
sudo systemctl enable cpolar
sudo systemctl start cpolar
安装成功后,在外部浏览器访问 Linux 的 9200 端口(即 http://局域网 IP:9200),使用账号登录后进入 Web 配置界面。


