跳到正文

pnpm、Yarn、Bun 代理设置怎么写

pnpm、Yarn、Bun 各从哪里读代理设置,哪些细节官方页面没有写。

三个工具各自写了什么

三个工具各自写了什么
项目pnpmYarn Berry(2 及以后)Bun
设置或变量httpsProxy、httpProxy、noProxy;也读 .npmrc.yarnrc.yml 里的 httpProxy 和 httpsProxyfetch() 读 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,逗号分隔的域名后缀文档没有 noProxyNO_PROXY,逗号或空格分隔
账号密码写在地址里读到的页面没说没说;示例是 http://proxy:4040代理地址里怎么写没展示;Proxy-Authorization 头会覆盖地址里的账号密码
SOCKS没提没提ALL_PROXY 里写 socks5:// 会被忽略

来源:pnpm 的设置页和 .npmrc 页、Yarn 的 .yarnrc 参考页、Bun 的 fetch 页,均在 2026 年 11 月 16 日读过。「没说」指我们读到的页面没写,不等于不支持,请用自己的代理实测。

pnpm:三个设置和它们放在哪

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:环境变量和 .npmrc(示例)

# 当前终端会话: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 Berry:.yarnrc.yml

Yarn 2 及以后的文档写了 httpProxy(发 HTTP 请求时用的代理)和 httpsProxy(发 HTTPS 请求时用的代理),都写在 .yarnrc.yml 里,示例是 http://proxy:4040 这样的地址。参考页没有 noProxy,也没有提 SOCKS 和地址里的账号密码。networkSettings 里可以按主机名单独放 httpProxy。

这一节只讲 Yarn Berry。Yarn 1 的配置页我们没读过,如果 yarn --version 以 1 开头,请去看对应版本自己的文档。

Yarn Berry:.yarnrc.yml(示例)

httpProxy: "http://LOGIN:PASSWORD@HOST:PORT"
httpsProxy: "http://LOGIN:PASSWORD@HOST:PORT"

仅为示例:把占位内容换成自己的值。没有在这里运行;键名依据 Yarn 的 .yarnrc 参考页,它自己的示例是不带账号密码的 http://proxy:4040。

Bun:文档里写了什么

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。

Bun:fetch() 走代理(示例)

// 你自己脚本里的 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 页,该页没有展示代理地址里带账号密码的写法。

先测代理,再怪包管理器

  1. 第 1 步:用 curl 测代理

    用同样的 HOST、PORT、LOGIN、PASSWORD 运行下面的 curl 命令。返回 200 或 301,说明代理能连到 registry。

    预期结果 预期:registry 返回一行 HTTP 状态,而不是代理报错。

  2. 第 2 步:装一个小依赖

    在空文件夹里,按上面的方式设好代理后,对一个只有一个依赖的项目运行 pnpm install、yarn install 或 bun install。

  3. 第 3 步:一次只改一样

    curl 通、安装不通,就一次只改一样:变量名、地址格式,或者设置所在的文件。

测试代理(示例)

curl -I -x "http://LOGIN:PASSWORD@HOST:PORT" https://registry.npmjs.org/

仅为示例:把占位内容换成自己的值。curl -x 配 http:// 代理地址是 curl 的标准用法;这里没有对真实代理运行。

走代理安装失败时

curl 通,安装卡住

检查 工具没有用上代理:设置写在它不读的文件里,或变量名不对(变量名大小写都会匹配,pnpm 也有自己的回退顺序)。

处理 在同一个终端里设变量,或者把完整地址写进工具文档里说的那个文件。项目 .npmrc 里的代理地址不要用 ${变量}。

停止条件 curl 本身就失败,就先修代理,见代理认证指南。

407 Proxy Authentication Required

检查 代理要登录但没收到账号密码,或者密码里有 @、: 这类需要 URL 编码的字符。

处理 核对「我的资产」里的 LOGIN 和 PASSWORD,把特殊字符做百分号编码再写进地址。

停止条件 别一直重试,反复登录失败没有用。

公司内网或私有 registry 打不开了

检查 它们的地址也被送进了代理。

处理 把它们加进 noProxy(pnpm)或 NO_PROXY,各工具的格式不一样。

停止条件 Yarn Berry 文档没有 noProxy;那边要排除的话,先实测,或者改用环境变量那一套。

装依赖用 Proxy302 的哪个产品

装依赖一般不在乎出口 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 一天,先拿一个项目试。

pnpm、Yarn、Bun 代理常见问题

pnpm 怎么设置代理?

用 httpsProxy、httpProxy 设置,或在 .npmrc 里写 https-proxy 和 proxy,或在终端设 HTTPS_PROXY 和 HTTP_PROXY。pnpm 的回退顺序是 httpsProxy、proxy、HTTPS_PROXY。

pnpm 支持 SOCKS 代理吗?

我们读到的 pnpm 页面没有提 SOCKS,请用 HTTP 类型的代理地址。

Yarn Berry 怎么让部分主机不走代理?

.yarnrc 参考页只有 httpProxy 和 httpsProxy,没有 noProxy,所以没有文档写明的开关。

bun install 会用 HTTP_PROXY 吗?

我们读到的 Bun 页面写明 fetch() 读 HTTP_PROXY、HTTPS_PROXY 和 NO_PROXY。bun install 没找到官方说法,请自己测。

账号密码能直接写在代理地址里吗?

这是常见写法,本文示例也这样写,但我们读到的三个页面都没有针对包管理器说明这点。请用 curl 和一次小安装确认。

参考资料

5
  1. pnpm: network settings (httpsProxy, httpProxy, noProxy)

    官方文档 · 确认日期:

    2026 年 11 月 16 日读过:httpsProxy、httpProxy、noProxy 的默认值与回退顺序。

  2. pnpm: .npmrc

    官方文档 · 确认日期:

    2026 年 11 月 16 日读过:代理设置可从 .npmrc 读取;项目 .npmrc 中的 registry 和代理地址不能引用环境变量,pnpm 会忽略并警告。

  3. Yarn: .yarnrc.yml settings

    官方文档 · 确认日期:

    2026 年 11 月 16 日读过:httpProxy、httpsProxy 及示例 http://proxy:4040;没有 noProxy 条目;networkSettings 可按主机名设置。

  4. Bun: fetch

    官方文档 · 确认日期:

    2026 年 11 月 16 日读过:proxy 选项、HTTP_PROXY、HTTPS_PROXY、ALL_PROXY、NO_PROXY 的处理、Proxy-Authorization 头;ALL_PROXY 里的 socks5:// 会被忽略。

    讲的是脚本里的 fetch()。同日读过的 Bun install 页和 .npmrc 页没有提代理。

  5. Proxy302 产品信息与价目表

    产品观察 · 确认日期:

    Proxy302 产品信息,11 月 16 日核对:静态 ISP 与机房按 IP 租用的美元价格、租期、协议与端口(HTTP 2222、SOCKS5 3333)、没有免费试用。

准备好试试了吗?

注册账号、充值一次,就能选动态住宅、静态 ISP 或数据中心 IP,几分钟配进你的浏览器。