Umami Cloud 與自建 Umami：如何在手機儀表板中同時連線
發布於 2026年9月24日 · 閱讀約需 2 分鐘 · Yichen Lab
可以在同一個手機分析儀表板裡同時連線自建 Umami 和 Umami Cloud 嗎？完全可以。 使用像 SiteGlance 這樣的原生行動用戶端，您可以在 iPhone 與 Android 上同時監控自建伺服器與 Umami Cloud。兩者底層提供相同的 API 介面，但登入驗證機制不同：Cloud 使用 API Key，而自建則需透過 HTTPS 帳號密碼進行安全驗證。（初次使用？請先參閱如何在 iPhone 上查看 Umami或在 Android 上查看 Umami。）
Umami Cloud：以 API Key 快速連線
雲端服務的 API 請求位址固定，無需手動輸入網址，只需準備好一組專屬的 API Key。
- 在 Umami Cloud 點選左側選單的個人頭像，開啟「Settings → API keys」。
- 點選「Create key」並複製產生的金鑰代碼。
- 在 SiteGlance 點選新增連線，選擇 Umami Cloud，並貼入此金鑰。
GET https://api.umami.is/v1/websites
Authorization: Bearer <您的 API Key>自建伺服器：位址、帳號與密碼
連線您自行架設的 Umami 時，SiteGlance 使用您登入網頁後台的同一組帳號密碼，換取會話權限憑證（Session Token），底層流程與瀏覽器登入完全相同。
- 僅支援 HTTPS 安全連線。 系統不接受明文
http://傳輸。若伺服器尚未配置憑證，請先透過反向代理完成 SSL/TLS 設定。 - 填入 Umami 實際部署的完整路徑。 若 Umami 架設於子路徑下（例如
https://example.com/umami），請務必完整輸入路徑。 - 該帳號需具備網站讀取權限，方能查閱您所追蹤的站點數據。
多組執行個體連線與隨時切換
若您同時維護自建伺服器以及 Umami Cloud 上的多個專案，可於「設定 → 連線管理 → 新增連線」中依序綁定。SiteGlance Pro 支援保存多組連線設定，點選一下即可無縫切換不同伺服器，各自保有獨立的訪客指標、即時看板與桌面小工具。
常見連線問題排查
SiteGlance 在保存連線前均會進行實際的通訊測試，並明確告知在哪個環節遭遇阻礙：
- 帳號或密碼錯誤，伺服器拒絕核發憑證：伺服器拒絕了登入請求。
- 帳密正確，但此帳號缺乏網站檢視權限：能通過身分驗證，但無權讀取站點清單。
- 主機連線正常但未發現 Umami API 介面：多半是子路徑輸入不完整，或反向代理未轉發
/api請求。 - HTTPS 憑證無效：憑證已過期，或使用了不受信任的自簽署憑證。
- 無法連線至此位址或伺服器回應超時：請檢查網域名稱拼寫與目前行動網路連線狀態。
- API Key 無效或已撤銷：請前往 Umami Cloud 後台重新產生命名金鑰。
成功連線後，兩種部署形式在 App 內呈現完全一致的流暢體驗，包含主畫面小工具。
常見問答
- 能同時連線 Umami Cloud 與自建伺服器嗎？
- 可以，只需升級 SiteGlance Pro 即可保存並管理多組連線。免費版本支援 1 組連線。
- 為什麼不支援 http:// 明文連線？
- SiteGlance 嚴格遵循資訊安全規範，僅透過 HTTPS 安全加密連線，杜絕密碼與金鑰明文外洩。請先為伺服器配置證書（例如使用 Nginx 或 Caddy 反向代理）。
- 我的連線密碼儲存在哪裡？
- iPhone 上妥善存放在 iOS 鑰匙圈中；Android 則採用 Android Keystore 產生的專屬密鑰進行加密儲存。SiteGlance 沒有自己的伺服器，密碼絕不發往您專屬 Umami 以外的任何地方。