Verdaccio 搭建私有 npm 仓库后,yarn install 报 404 怎么办?

打工人文华 阅读 13

我用 Verdaccio 搭了个私有 npm 仓库,本地能 publish 成功,但其他同事用 yarn install 安装这个包时一直报 404,明明包在仓库里能看到。

我们 .yarnrc 配置了 registry "http://localhost:4873",也试过用 yarn config set registry,但还是不行。是不是 Verdaccio 的配置哪里漏了?

Verdaccio 的 config.yaml 里我只改了 listen 和 uplinks,packages 部分还是默认的:

packages:
  '@*/*':
    access: $all
    publish: $authenticated
    unpublish: $authenticated

  '**':
    access: $all
    publish: $authenticated
    unpublish: $authenticated
我来解答 赞 3 收藏
二维码
手机扫码查看
1 条解答
佳佳 ☘︎
听你这么一说,问题可能出在几个方面。首先检查下同事机器上的 .yarnrc 配置,建议用绝对路径而不是 localhost,比如换成你的局域网IP地址。

然后 Verdaccio 的配置确实要看看。默认的 packages 配置一般够用了,但最好确认下 access 权限设置对不对。有时候 $all 可能不够宽松,试试改成 access: '*' 看看。

再一个就是缓存问题。Yarn 有时会缓存旧的 registry 配置,建议让同事清理下 yarn 缓存:
yarn cache clean

然后重新执行 yarn install。

如果还不行,可能是包版本的问题。确保发布时指定明确的版本号,像这样:npm publish --tag v1.0.0 这样安装时也要对应上版本号。

最后提醒一下,记得检查 Verdaccio 的日志,很多问题都能从里面找到线索。我自己搭环境时也踩过不少坑,慢慢调总会好的。
点赞
2026-03-27 10:00