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

为何要搭建npm私服

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

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

方案选择

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

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

上手Verdaccio

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

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

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

1. 直接用docker启动 verdaccio

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

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

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

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

哎嘿，没了，“稍微”。

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

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

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

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

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

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

查看 /home/zwd/verdaccio

4. 设置 verdaccio 权限

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

5. 删除 zwd_verdaccio 容器

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

6. 修改以下本地的配置文件

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

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

7. 启动一个挂载目录的verdaccio镜像

指令 docker run -it -d --name zwd_verdaccio -v /home/zwd/verdaccio/conf:/verdaccio/conf -p 4873:4873 verdaccio/verdaccio

-v 后面那句表示用本地刚刚新建的配置文件代替原本容器内配置文件。

这时在浏览器端输入你的服务器IP + 4873端口，即可看见Verdaccio界面，例如我的就是 http://106.53.143.75:4873/

需要注意的前提是，你需要给你的服务器防火墙和安全规则放开4873端口

8. 文件目录的小改动

这时候回到/home/zwd/verdaccio/conf下会发现 新建了 storage 和 htpasswd，这是因为基于新的配置文件，那之前复制的文件目录里 plugins 和 storage 就无效了可删除。

这里还有个坑，需要给添加权限，指令chown -R 10001:65533 /home/zwd/docker/verdaccio/conf/htpasswd, 否则在 npm adduser 时会提示 500Error

如遇到提示报错，可通过指令docker logs --tail 20 zwd_verdaccio查看具体报错进行问题定位。

如上就可以搭建出一个npm私服。