Uptime Kuma 自架監控架構示意圖(HKAIWeb 原創)

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,它基本是幾個指令的事;需要多用戶權限、跨區冗餘或長期指標分析,就要另配工具。

Uptime Kuma 自架監控架構示意圖:監察對象(HTTP、關鍵字、TCP、Ping/DNS、Push、Docker 容器、SSL)經 Uptime Kuma 容器(port 3001、SQLite /app/data)輸出通知渠道與公開狀態頁
Uptime Kuma 自架監控架構示意圖。圖片由 HKAIWeb 原創繪製,依 CC BY 4.0 授權;架構細節依官方 README 及 release 2.5.6 描述整理。

圖片來源及授權:本圖為 HKAIWeb 原創繪製(CC BY 4.0),非第三方素材截圖;可自由轉載並註明來源。

來源

作者: hkaiweb

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *

Social Media Auto Publish Powered By : XYZScripts.com