raw.githubusercontent.com 无法访问的修复方法

很多安装脚本、配置文件、AI 模型清单都托管在 raw.githubusercontent.com。这个域名在国内特别容易被污染,表现为:

• 浏览器打开 raw 链接一直转圈或超时;
• curl / wget 下载脚本卡住或报 Connection reset;
• 一键安装脚本(curl ... | bash)执行失败。

原因是 raw.githubusercontent.com 走的是 Fastly CDN,其 IP 极易被 DNS 污染。下面按推荐顺序给方案。

方法一:用 jsDelivr CDN 代理(最推荐)

jsDelivr 提供了 GitHub 仓库的公共镜像,把 raw 链接换成 jsDelivr 链接即可:

# 原 raw 链接
https://raw.githubusercontent.com/用户/仓库/分支/路径/file.sh

# 换成 jsDelivr(注意 @分支)
https://cdn.jsdelivr.net/gh/用户/仓库@分支/路径/file.sh

实际例子:

# 原始
https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh

# 加速后
https://cdn.jsdelivr.net/gh/ohmyzsh/ohmyzsh@master/tools/install.sh

用在一键脚本里:

sh -c "$(curl -fsSL https://cdn.jsdelivr.net/gh/用户/仓库@分支/install.sh)"

优点:全球 CDN,稳定快速,无需本地配置。 缺点:jsDelivr 有缓存,刚推送的文件可能有几分钟延迟;单文件有大小限制,不适合超大文件。

方法二:其他 raw 加速代理前缀

一些公共加速服务支持直接在 raw 链接前拼前缀:

https://<加速代理域名>/https://raw.githubusercontent.com/用户/仓库/分支/file.sh

搜索"raw.githubusercontent 加速"获取当前可用的代理域名。注意:公共代理可能失效,勿传输敏感内容。

方法三:修改 Hosts

给 raw.githubusercontent.com 手动指定可用 IP:

185.199.108.133  raw.githubusercontent.com
185.199.109.133  raw.githubusercontent.com
185.199.110.133  raw.githubusercontent.com
185.199.111.133  raw.githubusercontent.com

写入 hosts 后刷新 DNS 缓存:

# Windows
ipconfig /flushdns
# macOS
sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder

TIP

上面这几个是 GitHub Pages / raw 常用的 Fastly IP,但会变动。自动维护 hosts 的方法见 Hosts 加速专文。

方法四:命令行走代理

如果本机已有代理,让 curl 临时走代理:

# 单次
curl -x http://127.0.0.1:7890 -fsSL https://raw.githubusercontent.com/用户/仓库/分支/file.sh

# 或用环境变量(对该终端会话内所有命令生效)
export https_proxy=http://127.0.0.1:7890
export http_proxy=http://127.0.0.1:7890

Windows PowerShell:

$env:HTTPS_PROXY = "http://127.0.0.1:7890"

方法对比

方法	难度	稳定性	适合
一、jsDelivr	⭐	高	绝大多数场景(首选)
二、加速代理前缀	⭐	中	临时下载
三、Hosts	⭐⭐	中	无代理环境
四、命令行代理	⭐⭐	高	已有代理、批量脚本

小结

• 首选 jsDelivr:改个链接就好,最省心。
• 一键安装脚本里,把内部所有 raw 链接一并替换,避免脚本跑到一半又卡住。
• 长期使用建议直接配 代理,一劳永逸。

---

本文仅供技术学习与研究,请遵守所在国家/地区法律法规。