对于为何要搭建私有仓库就不再过多赘述，三个关键词，稳定性、私密性和安全性，接下来直接上干货
介绍
- verdaccio是一个开源的轻量的私有的npm proxy registry（npm代理资源库）。
安装、使用都非常简单
Verdaccio官网
开始安装
官网提供了两种类型的下载方式：
- 使用docker镜像安装
- 使用npm/yarn进行全局安装；
方式一：docker镜像安装
- 拉取 Verdaccio 的 docker 镜像：
docker pull verdaccio/verdaccio
- 在根目录下创建 docker 文件
mkdir -p ~/docker/local
cd ~/docker/local
- 从 git 拉取示例到 local 到目录下
git clone https://github.com/verdaccio/verdaccio
cd ~/docker/local/docker-examples/v6
- 移动配置文件
mv docker-local-storage-volume ~/docker/verdaccio
- 设置文件夹权限
chown -R 100:101 ~/docker/verdaccio
- 启动镜像
docker run -it -d --name verdaccio \
-p 4873:4873 \
-v ~/docker/verdaccio/conf:/verdaccio/conf \
-v ~/docker/verdaccio/storage:/verdaccio/storage \
-v ~/docker/verdaccio/plugins:/verdaccio/plugins \
verdaccio/verdaccio
- 打开 http://localhost:4873 就可以看到已经启动起来了
npm 方式安装
- 全局安装 verdaccio
npm install -g verdaccio --unsafe-perm
加上 -–unsafe-perm 的原因是防止报 grywarn 权限的错。
- 修改配置文件
verdaccio 的特点是，你在哪个目录运行，它的就会在对应的目录下创建自己的文件。目录下默认有两个文件：config.yaml 和 storage，htpasswd 是添加用户之后自动创建的。
打开默认启动的 config.yaml 文件：
vim /root/.config/verdaccio/config.yaml
auth:
htpasswd:
file: ./htpasswd
# Maximum amount of users allowed to register, defaults to "+inf".
# You can set this to -1 to disable registration.
max_users: -1
uplinks:
npmjs:
url: https://registry.npmjs.org/
cnpm:
url: https://registry.npm.taobao.org
packages:
"@aemp/*":
access: $authenticated
publish: $authenticated
unpublish: $authenticated
"@*/*":
access: $all
publish: $authenticated
unpublish: $authenticated
proxy: cnpm
"**":
access: $all
publish: $authenticated
unpublish: $authenticated
proxy: cnpm
access 是访问权限控制，总共有三种身份：所有人(anonymous)、认证(登陆)用户($authenticated)。
- 对外开放 4873 端口
verdaccio 继承了 sinopia，端口号 4873 依然不变。
firewall-cmd --state # 先查看防火墙状态，
service firewalld start # 开启防火墙:
firewall-cmd --zone=public --add-port=4873/tcp –permanent # 开放4873端口
firewall-cmd --reload # 重新载入
firewall-cmd --zone=public --query-port=4873/tcp # 查看是否添加成功
- 启动 verdaccio
verdaccio
- pm2 守护 verdaccio 进程
安装 pm2：
npm install -g pm2 --unsafe-perm
- 使用 pm2 启动 verdaccio：
pm2 start verdaccio
- 查看 pm2 守护下的进程 verdaccio 的实时日志：
pm2 show verdaccio
- nginx 配置
server {
listen 443 ssl http2;
server_name registry.xxx.com;
# ssl
ssl on;
ssl_certificate cert.crt;
ssl_certificate_key cert.key;
ssl_session_timeout 5m;
ssl_protocols TLSv1.2 TLSv1.1 TLSv1; #SSL协议
ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;#SSL加密算法
ssl_prefer_server_ciphers on;
location / {
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_pass http://127.0.0.1:4873/;
proxy_read_timeout 600;
proxy_redirect off;
}
location ~ ^/verdaccio/(.*)$ {
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Host $host;
proxy_set_header X-NginX-Proxy true;
proxy_pass http://127.0.0.1:4873/$1;
proxy_redirect off;
}
}
用户管理
- 设置仓库源
npm set registry http://localhost:4873
- 添加用户
npm adduser --registry http://localhost:4873
输入 username、password 以及 Email 即可
- 登录
npm login --registry http://localhost:4873
- 上传私有包
npm publish --registry http://localhost:4873
快来试试吧
