无法访问 github.com — 登录和加载都走不通时

现象

打开 Gloom 后卡在加载中、登录失败、或者仓库页面一直转圈——这是 Gloom 最常见的问题。90% 的根因是手机无法访问 github.com。

排查顺序

第一步：确认浏览器能打开 github.com

这是最快的验证方法：打开手机自带浏览器（或 Chrome），输入 https://github.com，看能不能正常加载。

• 能打开：说明 GitHub 本身没问题，继续往下排
• 打不开，显示连接超时/无法解析/网络错误：是网络问题，不是 Gloom 的问题

第二步：如果浏览器也打不开 github.com

几个常见原因：

1. 你当前的网络环境限制了境外访问：公司 Wi-Fi、校园网、某些运营商的移动网络可能屏蔽了 GitHub 的访问。换一个网络试试（手机开飞行模式切到另一张卡的流量）
2. 代理/VPN 没开或配置不当：如果你平时用代理/VPN 才能访问 GitHub，确认代理软件正在运行且 Android 版本兼容（Android 7+ 支持 system-level VPN）
3. DNS 问题：尝试在 Wi-Fi 设置里手动设 DNS 为 8.8.8.8（Google DNS）或 1.1.1.1（Cloudflare DNS）
4. GitHub 服务端故障：极少见，但确实可能。打开 https://www.githubstatus.com 查实时状态

第三步：浏览器能打开但 Gloom 不行

这种情况极少见，但确实可能：

• Gloom 的网络权限没开：设置 → 应用 → Gloom → 权限 → 网络/互联网 → 确认允许
• 系统防火墙或安全软件：某些手机的安全中心会给未上架应用（Gloom 不走 Play Store）限制网络访问。暂时关掉试试
• 代理软件只给浏览器开了代理、没给 Gloom 开：如果用的是应用级代理，在代理软件的应用列表里确认 Gloom 也在代理范围内

Gloom 的网络架构

Gloom 直接通过 GitHub REST API（api.github.com）和 User Events API 拉数据——不走中间服务器、不做缓存中转、不经过 MateriiApps 自己的服务。这意味着：

• 没有网络时，Gloom 没有任何可用的离线数据
• 代理/VPN 需要同时代理 api.github.com（这是 Gloom 实际访问的 API 端点）
• GitHub API 的速率限制（每小时 5000 次，认证态）在 Gloom 里同样适用

长期方案

如果你所在的网络环境长期无法直接访问 GitHub：

• 用代理：找稳定的 Android 代理方案（Shadowsocks/V2Ray 等），同时支持浏览器和 Gloom
• 定期同步：在能联网时打开 Gloom 刷新一次，看需要的内容；Gloom 不做缓存，但每次打开都会重新拉最新数据
• 回电脑端：Gloom 的定位本来就是「碎片时间阅读器」，主力还是在电脑端 GitHub 网页版

GitHub Status 页面

实时状态：https://www.githubstatus.com历史事件和维护公告：https://www.githubstatus.com/incidents

如果 GitHub 那边在维护或故障，Gloom 这边一定会受影响——这不是你的设置有问题，等 GitHub 恢复就行。