SiteGlance
全部文章

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 Key。

  1. 在 Umami Cloud 里点侧边栏的头像，打开「Settings → API keys」。
  2. 点「Create key」并复制。
  3. 在 SiteGlance 里添加连接，选 Umami Cloud，粘贴这个 Key。
App 发出的请求（供参考）
GET https://api.umami.is/v1/websites
Authorization: Bearer <你的 API Key>

自建：地址、账号、密码

连你自己的实例时，SiteGlance 用你登录后台的同一套账号密码登录，换取一个会话令牌，和网页登录完全一样。

  • 只支持 HTTPS。 不接受明文 http:// 地址。实例没有证书的话，先用反向代理配上。
  • 填 Umami 实际所在的地址。 如果 Umami 部署在子路径下，比如 https://example.com/umami，要把路径带上。
  • 账号要有读取权限，能看到你想看的网站。
SiteGlance 添加连接页面，可选自建或 Umami Cloud
添加连接：选择自建或 Umami Cloud。

连接多个实例与无缝切换

如果你同时维护自建服务器与 Umami Cloud 上的不同站点，可以在「Settings → Connections → Add connection」中逐一添加。SiteGlance Pro 支持保存多个连接配置，随时一键切换不同实例，各自保持独立的访客数据、实时看板与桌面小组件。

常见连接报错

SiteGlance 保存每条连接前都会先真连一次，并告诉你是哪一步出了问题：

  • 账号或密码不对，服务器没有签发 Token：服务器拒绝了登录。
  • 账号密码正确，但这个账号没有读取权限：能登录，但读不到网站列表。
  • 地址能连通但找不到 Umami 接口：多半是少了路径，或者反向代理没有转发 /api。
  • HTTPS 证书无效：证书过期或是自签名证书。
  • 连不上这个地址或连接超时，服务器没有响应：检查域名拼写和网络。
  • API Key 无效或已撤销：去 Umami Cloud 重新建一个。

连上之后，两种用法在 App 里完全一样，包括桌面小组件。

在 App Store 下载在 Google Play 下载

常见问题

能同时连 Umami Cloud 和自建实例吗？
可以，需要 SiteGlance Pro（可保存多个连接）。免费版保存 1 个。
为什么 http:// 的实例连不上？
SiteGlance 只通过 HTTPS 连接，避免你的凭据以明文传输。请先配好证书，比如通过反向代理。
我的密码存在哪里？
iPhone 上存在 iOS 钥匙串里；Android 上用 Android Keystore 里的密钥加密后保存。SiteGlance 没有服务器，除了你自己的 Umami，不会发往任何地方。

继续阅读