从零开始构建私有npm仓库

对于为何要搭建私有仓库就不再过多赘述，三个关键词，稳定性、私密性和安全性，接下来直接上干货

介绍

• 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

快来试试吧