ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

想知道服务有没有挂?用 Uptime Kuma 搭一套7x24小时自托管监控系统

2026/9/5 4:58:59 拓冰建站 浏览量
想知道服务有没有挂?用 Uptime Kuma 搭一套7x24小时自托管监控系统 前言对长期运行的网站、API、数据库和家庭服务器来说真正值得关注的并不只是“现在能不能打开”而是服务是否持续在线、响应是否正常以及异常发生时能不能第一时间发现。这也是可用性监控存在的意义。相比等用户反馈“网站打不开了”、等接口报错以后再去排查Uptime Kuma 更适合承担日常的自动巡检工作。它可以定时检测 HTTP/HTTPS 服务、TCP 端口、Ping、DNS 等目标并记录响应时间和历史状态对于网站服务还可以继续关注 SSL 证书有效期。监控项一旦异常再配合邮件、Webhook、飞书、钉钉等通知方式就能把“人工检查”变成持续自动监控。这篇文章会以极空间为部署环境通过 Docker 运行 Uptime Kuma完成管理员初始化并实际配置网站、SSL 证书以及 TCP 端口监控让整套监控流程先在局域网内跑通。之后还会通过cpolar把 Uptime Kuma 的3005端口增加公网入口并进一步配置固定二级子域名。这样无论监控目标部署在家里还是其他服务器上都可以通过一个统一页面查看状态。对于长期运行的服务来说监控真正提供的不是“保证永远不宕机”而是让异常发生以后不再只能等别人来告诉你。1.什么是Uptime KumaUptime Kuma是一款开源、轻量级、功能强大的 自托管服务监控工具专为开发者、运维人员和中小型企业设计用于实时监测网站、API、数据库、端口、Ping响应等各类在线服务的可用性与响应状态。核心特点1.开源免费 自托管Uptime Kuma完全开源基于 MIT 协议代码托管在 GitHub 上用户可自行部署在私有服务器或云主机上无需依赖第三方SaaS服务保障数据隐私与控制权。2.极简部署支持通过Docker一键部署也提供原生Node.js安装方式。资源占用低普通VPS如1核2G即可流畅运行。3.多协议监控支持HTTP / HTTPS支持自定义请求头、状态码校验TCP / UDP 端口PingICMPDNS 查询Docker 容器状态Steam 游戏服务器gRPC、MySQL、PostgreSQL、Redis 等部分通过插件或扩展4.可视化仪表盘提供美观直观的Web界面实时展示各监控项的状态 正常 / 故障、响应时间趋势图、历史事件日志等。5.丰富的通知渠道90 种一旦服务异常或恢复可自动推送告警到邮件SMTP钉钉、飞书、企业微信Telegram、Discord、SlackWebhook对接自研系统Gotify、Pushover、Home Assistant甚至可通过 Shell 脚本触发本地操作6.高可用与安全支持 HTTPS可集成 Let’s Encrypt、用户认证、多用户管理基础权限控制适合团队协作使用。7.活跃社区 持续更新截至 2026 年Uptime Kuma 在 GitHub 上已获得超过 80,000 颗星标拥有庞大的全球用户社区更新频繁插件生态不断丰富。典型应用场景监控个人博客、电商网站是否宕机检测 API 接口是否超时或返回错误跟踪 SSL 证书有效期避免过期导致访问中断监控内网服务配合反向代理或隧道游戏服务器在线状态提醒一句话总结Uptime Kuma就像你数字世界的“哨兵”7×24小时不眠不休地守护你的服务让你安心睡觉、放心度假——因为一切异常它都会第一时间告诉你。如果你厌倦了商业监控工具的高昂费用或功能限制Uptime Kuma无疑是2026年最值得尝试的开源替代方案。2.前提条件2.1ssh远程连接到极空间开启【SSH 服务】使用终端Windows PowerShell / Mac Terminal登录sshrootIP没有ssh的小伙伴可以参考这篇文章连接成功极空间别再吃灰了开启SSH秒变全能服务器 - cpolar 极点云官网2.2验证docker是否开启使用命令docker-vsystemctl status-v没有docker的小伙伴可以参考这篇文章极空间开箱实录从拆箱到远程访问保姆级教程30分钟上手 - cpolar 极点云官网3.部署Uptime Kuma3.1 Docker Compose部署首先创建一下安装的目录并进入到该目录mkdir-p/docker/Uptime Kumachmod-R777/Uptime Kuma创建并编辑docker-compose.yml文件vidocker-compose.ymlversion:3.8services: uptime-kuma: image: louislam/uptime-kuma:2 container_name: uptime-kuma restart: unless-stopped ports: -3005:3001volumes: - ./data:/app/data environment: -TZAsia/Shanghai启动容器docker-composeup-d3.2 docker一键部署执行docker一键部署命令dockerrun-d--restartalways-p3005:3001-vuptime-kuma:/app/data--nameuptime-kuma louislam/uptime-kuma:1部署完成后在浏览器中输入http://极空间IP:3005就能看到Uptime Kuma的界面4.使用Uptime Kuma4.1 基础使用常用管理命令# 查看容器状态dockerps|grepuptime-kuma# 查看日志dockerlogs-fuptime-kuma# 停止容器dockerstop uptime-kuma# 启动容器dockerstart uptime-kuma# 重启容器dockerrestart uptime-kuma# 删除容器数据不会丢失dockerrm-fuptime-kuma创建用户名密码登录成功4.2 监控Web服务与SSL证书过期我们这里添加一下监控网站试试我们这里监控cpolar点击左上角 “ 添加监控项”。监控类型选择 HTTP(s)。URL 填入你的网址例如 https://www.cpolar.com。高级设置中勾选 “证书过期提醒”。设置剩余天数例如 7 天这样证书快过期时你会收到报警。心跳间隔建议设置为 60 秒。监控成功4.3 监控TCP端口Redis/MySQL有时候Web服务是好的但数据库挂了。我们可以通过TCP端口探测来监控中间件。监控类型选择TCP Port。Hostname填入数据库服务器 IP。Port填入3306(MySQL) 或6379(Redis)。参考如下配置成功在远程监控和保障服务高可用性的场景中Uptime Kuma作为一款开源的监控工具能够实时检测服务器、网站或应用的运行状态并通过多种通知渠道及时告警。然而当被监控的服务部署在内网环境中如家庭服务器、本地开发环境或企业私有网络时Uptime Kuma通常无法直接访问这些私有地址。此时cpolar的内网穿透能力便成为关键桥梁——通过将内网服务安全地暴露到公网cpolar使得Uptime Kuma能够无缝监控原本不可达的本地资源无需复杂网络配置或公网IP。这种结合不仅提升了监控覆盖范围也极大简化了私有服务的可观察性架构尤其适合个人开发者、中小团队或边缘部署场景。5.安装cpolar实现随时随地开发5.1 什么是cpolarcpolar是一款安全高效的内网穿透工具无需公网IP或复杂配置只需一条命令即可将本地服务器、Web服务或任意端口映射到公网让你随时随地远程访问内网应用特别适合开发调试、远程运维和应急部署等场景。5.2 部署cpolarcpolar 可以将你本地电脑中的服务如 SSH、Web、数据库映射到公网。即使你在家里或外出时也可以通过公网地址连接回本地运行的开发环境。❤️以下是安装cpolar步骤使用一键脚本安装命令sudocurlhttps://get.cpolar.sh|sh安装完成后执行下方命令查看cpolar服务状态如图所示即为正常启动sudosystemctl status cpolarCpolar安装和成功启动服务后在浏览器上输入虚拟机主机IP加9200端口即:【http://ip:9200】访问Cpolar管理界面使用Cpolar官网注册的账号登录,登录后即可看到cpolar web 配置界面,接下来在web 界面配置即可打开浏览器访问本地9200端口使用cpolar账户密码登录即可,登录后即可对隧道进行管理。6.配置公网地址登录cpolar web UI管理界面后,点击左侧仪表盘的隧道管理——创建隧道隧道名称可自定义本例使用了:Uptime-Kuma注意不要与已有的隧道名称重复协议http本地地址3005域名类型随机域名地区选择China Top创建成功后打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了公网地址接下来就可以在其他电脑或者移动端设备异地)上使用地址访问。访问成功。7.保留固定公网地址使用cpolar为其配置二级子域名该地址为固定地址不会随机变化。点击左侧的预留选择保留二级子域名地区选择china Top然后设置一个二级子域名名称我使用的是Uptime-Kuma大家可以自定义。填写备注信息点击保留。登录cpolar web UI管理界面点击左侧仪表盘的隧道管理——隧道列表找到所要配置的隧道点击右侧的编辑。修改隧道信息将保留成功的二级子域名配置到隧道中域名类型选择二级子域名Sub Domain填写保留成功的二级子域名地区: China Top点击更新最后我们使用固定的公网地址在任意设备的浏览器中访问可以看到成功访问的页面这样一个永久不会变化的二级子域名公网网址即设置好了。访问成功总结Uptime Kuma 更适合解决的是“服务是否可用”这一类问题。网站能否正常响应、某个 TCP 端口是否还在线、SSL 证书是否临近过期这些状态都可以由它持续探测并保留下来。相比偶尔手动打开网页确认一次自动监控更容易发现短暂中断、持续故障以及长期变化。它和前面常见的系统性能监控工具也不是完全一回事。CPU、内存、磁盘负载属于“机器运行得怎么样”而 Uptime Kuma 更关心的是“服务最终还能不能访问”。因此实际使用中两类监控并不冲突一类观察主机内部状态一类站在使用者角度检查服务是否真正可用。通过 cpolar 给 Uptime Kuma 增加远程入口以后人不在设备旁边也能继续查看监控结果如果还有内网服务需要被外部监控也可以根据实际网络结构补充相应的可达路径。当然监控平台本身同样包含服务地址、历史状态等信息开放公网后应该设置好管理员密码和访问权限。所以部署 Uptime Kuma 的意义并不是让服务器从此“不会宕机”。而是建立一套更可靠的发现机制服务可以出问题但你应该尽可能比用户更早知道。