GitHub Release 下载 TLS 断连 / 超时

你会遇到什么

从 GitHub Release 下载 cc-switch 的 deb/AppImage 反复断连（TLS/连接重置），13.5MB 的包都下不完。你以为是网络问题等重试——国内直连 GitHub release 资产不稳定是常态，用 gh-proxy 前缀加速最省事。

本文路径：快速修复（30 秒一段命令）→ 一步步排查（可跳读）→ 原理与变体（症状/原因/证据）。赶时间直接跳到「快速修复」。

为什么会这样

GitHub Release 资产实际托管在 objects.githubusercontent.com，国内直连不稳定，大文件传输中途断开。GitHub 网页/API 可能能开，但资产下载是另一条链路，表现完全不同。

关键认知是“网页能开 ≠ 下载能通”：GitHub 的网页、API 和 Release 资产分别走不同的域名与 CDN——网页/API 在 github.com，而 Release 大文件实际由 objects.githubusercontent.com 提供，两者链路在墙内表现完全不同。

下载是长连接大流量传输，中途断连时 TLS 握手已经成功过，所以表现为“连上了又断”，而不是“连不上”。

gh-proxy 之所以有效，是因为它把直连换成“国内可通的代理服务器 → 代理服务器与 GitHub 之间走境外链路”，把最脆弱的一段（你到 GitHub 的跨国连接）替换掉。验证下载是否完整也有固定顺序：先 du -h 对照资产页标注大小（大小差太多 = 断了一半），再用 dpkg-deb -I 确认结构可读——大小对 + 结构可读，才算完整。

实测环境：2026-08-28 本市场实测：直连慢（connectivity 记录）；gh-proxy 下载 13.5MB 成功。

一步步来

1. 用 gh-proxy 前缀 — 必做

把资产直链前面加上 https://gh-proxy.com/：

curl -L -o cc-switch.deb "https://gh-proxy.com/https://github.com/<owner>/<repo>/releases/download/<tag>/cc-switch_x86_64.deb"

2. 或换网络/开代理错峰重试 — 必做

校园网/家宽高峰期直连最差，错峰或代理可缓解。

3. 下载后校验 — 必做

du -h cc-switch.deb

对照资产页标注大小（deb 13.5MB / 二进制 31MB），差太多就是断了一半，重新下。

怎么确认修好了

dpkg-deb -I cc-switch.deb >/dev/null && echo DEB-OK

deb 结构可读即下载完整（实测：gh-proxy 下载 13.5MB 成功，结构确认 exit=0）。

其它环境的表现

症状

从 GitHub Release 下载 deb/AppImage 反复断连（TLS/连接重置），13.5MB 的包下不完。

原因

国内直连 GitHub release 资产（objects.githubusercontent.com）不稳定；大文件传输中途断开。

解法

1. gh-proxy 前缀加速：https://gh-proxy.com/https://github.com/<owner>/<repo>/releases/download/<tag>/<asset>（2026-08-28 实测秒级）。
2. 或换网络/开代理错峰重试。
3. 下载后校验：du -h 对照资产页大小（deb 13.5MB / 二进制 31MB）。