Termius 登录失败与同步问题排查 | 防火墙、HTTP/2、grpc 域名
登录 / 同步失败的常见原因
Termius 登录和同步依赖两个云服务端点：
- api.termius.com：REST API（登录、Vaults 管理）
- grpc.termius.com：gRPC API（Vaults 数据同步，要求 HTTP/2）
如果登录失败或同步不工作，90% 的情况是这两个域名被防火墙拦了。
排查步骤
第一步：检查网络能不能到这两个域名
命令行测试：
# 测试 DNS 解析
nslookup api.termius.com
nslookup grpc.termius.com
# 测试 443 端口连通
nc -zv api.termius.com 443
nc -zv grpc.termius.com 443
# 测试 HTTP/2（curl 7.33+ 支持）
curl -I --http2 https://grpc.termius.com/
# 应该返回 HTTP/2 200 或类似如果 DNS 解析失败或 443 端口超时：检查防火墙。
第二步：防火墙放行
Termius 官方文档列出了需要放行的域名清单（可能不全，建议全部放行）：
| 域名 | 端口 | 用途 |
|---|---|---|
| api.termius.com | 443 | 登录、Vaults 管理 API |
| grpc.termius.com | 443 | Vaults 数据同步（必须 HTTP/2） |
| 其他 CDN / 更新域名 | 443 | 应用更新、图片资源 |
Windows Defender
设置 → Windows 安全中心 → 防火墙 → 允许应用通过防火墙 → 勾选 Termius。
macOS
系统设置 → 网络 → 防火墙 → 允许 Termius 的入站和出站连接。
Linux（iptables / ufw）
# ufw
sudo ufw allow out on 443
sudo ufw allow in on 443
# 或更精确地只允许 Termius 进程
# 用防火墙工具允许 Termius 二进制文件的 443 端口连接公司出口防火墙
很多公司有严格的出口防火墙（检查 SSL 证书、拦截特定域名）：
- 找公司 IT 把 api.termius.com 和 grpc.termius.com 加进白名单
- 如果有 SSL 中间解密（MITM），需要把 Termius 的 CA 证书加进公司信任链
第三步：HTTP/2 检查
grpc.termius.com 强制要求 HTTP/2。如果公司防火墙做了 HTTP/1.1 强制降级或拦截 HTTP/2：
- Termius 会同步失败（登录可能还能工作，因为登录走 REST）
- curl 测试返回 HTTP/1.1 而不是 HTTP/2 → 需要修防火墙配置
第四步：VPN / 代理冲突
如果你用系统级代理或 VPN：
- 临时关掉 VPN / 代理试试 Termius 能不能登录
- 某些 VPN 对 gRPC 协议支持不好
- Termius 的同步流量走 HTTPS（443），理论上应该能穿透代理
第五步：Termius 状态页面
官方有状态页面可以检查 Termius 云服务是否出故障：
- 搜索「Termius status」或在 Termius 官方社区看公告
- 如果是 Termius 服务端问题，只能等官方恢复
其他登录失败原因
加密密码输入错误
加密密码输入错误的表现：
- 登录成功但 Vaults 数据一片空白或显示加载中
- 反复提示输入加密密码
- 同步状态显示错误
注意区分：
- Termius 登录密码错 → 登录失败
- 加密密码错 → 登录成功但数据解不开
加密密码错了没别的办法——输入正确的那个。如果真的忘了，参考「加密密码忘了怎么办」。
Google OAuth 登录问题
- 确认用 Google 登录的那个账号和你 Termius 绑定的是同一个 Google 账号
- 如果 Google 2FA 开启了，要先通过 Google 的验证再回 Termius
- 某些公司 Gmail 域可能限制第三方 OAuth 应用（IT 管理员的策略）
账号被锁定
多次输入错误密码 → Termius 可能临时锁定账号（防暴力破解）：
- 等 15~30 分钟再试
- 或通过邮箱重置登录密码后再登录
同步失败但登录成功
登录正常但 Vaults 数据不同步：
检查同步状态
Termius 界面顶部或底部有同步状态指示器：
- ✅ 绿色：已同步
- ⏳ 转圈：正在同步
- ❌ 红色叉：同步失败
常见原因
- 网络中间设备拦了 grpc.termius.com → 放行
- Vaults 数据损坏 → 尝试 Reset Cache（设置 → Troubleshooting → Clear Vaults Cache，会重新从云端拉数据）
- 网络暂时断了 → 自动重连，等几秒
- Pro 试用期过期降级 → Starter 不支持云同步，升级 Pro 后恢复
同步超时了吗
Termius 同步默认有超时时间（比如 30 秒）。如果网络延迟特别高（比如跨洋），可能需要在设置里调大超时时间。
iOS / Android 登录问题
移动端登录可能还有额外因素：
- iOS： 确认本地网络权限已开启（系统设置 → Termius → 本地网络）
- Android： 某些 ROM 会杀后台服务，导致登录后被强制退出
- 移动网络切换： Wi-Fi 换 4G 时登录可能失败，建议切到稳定网络再试
提交支持请求
如果上述都试过还不行，可以在 Termius 官方 Support Portal 提交请求：
- 提供：操作系统、Termius 版本、同步状态截图、错误日志（设置 → 导出诊断日志）
- 描述清楚：具体现象、什么操作后出现、试过哪些方法、是一台设备还是所有设备
Termius 官方响应速度一般（非紧急问题 1~3 个工作日），但确实会回复。