国内访问 npmjs 不稳怎么办：改走团队统一源做缓存

npm install 卡在 registry.npmjs.org，日志里是超时、ECONNRESET，偶发还有 TLS 握手失败或上游 502——我见过同一办公网：笔记本热点能装、公司 DNS 下必挂，也见过「本机已切源、CI 镜像里 NPM_CONFIG_REGISTRY 仍指向官方」。再收藏一个公共镜像 URL，往往治标不治本：私有包仍无同址，CI 与本机源也不一致。更稳的路径是：开发机 / CI 只认团队 GROUP，公共包经 PROXY 缓存，内部包仍在 HOSTED；本文假定三仓与令牌已按「云上免费 npm 私有源起步」或「npm 私服怎么搭」配好，专注可达性诊断与缓存命中验收。

结论： 用私有 Registry 的 GROUP 作唯一安装源、PROXY 缓存 npmjs，可替代开发机/CI 直连官方源。PROXY 首次回源仍依赖出站访问 npmjs；命中本地缓存后，构建机不再各自撞上游抖动。这不取代 npmjs 的全球包身份与账号体系。

建仓、.npmrc 起步与 npm publish 闭环见文末参考：云上免费 npm 私有源怎么起步 / npm 私服怎么搭。下文从「不稳」现象开始排。

1. 先认清「不稳」长什么样

「替代 npmjs」在本文里特指：统一源 + 缓存 + 私有包同址，不是宣称全面取代生态。

1.1 公共镜像站 vs 私服（选题边界）

2. 流量边界（读 GROUP，写 HOSTED）

开发机 / CI
  registry = …/npm/npm-all/          (GROUP，唯一安装入口)
       ├─ npm-hosted                 (HOSTED，内部包优先)
       └─ npmjs-proxy                (PROXY → https://registry.npmjs.org)

• 读： 只配 GROUP（成员顺序 hosted → proxy）。
• 写： 只对 HOSTED npm publish（步骤见云上免费 npm 起步文，本文不重复）。
• 认证： .npmrc 用 URL 作用域 _authToken=${NPM_TOKEN}；令牌不要写进 Git。无开箱 tenant_id。
• 出站： 仓库节点仍须能访问 https://registry.npmjs.org——缓存未命中时，统一源也会把上游抖动「集中」到仓库侧。

云主机示例用 repo.anguskit.com；自建换成你的域名。

3. 诊断路径：直连不稳 → 确认已切源 → 验收 PROXY

3.1 确认当前到底打到哪

在出问题的同一台机器 / 同一 CI job 里执行：

# 生效的 registry（含项目级覆盖）
npm config list -l | rg -i 'registry'

# 环境变量常被 CI 镜像偷偷注入
env | rg -i 'npm_config_registry|NPM_CONFIG_REGISTRY'

# lock 是否仍锁死官方主机
rg -n 'registry\.npmjs\.org' package-lock.json yarn.lock pnpm-lock.yaml 2>/dev/null | head

若 registry 仍是 https://registry.npmjs.org/，或 lock 里大量 resolved 指向 npmjs，后面所有「换源」验收都无效——先改配置或清 lock 重装（细节见云上免费 npm 起步文 §3.2 三坑）。

3.2 对比：直连失败 vs 经 GROUP

不要编造测速数字。用同命令、同依赖、相邻两次看失败形态是否变化即可：

# A. 直连官方（复现「不稳」）
npm install lodash --registry https://registry.npmjs.org/ --prefer-online

# B. 经团队 GROUP（应走 PROXY；首次可能回源）
npm install lodash --registry https://repo.anguskit.com/npm/npm-all/ --prefer-online

判读：

3.3 怎么确认走的是 PROXY 缓存，而不是每次直连上游

目标：第二次安装不再长时间回源；控制台能看到 PROXY 侧缓存条目（字段名以控制台为准）。

1. 控制台打开 npmjs-proxy（或你的 PROXY 名）→ 查看缓存 / 制品列表是否出现刚装过的包（如 lodash）。
2. 同一干净目录再装一次（可先删 node_modules，保留已指向 GROUP 的 lock）：

rm -rf node_modules
npm install lodash --registry https://repo.anguskit.com/npm/npm-all/

1. 观察：第二次应明显更快或不再长时间卡在「解析 / 下载 registry.npmjs.org」；若仍长时间回源，查 PROXY 远程 URL 是否为 https://registry.npmjs.org、仓库出站、以及是否被 --prefer-online / 缓存策略强制回源（以控制台与手册为准）。
2. 失败时优先查仓库出站与 PROXY 配置，而不是再给开发机换第三个镜像 URL。

预热核心依赖、弱网 / 断网构建见文末参考：离线构建预热。

3.4 统一源之后仍可能「像官方一样挂」的边界

4. 边界与翻车表

公开给合作方安装时，另走 /explore 与公开 HOSTED，见文末参考：公开门户。

FAQ

这能替代 npmjs.org 官网吗？

对团队默认安装源与私有包托管，可以。包发布到公共 npmjs、账号与组织体系仍在官方。本文说的「替代」是统一源 / 缓存场景，不是全面取代生态。

和淘宝等公共镜像怎么选？

见 §1.1：公共镜像解决可达；私服解决私有包 + 缓存 + ACL + 审计同址。两者可并存，迁移期可先只切公司 scope。

选型上如何对标 Nexus / Verdaccio？

多格式与替代场景见文末参考：选型文；Verdaccio 迁出见文末参考：Verdaccio 迁移。

小结

• 先区分 DNS / TLS / 超时 / 401，再谈换源。
• 用 §3.1–3.3 验收「已切 GROUP」与「PROXY 缓存命中」。
• 统一源不取消上游：冷缓存回源仍可能受 npmjs 影响。

参考文章

• npm 格式手册：https://www.anguskit.com/zh/docs/repo/manual/05-formats/03-npm
• npm 私服怎么搭：https://www.anguskit.com/zh/blog/npm-private-registry
• 云上免费 npm 私有源怎么起步：https://www.anguskit.com/zh/blog/free-npm-registry-cloud
• 内网离线怎么构建：https://www.anguskit.com/zh/blog/offline-build-maven-npm-warm-cache
• pnpm / yarn 私有源：https://www.anguskit.com/zh/blog/pnpm-yarn-private-registry
• Verdaccio 迁到 AngusRepo：https://www.anguskit.com/zh/blog/migrate-from-verdaccio-npm-registry
• 选型：一套仓库替换多套私服：https://www.anguskit.com/zh/blog/repo-selection-2026
• 公开门户 /explore：https://www.anguskit.com/zh/blog/public-portal-launch