为什么「Clash 已开」不等于 npm / pnpm 一定顺畅?

图形客户端里的「系统代理」主要服务浏览器和读取系统代理栈的应用;而 npm、pnpm、yarn 等 Node 包管理器在终端里跑的时候,往往不自动继承这套设置。它们走的是当前 Shell 的 HTTP_PROXY / HTTPS_PROXY / ALL_PROXY,以及你在 .npmrc 里写的 registry。只要其中一环没对齐本地 Clash 的混合端口或 TUN,你就会看到:网页秒开,终端却在解析包清单或拉 tarball 时长时间无进度。

另一个误区是只靠「换一个更快的落地节点」。实际上,一次 install 会串很多主机名:例如官方源会先向 registry.npmjs.org 要元数据与解析 resolved 里的 tarball URL,再对真正的 .tgz 地址发起下载——很多 tarball 仍落在 registry.npmjs.org 路径下,也可能经解析落到其他 CDN;若你启用了淘宝镜像一类源,主 registry 与「同步 tarball」域名还可能和官方完全不同。此时若规则里把其中一段直连、另一段塞进高延迟代理组,表现就是进度条偶发卡在某一两个包上。本文目标,是把这条链拆开写清楚,让你能对照连接日志自查,而不是盲换节点。

registry、元数据与 tarball 分别是什么关系?

可以把一次 npm install 粗略拆成三步:其一,客户端根据当前 registry 拉取包的版本元数据(通常是一大串 JSON);其二,根据元数据里的 dist.tarball 字段去拉真正的压缩包;其三,解压、校验完整性并写入 node_modules(pnpm 还会维护内容寻址的 store)。

pnpm 默认复用同一套 registry 语义,只是磁盘布局与硬链接策略不同;在 monorepo 或工作区场景下,它触达的域名集合与 npm 高度重合。若项目里还有 git+https://github.com/... 依赖,日志里会额外出现 github.com、codeload.github.com 与常见的 objects.githubusercontent.com——这条链又与「仅官方 registry」截然不同,需要单独策略组,思路与站内《pip / conda 与 PyPI、GitHub 分流》里强调的 GitHub 对象存储主机名是一致的,只是本文聚焦 JavaScript 包管理器。

装 Node 依赖时常见的域名与镜像

下表覆盖多数国内开发者在 Clash 连接日志里会反复搜到的主干主机名。卡住时,优先在日志里看最后活跃连接的域名落在哪一类上。

场景 典型主机名 / 模式 说明
npm 官方 registry registry.npmjs.org 元数据与不少 tarball 同一域下的不同路径;规则建议整域进同一策略组起步
历史 Yarn 入口 registry.yarnpkg.com 常见重定向到 npm 基础设施;若项目老,仍可能出现在 lockfile 解析链中
npmmirror 等国内镜像 registry.npmmirror.com、各教育网镜像域名 适合校园或办公网优先直连;若误走高延迟代理反而绕远
可选 CDN / 备用解析 unpkg.com、cdn.jsdelivr.net 等 少数脚手架或文档会拉 umd 资源;与本地 install 同源问题可一并纳入 CDNPkg 组
GitHub 源与 Release github.com、objects.githubusercontent.com、codeload.github.com git 依赖与大文件 Release 常落对象存储子域;需与 registry 拆开

若你使用企业私服(Verdaccio、Artifactory、npm Enterprise),还应把公司域名补进独立规则;私服往往同时承载元数据与小文件 tarball,但仍建议与公网 GitHub、npm 官方源分组分开,避免维护订阅规则时被一条宽泛的 MATCH 吞掉。

在 Clash / Mihomo 里怎么拆开写规则?

思路可以概括成三句:为 registry、镜像、GitHub、可选 CDN 建不同策略组;把细粒度 DOMAIN-SUFFIX 规则放在大段 GEOIP 或「全局限直连」之前;不要把「应直连的镜像」与「必须走代理的官方 tarball」硬塞进同一组里碰运气。若语法还不熟,可先读《自定义路由规则入门》,再对照下例调整。

下面片段为演示用骨架,请把 GROUP_* 换成你订阅里真实存在的代理组名,并按网络实测决定镜像走 DIRECT 还是走专用低延迟节点。

# Illustrative rules only — replace GROUP_* with your real proxy groups
rules:
  - DOMAIN-SUFFIX,registry.npmmirror.com,DIRECT
  - DOMAIN-SUFFIX,npmmirror.com,DIRECT
  - DOMAIN-SUFFIX,registry.npmjs.org,GROUP_NPM_REGISTRY
  - DOMAIN-SUFFIX,yarnpkg.com,GROUP_NPM_REGISTRY
  - DOMAIN-SUFFIX,github.com,GROUP_GITHUB
  - DOMAIN-SUFFIX,githubusercontent.com,GROUP_GITHUB
  - DOMAIN-SUFFIX,jsdelivr.net,GROUP_CDN_MISC
  - DOMAIN-SUFFIX,unpkg.com,GROUP_CDN_MISC
  # Add enterprise registry DOMAIN-SUFFIX here if any

