借助docker, 使用verdaccio搭建npm私服

news2025/2/27 12:38:15

为何要搭建npm私服

搭建npm私服好处多多，网上随便一篇教程搜出来都罗列了诸多好处，譬如:

公司内部开发环境与外网隔离，内部开发的一些库高度隐私不便外传，内网搭建npm服务保证私密性
同属内网，可以确保使用npm下载依赖快速稳定
控制npm模块质量和安全，对于下载、发布npm包有对应的权限管理
接触前端运维，拒绝当个纯页面仔，简历好装逼
…

方案选择

时至今日，较好的免费选择有 Nexus, Verdaccio。

本篇介绍 Verdaccio 搭建的完整流程和诸多踩坑细节，Nexus有机会再分享。

上手Verdaccio

这里默认你已经掌握了 linux, docker 的基本使用，不会也没事，我会带着你一个一个指令敲的。

也默认你有一个linux服务器已经安装好了docker，没有也没事，win10/win11也可以直接搞个docker。

以下都是在 Ubuntu 18.04.4 系统中实操

直接用docker启动 verdaccio

指令：docker run -it -d --name zwd_verdaccio -p 4873:4873 verdaccio/verdaccio

不是还没有安装 verdaccio 镜像呢么，不用慌，如上指令会先直接下载 verdaccio/verdaccio镜像

稍微解释一下指令的含义：

docker run 启动容器
--name zwd_verdaccio 这个容器名叫 zwd_verdaccio

哎嘿，没了，“稍微”。

查看当前正在运行的docker容器

指令docker ps ，加个 -a就能看到所有的

复制这个容器内的配置文件到宿主机上，这样方便修改

我看了很多很多很多的教程，都是让挨个新建文件的，当时真迷糊为啥要建这么些文件，现在真迷糊为啥要这么麻烦？

指令 docker cp zwd_verdaccio:/verdaccio /home/zwd/verdaccio 直接在本地复制生成配置文件。这个指令的意思就是把上面刚刚开启的 zwd_verdaccio里的配置文件复制到 /home/zwd/verdaccio这个路径下，也可自定义路径。

这里 linux 的文件路径和 windows 下有很大区别。

查看 /home/zwd/verdaccio

设置 verdaccio 权限

很重要的一点，指令chown -R 10001:65533 /home/zwd/docker/verdaccio 不然后期出现权限的问题

删除 zwd_verdaccio 容器

配置文件复制完成，这个容器的作用也就结束了，指令docker rm -f zwd_verdaccio

修改以下本地的配置文件

可以参考官方文档给的一个示例，够用 https://verdaccio.org/docs/configuration/

storage: ./storage
web:
  title: Verdaccio
auth:
  htpasswd:
    file: ./htpasswd
    max_users: 1000
    algorithm: md5
uplinks:
  npmjs:
    url: https://registry.npmjs.org/
  yarn:
    url: https://registry.yarnpkg.com/
packages:
  '@*/*':
    access: $all
    publish: $authenticated
    unpublish: $authenticated
    proxy: npmjs
  '**':
    access: $all
    publish: $authenticated
    unpublish: $authenticated
    proxy: npmjs
server:
  keepAliveTimeout: 60
listen: 0.0.0.0:4873
middlewares:
  audit:
    enabled: true
logs: { type: stdout, format: pretty, level: http }