软件源加速总览

除了 GitHub 与 Docker,开源驿站 还提供软件源加速:
把 Python、Node.js 与常见 Linux 发行版的软件源地址换成本站,安装依赖不用再等。

支持哪些镜像

用途 本站地址 对应上游
Python / pip 索引 https://gh-proxy.cn/pypi/simple pypi.org
Python 安装包 https://gh-proxy.cn/pypi/files files.pythonhosted.org
Node.js / npm https://gh-proxy.cn/npm/ registry.npmjs.org
Debian /debian、/debian-security、/debian-ports deb.debian.org
Ubuntu /ubuntu、/ubuntu-security、/ubuntu-ports archive / security / ports.ubuntu.com
CentOS /centos-stream、/centos-vault mirror.stream.centos.org、vault.centos.org
Fedora / EPEL /fedora、/epel dl.fedoraproject.org
Rocky / AlmaLinux /rockylinux、/almalinux dl.rockylinux.org、repo.almalinux.org
Arch Linux /archlinux geo.mirror.pkgbuild.com
Alpine Linux /alpine dl-cdn.alpinelinux.org
openSUSE /opensuse download.opensuse.org

上表中的相对地址都以 https://gh-proxy.cn 开头,完整地址对照也可以直接在
软件源加速页面 里查看。

省略发行版目录也能用

把软件源地址里的整段上游地址直接换成本站域名同样可以,例如
deb https://gh-proxy.cn noble main 这种写法:

  • /dists/ 开头的地址按发行版代号自动识别 Debian 与 Ubuntu
    (bookworm 走 Debian,noble 走 Ubuntu);
  • /pool/ 开头的安装包按你这次使用过的发行版选择,首次访问默认 Debian;
  • pip 的 /simple/、/packages/,以及 Alpine 的 /v3.x/main/、
    Arch 的 /core/os/、CentOS Stream 的 /9-stream/、
    Fedora 的 /releases/ 等目录也能直接识别。

带发行版目录的写法(/debian/dists/)永远最明确,建议优先使用;
省略目录的写法只是为了兼容「整段替换」的配置习惯。

三种用法

  1. 一键换源脚本(推荐):见 一键换源脚本,支持 --dry-run 预览与 --restore 还原;
  2. 手动配置:按各篇文档里的配置文件片段修改;
  3. 临时使用:命令里加一个参数,不改任何配置。

「透明代理」意味着什么

  • 内容与上游完全一致:本站不修改、不注入任何内容;
  • 不缓存包体:请求实时转发给上游,不在服务器留存副本;
  • 包签名与校验和照旧由客户端本地校验(apt、dnf、pacman、apk、zypper、pip、npm 都会校验);
  • 支持断点续传(HTTP Range),大包下载中断后可以继续。

分家族开关

后台可以只关闭其中一类:pip、npm、Linux 软件源各自独立。
关掉某一类时,该类请求会返回 503 与说明,其他两类不受影响。

常见状态码

状态码 含义
200 / 206 正常(206 表示断点续传的分段响应)
403 目标地址不在允许的上游白名单内
404 上游确实没有这个文件(包名、版本或路径写错)
429 触发限流,稍后重试即可
503 该类镜像被管理员关闭,或站点正在维护
最后更新:2026-09-24 22:17:35