Uptime Kuma:自架監控的入門標準
想知自己的網站、API 或家中 server 幾時死了,又不想付月費或把監控數據交去第三方,Uptime Kuma 是目前自架社群最常用的答案。它是一個開源的自架監控工具,以單一容器運行,提供即時儀表板、90 多種通知渠道、公開狀態頁,以及 SSL 憑證到期提示。專案由 Louis Lam 於 2021 年發布,授權為 MIT,官方 GitHub repository 現時有 92,650 stars、8,577 forks(截至 2026-10-20 的 GitHub API 讀數),最新正式版本為 2.5.6(2026-10-09 發布)。
為甚麼值得 HKAIWeb 讀者留意
監控工具的價值不在於功能清單有多長,而在於你真正會在服務出事時收到通知。Uptime Kuma 的定位是「設定五分鐘內完成、出事即刻通知」:用官方 Docker Compose 起一個容器、開 port 3001、建立管理員帳號,加入第一個 HTTP 監察項就完成。它不追求取代 Prometheus/Grafana 那類長期指標與查詢引擎,而是做好「服務是否活著」這一層,兩者可以並存。
功能重點(依官方 README)
- 監察類型:HTTP(s)、HTTP 關鍵字、JSON Query、WebSocket、TCP 埠、Ping、DNS 記錄、Push(適合排程備份任務回報)、Steam 遊戲伺服器、Docker 容器狀態。
- 通知渠道:官方列明 90 多種,包括 Telegram、Discord、Slack、Pushover、Gotify、電郵(SMTP)等,並可在設定頁直接發送測試通知。
- 檢查間隔:最快 20 秒一次。
- 公開狀態頁:可將選定的監察項發布成公開狀態頁,並綁定自訂網域;介面是 WebSocket 驅動,反向代理必須支援 WebSocket,否則會白畫面。
- 憑證到期:HTTP 監察項內建 SSL 憑證資訊與到期提醒。
- 資料自持:監控歷史儲存於本地 SQLite(容器內
/app/data),備份即是複製一個資料夾。 - 2FA 與多語系:支援兩步驗證,介面已翻譯成 30 多種語言。
安裝(官方 Docker Compose 路線)
mkdir uptime-kuma
cd uptime-kuma
curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml
docker compose up -d
啟動後開 http://localhost:3001(或主機 IP),首次進入會引導建立管理員帳號。官方亦提供單行 docker run 版本,及 Node.js 20.4+ 配合 pm2 的非 Docker 安裝路線。
實際限制與注意事項
- NFS 不支援:官方 README 明確警告,NFS 等網絡檔案系統不可作為資料目錄(SQLite 依賴 POSIX 檔案鎖),要映射到本機目錄或 volume。
- Docker 容器監察有權限風險:要監察同主機其他容器,需掛載
/var/run/docker.sock,等同交出 Docker daemon 控制權;官方不建議在使用此監察類型時把 Uptime Kuma 暴露到公網。 - 單機設計,無內建 HA:監控主機離線,監控本身亦一齊離線、不會有通知。實務建議把它放在與受監察服務不同的機器(例如一部便宜 VPS 或備用小型主機),或加一個外部 dead-man 服務補底。
- 不是長期指標平台:如果你的需求是歷史趨勢、儀表板或複雜告警條件,那是 Prometheus + Grafana 的範圍;Uptime Kuma 適合做「是否活著」的第一層。
誰適合用
自架服務的個人或小團隊、管理多個網站/API 的開發者、想用 Telegram 或 Slack 收警報而不想付 SaaS 月費的人。若你已經在跑 Docker,它基本是幾個指令的事;需要多用戶權限、跨區冗餘或長期指標分析,就要另配工具。

圖片來源及授權:本圖為 HKAIWeb 原創繪製(CC BY 4.0),非第三方素材截圖;可自由轉載並註明來源。
來源
- 官方 repository:github.com/louislam/uptime-kuma
- 官方 README(安裝、監察類型、通知渠道、NFS 與 Docker socket 警告):raw.githubusercontent.com/louislam/uptime-kuma/master/README.md
- 官方 release 記錄:github.com/louislam/uptime-kuma/releases
- 項目官網:uptime.kuma.pet
- 業界實測與比較(僅作背景參考,非第一手):selfhostedguides.com、selfhostindex.com、monitoringdaddy.com、flyingtechman.com