關於 Uptime Kuma
Uptime Kuma 是由開發者 Louis Lam 發起的開源監控工具,如今已是 GitHub 上獲得最多星星的自架專案之一。它負責檢查各項服務是否有回應:透過 HTTP(S) 的網站、頁面上的關鍵字、TCP 連接埠、ping、DNS 記錄、資料庫等。
檢查失敗時,它會透過數十種支援的管道之一傳送通知,包括 Telegram、Discord、Slack、電子郵件與 Webhook。它也會記錄回應時間、在 TLS 憑證到期前提醒,並讓您為客戶建立公開狀態頁面。
大家選擇自行架設,是因為它輕巧、免費,介面簡潔,幾分鐘就能設定完成。關鍵在於要放在獨立的伺服器上:與網站位於同一台機器的監控工具,無法在那台機器當機時通知您。
常見用途
網站當機時發出警示
每分鐘檢查您的網站與 API,一旦停止回應,立即透過 Telegram 或電子郵件通知您。
憑證到期提醒
在 HTTPS 憑證到期前幾天就收到提醒,不必等客戶告訴您。
公開狀態頁面
在由您掌控的頁面上,向客戶展示服務的即時狀態。
訂購之後
伺服器首次啟動時會安裝 Uptime Kuma,並在防火牆開放 3001 連接埠,監控工具網址為 http://your-server-address:3001/。第一次造訪時需建立管理員帳號,因此伺服器就緒後請立即開啟該網址。接著新增第一個監控項目,並連接通知管道。
該在哪裡執行
Uptime Kuma 從其執行的位置進行檢查。若監控工具與受監控的服務位於同一台伺服器,會隨之一起當機而無法警示您,因此請將它放在與受監控對象不同的伺服器上。
為 Uptime Kuma 設定自有網域與 HTTPS
Uptime Kuma 預設透過伺服器 IP 位址以一般 HTTP 回應。若要使用 status.example.com 這類名稱並搭配憑證,請在 DNS 中為該名稱建立指向伺服器 IPv4 位址的 A 記錄,再於前端架設 Caddy:Caddy 會自動取得免費的 Let's Encrypt 憑證並自動續期。以下指令適用於我們應用程式伺服器所使用的 Ubuntu 24.04。
請在控制台中於伺服器防火牆開放 TCP 80 與 443 連接埠:Caddy 需要這兩個連接埠來取得 Let's Encrypt 憑證並提供網站服務。
apt install -y caddy
cat > /etc/caddy/Caddyfile <<'EOF'
status.example.com {
reverse_proxy 127.0.0.1:3001
}
EOF
systemctl reload caddy前端設定網域後,即可將 Uptime Kuma 的狀態頁面分享給客戶:建立狀態頁面、選擇要顯示的監控項目,然後提供 https://status.example.com/status/your-page。您也可以在狀態頁面的設定中直接為其綁定網域。
網域生效後,就不再需要直接使用 3001 連接埠:在 /opt/uptime-kuma/compose.yml 中將 "3001:…" 改為 "127.0.0.1:3001:…",執行 docker compose up -d,並從防火牆移除 3001 連接埠。之後 Uptime Kuma 只能透過 HTTPS 存取。
更新 Uptime Kuma
/opt/uptime-kuma/compose.yml 中的映像檔固定為特定版本,因此單純執行 docker compose pull 只會再次取得相同版本。若要更新,請將 image: 行中的版本改為您要的版本(請先閱讀版本說明),然後拉取並重新建立容器。資料存放在 Docker 磁碟區中,會完整保留。
cd /opt/uptime-kuma
nano compose.yml # the new version in the image: line
docker compose pull
docker compose up -d備份 Uptime Kuma
您可以在控制台中開啟整台伺服器的每日備份(方案價格 +20%,保留最近 7 份),並從任一份備份還原伺服器。另外保留一份應用程式資料的檔案副本仍然值得:它可以搬移到其他伺服器,或在不回復其他所有內容的情況下單獨還原。
監控項目、通知設定與檢查記錄都存放在 uptime-kuma_uptime_kuma 磁碟區(/app/data)中。請暫時停止應用程式,讓資料庫檔案以一致的狀態複製:
cd /opt/uptime-kuma && docker compose stop
docker run --rm -v uptime-kuma_uptime_kuma:/data -v /root:/backup alpine \
tar czf /backup/uptime-kuma-$(date +%F).tgz -C /data .
docker compose start運作方式
- 在伺服器訂購頁面選擇 Uptime Kuma,並挑選記憶體足夠的方案。
- 應用程式會在伺服器首次開機時安裝,通常只需幾分鐘。
- 在控制台開啟伺服器:網址與登入資料都在那裡。