Umami Cloud 和自建 Umami：在 iPhone 上分别怎么连

Umami 有两种用法：Umami 官方托管的 Umami Cloud，和部署在你自己服务器上的自建 Umami。两者都提供 API，SiteGlance 这类手机 App 读的就是它，但登录方式不同。（第一次用？先看怎么在 iPhone 上查看 Umami。）

Umami Cloud：一个 API Key

云端的请求地址是固定的，不用填网址，只需要一个 API Key。

1. 在 Umami Cloud 里点侧边栏的头像，打开「Settings → API keys」。
2. 点「Create key」并复制。
3. 在 SiteGlance 里添加连接，选 Umami Cloud，粘贴这个 Key。

GET https://api.umami.is/v1/websites
Authorization: Bearer <你的 API Key>

自建：地址、账号、密码

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

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

常见连接报错

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

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

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