搭建 npm 私服-编程知识

搭建 npm 私服

news/2024/12/26 19:50:22/文章来源:https://www.cnblogs.com/veinyin/p/18567259

背景

准备搭建一个自己的网站，放些平时练手的 demo，如果是不同项目，想要保持风格一致，或是要用到一些工具方法，就要在每个项目复制一份，不是很好维护，于是就想要搭建一个自己的 npm 私服

安装 verdaccio

1 安装

verdaccio，这是一个开源的私有 npm 注册中心，要注意的是，现在官网正在推行的版本是 6.x，node 版本需要 >=18，历史最新版本是 5.33.0，node 版本需要 >= 14，据官方说明 5.x 之后将不再更新

可以根据自己的现状选择要使用的版本，因为我的服务器 node 版本是 16，更新到 18之后有一系列依赖版本问题，因此使用 5.33.0

npm install -g verdaccio

安装完成之后在终端输入 verdaccio，有以下输出表示安装成功

2 配置

可以看到 config 文件的地址，在终端执行 vim /root/verdaccio/config.yaml，编辑配置文件，添加 listen: 0.0.0.0:4873

在云服务器的管理台-安全组-入方向，将 4873 端口放开，再到浏览器访问 http://服务器ip:4873，可以看到以下内容就成功了

3 用 systemctl 管理服务

执行 vim /etc/systemd/system/verdaccio.service

在 verdaccio.service 文件里加入以下内容并保存

[Unit]
Description=Verdaccio lightweight npm proxy registry[Service]
Type=simple
Restart=on-failure
#User=root
ExecStart=/root/.nvm/versions/node/v16.20.2/bin/verdaccio --config /root/verdaccio/config.yaml


[Install]
WantedBy=multi-user.target

执行 sudo systemctl daemon-reload 加载配置文件

执行 systemctl start verdaccio.service 启动服务

补充：

执行 systemctl restart verdaccio.service 重启服务

执行 systemctl stop verdaccio.service 停止服务

执行 systemctl status verdaccio.service 查看运行状态

执行 journalctl -u verdaccio.service 查看服务启动时的日志

再次在浏览器中访问，如果可以正常看到页面，就配置成功了

4 配置访问域名

给域名解析添加一条 A 记录

在服务器上添加 nginx 反向代理配置

我的配置文件统一管理在 /etc/nginx/vhost 文件夹下，所以执行 vim /etc/nginx/vhost/verdaccio.conf 添加以下内容

 server {
  listen 80;server_name registry.npm.xxx.xxx;location / {proxy_pass              http://127.0.0.1:4873/;
    proxy_set_header        Host $host;}
}

添加完成后，执行 nginx -s reload，重新加载 nginx 配置文件，让上述配置生效

5 支持 https 访问

执行 sudo certbot --nginx，为 registry.npm.xxx.xxx生成证书，支持 https 访问

实际访问后发现控制台报错，请求资源的地址还是 ip，可以 vim /root/verdaccio/config.yaml，编辑配置文件如下

再次访问发现还是不对，请求资源时还是用的 http 协议而不是 https，资源加载失败，页面空白

vim /etc/systemd/system/verdaccio.service 新增环境变量，锁定资源请求地址

[Service]
Type=simple
Restart=on-failure
#User=root
ExecStart=/root/.nvm/versions/node/v16.20.2/bin/verdaccio --config /root/verdaccio/config.yaml
Environment="VERDACCIO_PUBLIC_URL=https://registry.npm.xxx.xxx"

执行 systemctl daemon-reload，再执行 systemctl restart verdaccio.service，重启服务，页面可以正常访问