一键换源脚本

脚本全部由官网保存与下发,命令里的下载地址始终是官网;
需要指定加速服务器时用 ?node= 参数,脚本里的加速地址就会换成那台服务器。

脚本列表

脚本 作用
https://www.gh-proxy.cn/scripts/pip.sh Python pip
https://www.gh-proxy.cn/scripts/npm.sh Node.js npm / pnpm / yarn
https://www.gh-proxy.cn/scripts/apt.sh Debian / Ubuntu
https://www.gh-proxy.cn/scripts/dnf.sh CentOS / Rocky / AlmaLinux / Fedora
https://www.gh-proxy.cn/scripts/pacman.sh Arch / Manjaro
https://www.gh-proxy.cn/scripts/apk.sh Alpine
https://www.gh-proxy.cn/scripts/zypper.sh openSUSE / SLES

指定加速服务器

在脚本地址后面加上 ?node= 即可,参数有四种写法:

写法 例子
入口地址 ?node=https://z1.example.com
主机名 ?node=z1.example.com
安装序号 ?node=1
入口名称 ?node=美国美西

只有本站入口列表里出现过的地址才会生效,其他地址会被忽略,
脚本会退回使用官网地址,因此参数不会指向未知的域名。

curl -fsSL "https://www.gh-proxy.cn/scripts/apt.sh?node=z1.example.com" | sh -s -- --dry-run

在软件源加速页面上选择入口后,页面里的命令会自动补上这个参数。

通用参数

参数 说明
--dry-run 在临时目录里真实执行一遍并打印差异,不动系统
--restore 从 *.gha-bak 还原
--no-update 只换源,不执行 update / makecache
--user / --global pip、npm 专用:改当前用户或全局配置
--dist npm 专用:同时指向 electron 等二进制镜像
--branch v3.20 apk 专用:指定 Alpine 分支

建议先看再执行

curl -fsSL https://www.gh-proxy.cn/scripts/apt.sh -o /tmp/apt.sh
less /tmp/apt.sh
sudo sh /tmp/apt.sh --dry-run

脚本只做三件事:备份原文件、写入新的源地址、可选地执行一次刷新命令。
所有改动都能用 --restore 还原,也可以手动把 *.gha-bak 改回原名。

最后更新:2026-09-24 21:59:22