Uptime Kuma 上手指南：3 步跑通你的第一套自托管监控

Uptime Kuma 上手指南3 步跑通你的第一套自托管监控【免费下载链接】uptime-kumaA fancy self-hosted monitoring tool项目地址: https://gitcode.com/GitHub_Trending/up/uptime-kuma先认识它Uptime Kuma 替你解决什么问题Uptime Kuma 是一套自托管监控工具它按你设定的间隔反复探测目标HTTP 网站、TCP 端口、Ping、DNS、Redis 等 30 多种类型发现宕机就通过 Telegram、Slack、企业微信等上百种渠道推送通知同时提供可分享的公开状态页。它适合个人博客、内部工具、游戏服务器的维护者和 Zabbix 这类企业级平台最大的区别是零外部依赖——装完就能用不用额外部署存储和采集组件。本文带你从 clone 仓库走到浏览器里看到监控面板。仓库里有什么只看这 6 个跑得动它的路径别被几百个文件吓到真正决定能不能跑起来的目录很少其余都是多语言翻译和通知渠道实现。后端server/路径一句话说明它负责什么server/server.js启动入口加载配置、初始化数据库并拉起监控循环想改启动行为才看它server/config.js解析端口、监听地址、SSL 证书等启动参数配置自定义端口或 HTTPS 时才需要动它db/knex_migrations/数据库结构迁移脚本首次启动自动执行新增字段或换数据库时才用得上前端src/路径一句话说明它负责什么src/main.jsVue 应用入口日常使用完全不用碰config/vite.config.jsVite前端构建工具配置开发态前端跑在 3000 端口改构建产物或端口时才动它容器化路径一句话说明它负责什么compose.yamlDocker 一键启动定义含端口映射和数据目录挂载用容器方式部署时只需要它怎么在本地把 Uptime Kuma 跑起来最小路径方式 A源码模式Node.js克隆仓库到本地git clone https://gitcode.com/GitHub_Trending/up/uptime-kuma cd uptime-kuma到这里你应该看到server/、src/、config/三个目录。安装依赖需要 Node.js ≥ 20.4版本低了会直接报错npm install到这里你应该看到命令正常结束目录里多了node_modules/。开发模式一键启动后端3001 端口和前端3000 端口会同时拉起npm run dev到这里你应该能在浏览器打开http://localhost:3000看到初始化设置页。在设置页创建管理员账号和密码回到面板点添加新监控选 HTTP 类型填入你要监控的地址。到这里你应该看到心跳即一次探测结果打点、状态变绿说明第一套自托管监控已经在工作。方式 BDocker 模式最省事docker compose up -d到这里你应该能访问http://localhost:3001所有数据自动落在./data目录。改什么才有用Uptime Kuma 最值得动的配置UPTIME_KUMA_PORT也支持--port参数— 默认 3001 — 端口被占用或反代映射时改它UPTIME_KUMA_HOST— 默认监听所有网卡 — 只想绑内网特定 IP 时设置UPTIME_KUMA_SSL_KEY/UPTIME_KUMA_SSL_CERT— 默认空走 HTTP— 没有反代、想直接上 HTTPS 时设置interval每个监控的检查间隔在面板监控编辑页设置— 默认 30 秒 — 需要更灵敏的探测频率时改小./data数据目录 — 存放 SQLite 库kuma.db和截图 — 做备份、迁移机器时关注# 启动示例自定义端口 直接启用 HTTPS UPTIME_KUMA_PORT8080 \ UPTIME_KUMA_SSL_KEY/certs/key.pem \ UPTIME_KUMA_SSL_CERT/certs/cert.pem \ node server/server.js跑起来之后下一步去哪想看后端怎么串起来的从入口 server/server.js 顺着读 server/socket-handlers/ 里的处理器想加新的监控类型照抄 server/monitor-types/ 里任意一个现成实现改想理解数据结构每次库变更都在 db/knex_migrations/ 有一个独立脚本【免费下载链接】uptime-kumaA fancy self-hosted monitoring tool项目地址: https://gitcode.com/GitHub_Trending/up/uptime-kuma创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考