实践中请配合连接面板或内核日志:当 pnpm install 停在某进度时,看最近一条 TLS 连接的 SNI 是哪个后缀。若发现 registry.npmjs.org 被前置的某条宽泛规则送到了错误分组,就优先上移更精确的 DOMAIN 规则。维护大量后缀时,可引入 rule-provider,详见《Rule Providers 进阶教程》。

若配置里存在大段「中国大陆 IP 直连」,而某些镜像解析到了境外 Anycast CDN,可能出现「DNS 在国内、出口却绕路」的怪异延迟。此时更稳妥的是对已知镜像域名写死策略,而不是完全交给 GEOIP 猜。

镜像、官方源与 Clash 如何同时存在?

不少团队会在 .npmrc 或环境变量里写死 registry=https://registry.npmmirror.com/;这在教育网环境常常是最优解。但如果你同时开着 Clash,就要避免两类冲突:一是镜像本应直连却被送进海外代理;二是 Shell 里遗留旧的 HTTP_PROXY,让本可直连的镜像强行穿墙,触发限速或证书校验异常。

比较稳妥的习惯是:先决定「这次安装以镜像为主还是以官方源加代理为主」,再让 Clash 规则与 .npmrc 对齐。混合配置不是不行,但要清楚元数据与 tarball 是否来自同一镜像前缀;否则你会看到哈希校验失败或 ETARGET——那就不是代理单一问题了,需要回到 registry 配置排查。

终端侧:务必核对代理环境变量

即使规则完美,若当前终端没有设置 HTTPS_PROXY,包管理器仍可能对公网发起直连。macOS 与 Linux 读者可按本站《macOS 终端代理与环境变量》检查 Shell 与 NO_PROXY;在 Windows 上开发时,注意 PowerShell 会话是否单独 export 了与 Clash 端口不一致的旧值。

快速自检(把端口换成你的 mixed 或 HTTP 监听端口):

env | grep -i proxy
curl -I https://registry.npmjs.org/react

若根据 Clash 文档导出的一串 export 之后,curl 明显变快,去掉后又恢复原样,即可判断问题在环境变量未生效而非订阅本身。npm config get proxy 与 pnpm config get https-proxy 也能帮助确认工具层是否覆盖了 Shell。

DNS、fake-ip 与少见边角

使用 fake-ip 或激进分流时,偶尔会出现「解析看似正确,但某 tarball 子域没被规则覆盖」的现象。应在日志里核对真实连接域名而非仅看浏览器 DevTools。若半开下载伴随 HTTP/3 异常,可对照《QUIC 与 HTTP/3 干扰》检查 UDP;不过绝大多数 npm 下载仍以 HTTPS/TCP 为主,卡顿多来自规则顺序与出口策略。

对照排查表(建议收藏)

步骤 检查项 期望结果
1 Clash 混合 / HTTP 端口是否在本机监听 nc -vz 127.0.0.1 端口 成功,客户端无报错
2 当前终端的 HTTPS_PROXY / ALL_PROXY 与 Clash 端口一致;需要代理的会话内已 export
3 安装过程中连接日志里的活跃域名 日志可见,且 registry / GitHub / 镜像分别命中预期策略组
4 镜像与官方 tarball 是否「抢答」同一条宽规则 镜像若应直连,不被误送至高延迟节点
5 GitHub 大文件子域是否覆盖 objects.githubusercontent.com 等已单独处理
遇到疑难时,先截取「卡住那一刻」的连接日志,再与上表域名对照。比起反复切换「全局 / 规则」,先确认哪一个主机名走错路,能更快收敛问题。

小结

npm 与 pnpm 的下载链路,本质是多域名协作:registry 元数据、tarball、镜像与 GitHub 往往不应共用一条模糊规则。Clash 的价值在于把每一类主机名送到合适出口,而不是用单一「PROXY 组」碰运气。把官方 registry、镜像、GitHub 相关后缀拆进独立策略组,并确认终端环境变量真的把 HTTPS 交给本机 Clash,大量「装依赖玄学」都能还原成可验证的网络问题。

若希望客户端与站内文档版本一致、混合端口与 TUN 能力说明统一,可从本站客户端下载页获取当前平台安装包,并结合使用文档核对功能开关。相比零散渠道,统一来源能减少「界面显示已代理、实际端口未监听」这类低级错配。

在稳定性与规则可维护性上,Mihomo 系 Clash 对域名级分流与远程规则集的支持已经相当成熟;当你把 Node 工具链也纳入同一套路由体系后,日常开发里浏览器、包管理与远程协作的出口行为会更一致,排错成本也随之下降。

→ 立即免费下载 Clash,开启流畅上网新体验

前往本站下载页获取客户端