跳转到内容

网络代理

提供访问外部网站的代理服务,分为 GitHub 专用代理和通用代理。


一、GitHub 专用加速模式(无需授权)

该模式专为 GitHub 及其关联域名设计,无需任何密钥,直接通过特定路径前缀即可代理请求。

可用前缀

前缀功能
/gh/普通代理,直接返回原始内容(不重写页面)
/gh_fix/智能代理,自动重写 HTML 中的链接、资源路径,解决样式丢失问题

使用方式

  1. 方法一: 将你要访问的 GitHub 原始 URL 前面添加 (下载文件时推荐): https://api.undz.cn/gh/ 或者 (访问GitHub网页时推荐) https://api.undz.cn/gh_fix/

  2. 方法二: 将你要访问的 GitHub 原始 URL 转换为以下格式: https://api.undz.cn/gh/[类型]/[剩余路径] 其中 [类型] 支持以下简写(自动映射到真实的 GitHub 域名):

简写对应域名说明
wwwgithub.comGitHub 主站
rawraw.githubusercontent.com原始文件下载
gistgist.github.comGist 代码片段
apiapi.github.comGitHub API
iogithub.ioGitHub Pages
camocamo.githubusercontent.com图片缓存
avatarsavatars.githubusercontent.com用户头像
usercontentuser-content.githubusercontent.com用户生成内容
assetsassets-cdn.github.com资源 CDN
ghsgithub.global.ssl.fastly.netGitHub 全球加速节点
greasyforkgreasyfork.orgGreasyFork 脚本站
upgfupdate.greasyfork.orgGreasyFork 更新源
devgithub.devGitHub Web 编辑器
githubassetsgithub.githubassets.comGitHub 静态资源
supportsupport-assets.githubassets.comGitHub 支持资源
edueducation.github.comGitHub 教育
resresources.github.comGitHub 资源
uploaduploads.github.comGitHub 上传服务
aparchiveprogram.github.comGitHub 归档计划
gucgithubusercontent.comGitHub 用户内容泛域名
cloudcloud.githubusercontent.com云图片缓存
avatars0avatars0.githubusercontent.com头像 0 号节点
avatars1avatars1.githubusercontent.com头像 1 号节点
avatars2avatars2.githubusercontent.com头像 2 号节点
avatars3avatars3.githubusercontent.com头像 3 号节点
avatars4avatars4.githubusercontent.com头像 4 号节点
userimguser-images.githubusercontent.com用户上传图片
objectsobjects.githubusercontent.com对象存储
puiprivate-user-images.githubusercontent.com私有用户图片
pagespages.github.comGitHub Pages 信息
appgithubapp.comGitHub 应用域名

示例

  1. 访问 GitHub 仓库首页
    原始地址:https://github.com/octocat/Hello-World
    代理地址:https://api.undz.cn/gh/www/octocat/Hello-World

  2. 下载 raw 文件
    原始地址:https://raw.githubusercontent.com/octocat/Hello-World/master/README
    代理地址:https://api.undz.cn/gh/raw/octocat/Hello-World/master/README

  3. 查看 Gist
    原始地址:https://gist.github.com/username/abc123
    代理地址:https://api.undz.cn/gh/gist/username/abc123

  4. GitHub API 调用
    原始地址:https://api.github.com/users/octocat
    代理地址:https://api.undz.cn/gh/api/users/octocat

💡 如果代理后页面出现样式错乱或图片缺失,请尝试使用 /gh_fix/ 前缀,它会自动重写页面内的链接,修复相对路径和 CSP 限制。


二、通用代理模式

此代理不公开

此代理不面向公众开放


三、工作原理

代理服务基于 Cloudflare Workers 实现:

  • 请求拦截:根据路径前缀识别代理请求,提取目标 URL。
  • 内容获取:使用自定义 User-Agent 向上游发起请求,跟随重定向。
  • 智能重写*_fix 模式):对返回的 HTML 进行解析,重写所有 scriptlinkimga 等标签的链接,使其再次通过代理,同时移除 integrity 属性以避免 SRI 校验失败,并删除 CSP 头防止浏览器拦截。
  • GitHub 专用优化:内置 30+ 个 GitHub 相关域名的自动转换,支持短路径写法。

四、注意事项与合理使用提醒

代理服务为公共或半公共服务,请遵守以下准则:

  1. 尊重版权与法律
    请勿利用代理访问或传播侵权内容、违反中国法律法规或 GitHub 服务条款的材料。

  2. 禁止滥用
    不要使用代理进行大规模爬虫、压力测试、暴力破解、刷流量等行为,以免影响他人正常使用。

  3. 密钥安全
    如需使用通用代理,密钥为个人凭证,请勿上传至公开代码仓库、聊天记录或截图中。密钥泄露可导致他人滥用您的授权。

  4. 服务可用性
    代理服务由个人维护,不保证 100% 可用。如遇到响应缓慢或错误,可稍后重试或尝试切换 /gh_fix//gh/ 模式。

  5. 隐私说明
    代理服务会记录访问的 IP 地址和请求路径,用于排查问题和防止滥用。完整 URL 可能会经过服务端,请勿传递敏感信息(如包含 Token 的私有链接)。

  6. GitHub 专用模式无需授权,但也请合理使用,避免对上游 GitHub 造成过量请求。


五、故障排除

现象可能原因解决办法
返回 403 Forbidden访问通用代理但未授权先完成 /auth-proxy 授权流程
返回 400 Bad Request代理路径格式错误检查是否漏掉协议(http://https://
页面样式丢失HTML 中的相对路径未被转换改用 *_fix 模式(如 /gh_fix//proxy_fix/
授权成功后依然 403Cookie 未携带或已过期清除浏览器缓存/重试授权,或重新获取密钥
返回 5xx 错误上游服务或代理内部错误稍后重试,或联系服务提供者

六、写在最后

本代理服务旨在为开发者提供一个便捷的 GitHub 访问加速方案,适合在科研、学习、开源贡献等场景下使用。如果你觉得有用,可以分享给需要的朋友,但请一并转发本文的使用规范。

快乐编码,从流畅访问 GitHub 开始!

基于 MIT 许可发布