curl 通,安装卡住
检查 工具没有用上代理:设置写在它不读的文件里,或变量名不对(变量名大小写都会匹配,pnpm 也有自己的回退顺序)。
处理 在同一个终端里设变量,或者把完整地址写进工具文档里说的那个文件。项目 .npmrc 里的代理地址不要用 ${变量}。
停止条件 curl 本身就失败,就先修代理,见代理认证指南。
pnpm、Yarn、Bun 各从哪里读代理设置,哪些细节官方页面没有写。
| 项目 | pnpm | Yarn Berry(2 及以后) | Bun |
|---|---|---|---|
| 设置或变量 | httpsProxy、httpProxy、noProxy;也读 .npmrc | .yarnrc.yml 里的 httpProxy 和 httpsProxy | fetch() 读 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY、NO_PROXY |
| 回退顺序 | httpsProxy:proxy,再 HTTPS_PROXY;httpProxy:httpsProxy,再 HTTP_PROXY;noProxy:noproxy,再 NO_PROXY | 文档没写 | http: 地址用 HTTP_PROXY,https: 地址用 HTTPS_PROXY;具体变量没设时用 ALL_PROXY |
| 跳过代理的名单 | noProxy,逗号分隔的域名后缀 | 文档没有 noProxy | NO_PROXY,逗号或空格分隔 |
| 账号密码写在地址里 | 读到的页面没说 | 没说;示例是 http://proxy:4040 | 代理地址里怎么写没展示;Proxy-Authorization 头会覆盖地址里的账号密码 |
| SOCKS | 没提 | 没提 | ALL_PROXY 里写 socks5:// 会被忽略 |
来源:pnpm 的设置页和 .npmrc 页、Yarn 的 .yarnrc 参考页、Bun 的 fetch 页,均在 2026 年 11 月 16 日读过。「没说」指我们读到的页面没写,不等于不支持,请用自己的代理实测。
pnpm 在「网络设置」里列了 httpsProxy、httpProxy、noProxy。httpsProxy 默认是 null,没设时回退到旧的 proxy 设置,再回退到环境变量 HTTPS_PROXY 或 https_proxy。httpProxy 没设时用 httpsProxy 解析出的值,再回退到 HTTP_PROXY 或 http_proxy。noProxy 是逗号分隔的、不走代理的域名后缀,没设时回退到 noproxy,再回退到 NO_PROXY 或 no_proxy。
pnpm 会从 .npmrc 读代理设置,.npmrc 那页还有一条限制:项目里的 .npmrc 中,registry 和代理地址(registry、proxy、https-proxy、http-proxy)不能引用环境变量,pnpm 会忽略这样的设置并打印警告。所以这里要写完整地址,或者干脆不用文件、改设环境变量。带账号密码的文件别提交到仓库。
# 当前终端会话:pnpm 会回退读取这些变量
export HTTPS_PROXY="http://LOGIN:PASSWORD@HOST:PORT"
export HTTP_PROXY="http://LOGIN:PASSWORD@HOST:PORT"
export NO_PROXY="localhost,127.0.0.1"
pnpm install
# 或写进 ~/.npmrc(写完整地址,里面不要用 ${变量})
https-proxy=http://LOGIN:PASSWORD@HOST:PORT
proxy=http://LOGIN:PASSWORD@HOST:PORT仅为示例:把占位内容换成自己的值。没有在这里运行;设置名和回退顺序依据 pnpm 官方页面。页面没说 pnpm 是否接受地址里的账号密码,请用下面的 curl 测试确认;密码里的特殊字符要做 URL 编码。
Yarn 2 及以后的文档写了 httpProxy(发 HTTP 请求时用的代理)和 httpsProxy(发 HTTPS 请求时用的代理),都写在 .yarnrc.yml 里,示例是 http://proxy:4040 这样的地址。参考页没有 noProxy,也没有提 SOCKS 和地址里的账号密码。networkSettings 里可以按主机名单独放 httpProxy。
这一节只讲 Yarn Berry。Yarn 1 的配置页我们没读过,如果 yarn --version 以 1 开头,请去看对应版本自己的文档。
httpProxy: "http://LOGIN:PASSWORD@HOST:PORT"
httpsProxy: "http://LOGIN:PASSWORD@HOST:PORT"仅为示例:把占位内容换成自己的值。没有在这里运行;键名依据 Yarn 的 .yarnrc 参考页,它自己的示例是不带账号密码的 http://proxy:4040。
Bun 的 fetch 页说,没有传 proxy 选项时,Bun 每次执行 fetch 都会读 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY(大小写都行)。具体变量没设时用 ALL_PROXY;值是别种代理(比如 socks5://)会被忽略。NO_PROXY 列出不走代理的主机,对显式的 proxy 选项也生效;用 respectNoProxy: false 或 proxy: false 可以改变。
那一页讲的是你自己代码里的 fetch()。我们读到的 Bun install 页和 .npmrc 页都没提代理设置,所以 bun install 具体怎么表现,我们没法告诉你。在同一个终端里设好变量,装一个小依赖,再用 curl 测试和代理商的流量记录确认,之后再放进 CI。
// 你自己脚本里的 fetch()
const res = await fetch("https://registry.npmjs.org/left-pad", {
proxy: "http://LOGIN:PASSWORD@HOST:PORT",
});
console.log(res.status);仅为示例,适用于脚本,不适用于 bun install。没有在这里运行;proxy 选项依据 Bun 的 fetch 页,该页没有展示代理地址里带账号密码的写法。
用同样的 HOST、PORT、LOGIN、PASSWORD 运行下面的 curl 命令。返回 200 或 301,说明代理能连到 registry。
预期结果 预期:registry 返回一行 HTTP 状态,而不是代理报错。
在空文件夹里,按上面的方式设好代理后,对一个只有一个依赖的项目运行 pnpm install、yarn install 或 bun install。
curl 通、安装不通,就一次只改一样:变量名、地址格式,或者设置所在的文件。
curl -I -x "http://LOGIN:PASSWORD@HOST:PORT" https://registry.npmjs.org/仅为示例:把占位内容换成自己的值。curl -x 配 http:// 代理地址是 curl 的标准用法;这里没有对真实代理运行。
检查 工具没有用上代理:设置写在它不读的文件里,或变量名不对(变量名大小写都会匹配,pnpm 也有自己的回退顺序)。
处理 在同一个终端里设变量,或者把完整地址写进工具文档里说的那个文件。项目 .npmrc 里的代理地址不要用 ${变量}。
停止条件 curl 本身就失败,就先修代理,见代理认证指南。
检查 代理要登录但没收到账号密码,或者密码里有 @、: 这类需要 URL 编码的字符。
处理 核对「我的资产」里的 LOGIN 和 PASSWORD,把特殊字符做百分号编码再写进地址。
停止条件 别一直重试,反复登录失败没有用。
检查 它们的地址也被送进了代理。
处理 把它们加进 noProxy(pnpm)或 NO_PROXY,各工具的格式不一样。
停止条件 Yarn Berry 文档没有 noProxy;那边要排除的话,先实测,或者改用环境变量那一套。
装依赖一般不在乎出口 IP 在哪,最直接的选择是按 IP 租的机房 IP:1 天 US$0.25,3 天 US$0.75,7 天 US$1.75,30 天 US$3.99,各国同价,下单时选 HTTP(端口 2222)或 SOCKS5(端口 3333)。有哪些国家、有没有货以下单页为准。上面这几个工具请用 HTTP 的那种。
没有免费试用,最小购买是一个 IP 一天,先拿一个项目试。
用 httpsProxy、httpProxy 设置,或在 .npmrc 里写 https-proxy 和 proxy,或在终端设 HTTPS_PROXY 和 HTTP_PROXY。pnpm 的回退顺序是 httpsProxy、proxy、HTTPS_PROXY。
我们读到的 pnpm 页面没有提 SOCKS,请用 HTTP 类型的代理地址。
.yarnrc 参考页只有 httpProxy 和 httpsProxy,没有 noProxy,所以没有文档写明的开关。
我们读到的 Bun 页面写明 fetch() 读 HTTP_PROXY、HTTPS_PROXY 和 NO_PROXY。bun install 没找到官方说法,请自己测。
这是常见写法,本文示例也这样写,但我们读到的三个页面都没有针对包管理器说明这点。请用 curl 和一次小安装确认。
官方文档 · 确认日期:
2026 年 11 月 16 日读过:httpsProxy、httpProxy、noProxy 的默认值与回退顺序。
官方文档 · 确认日期:
2026 年 11 月 16 日读过:代理设置可从 .npmrc 读取;项目 .npmrc 中的 registry 和代理地址不能引用环境变量,pnpm 会忽略并警告。
官方文档 · 确认日期:
2026 年 11 月 16 日读过:httpProxy、httpsProxy 及示例 http://proxy:4040;没有 noProxy 条目;networkSettings 可按主机名设置。
官方文档 · 确认日期:
2026 年 11 月 16 日读过:proxy 选项、HTTP_PROXY、HTTPS_PROXY、ALL_PROXY、NO_PROXY 的处理、Proxy-Authorization 头;ALL_PROXY 里的 socks5:// 会被忽略。
讲的是脚本里的 fetch()。同日读过的 Bun install 页和 .npmrc 页没有提代理。
产品观察 · 确认日期:
Proxy302 产品信息,11 月 16 日核对:静态 ISP 与机房按 IP 租用的美元价格、租期、协议与端口(HTTP 2222、SOCKS5 3333)、没有免费试用。
注册账号、充值一次,就能选动态住宅、静态 ISP 或数据中心 IP,几分钟配进你的浏览器。