搭建npm离线仓库


难度 中等

要在离线环境下使用 Docker 和 Verdaccio 搭建私有的 npm 镜像仓库,你可以按照以下步骤进行操作:

1. 安装 Docker

确保你的系统上已经安装了 Docker。如果没有安装,请参考 Docker 的官方文档进行安装。

2. 拉取 Verdaccio 镜像

由于是离线环境,首先在有网络的环境下拉取 Verdaccio 的 Docker 镜像,并导出为一个文件:

docker pull verdaccio/verdaccio
docker save -o verdaccio.tar verdaccio/verdaccio

3. 在离线环境下加载 Docker 镜像

将导出的 verdaccio.tar 文件拷贝到离线环境的机器上,然后使用以下命令加载镜像:

docker load -i verdaccio.tar

4. 启动 Verdaccio 容器

在离线环境下启动 Verdaccio 容器,可以使用以下命令:

docker run -d --name verdaccio -p 4873:4873 verdaccio/verdaccio

此命令会在后台启动 Verdaccio,并将其服务暴露在主机的 4873 端口。

5. 配置离线 npm 镜像

你可以通过 Verdaccio 的配置文件来控制缓存的包数量和清理策略。通常情况下,默认的配置已经足够使用。

默认的配置文件路径在容器内为 /verdaccio/conf/config.yaml。如果需要进行自定义配置,可以先将配置文件拷贝出来进行修改:

docker cp verdaccio:/verdaccio/conf/config.yaml ./config.yaml

修改完成后,将其复制回容器中:

docker cp ./config.yaml verdaccio:/verdaccio/conf/config.yaml

然后重启容器以应用新配置:

docker restart verdaccio

6. 配置 npm 使用私有仓库

在客户端机器上,通过以下命令将 npm 的 registry 设置为你的 Verdaccio 私有仓库:

npm set registry http://<your-server-ip>:4873/

现在,你可以正常使用 npm 安装和发布包了。

7. 离线环境下的包管理

  • 下载依赖包: 你可以在有网络的环境下预先下载所需的 npm 包,并将它们传输到离线环境中。例如,使用 npm pack 下载所需的包。
  • 上传包到 Verdaccio: 使用 npm publish 命令将包发布到 Verdaccio 私有仓库中。这样,离线环境中的其他机器也可以从你的私有仓库中安装这些包。

至此,你已经在离线环境中成功搭建了 Verdaccio npm 镜像仓库。

npm pack下载离线包

npm pack 通常用于将某个 npm 包打包成 .tgz 文件,而不是直接用于下载项目的依赖包。如果你想要在离线环境中使用某个项目的所有依赖包,可以按照以下步骤操作:

1. 在有网络的环境中安装依赖

首先,在有网络的环境中,进入你的项目目录并安装所有依赖包:

npm install

这会根据项目中的 package.json 文件安装所有依赖,并将它们下载到 node_modules 文件夹中。

2. 使用 npm pack 打包依赖包

接下来,你需要将 node_modules 中的每个依赖包打包成 .tgz 文件。你可以使用 npm pack 逐个包打包,但手动操作会比较繁琐。为此,可以编写一个脚本来自动打包所有依赖。

下面是一个 Bash 脚本示例,能够打包 node_modules 中的每个包:

#!/bin/bash

# 创建一个目录来存放打包的文件
mkdir -p npm-packages

# 遍历 node_modules 目录并打包每个依赖包
for package in $(ls node_modules); do
  # 忽略 bin 和 .bin 目录
  if [[ "$package" != ".bin" && "$package" != "bin" ]]; then
    # 进入包目录
    cd "node_modules/$package"

    # 打包包并将结果放入上一级的 npm-packages 目录中
    npm pack --pack-destination=../../npm-packages

    # 回到项目根目录
    cd ../../
  fi
done

这个脚本会遍历 node_modules 目录下的所有依赖包,并使用 npm pack 将它们打包到 npm-packages 文件夹中。

3. 传输依赖包到离线环境

将 npm-packages 文件夹传输到离线环境中。在离线环境中,进入该文件夹并逐个安装 .tgz 文件:

npm install ./package-name-version.tgz

你也可以将这些 .tgz 文件发布到 Verdaccio 私有仓库中,供其他项目使用。

4. 安装依赖包

在离线环境中,执行以下命令安装本地 .tgz 包或从 Verdaccio 仓库中拉取依赖:

npm install

这样就可以在离线环境中正确安装所需的依赖包了。

通过以上方法,你可以在有网络的环境中准备好项目所需的依赖包,然后将它们传输到离线环境中进行安装和使用。

要将 node_modules 目录下的所有包发布到 Verdaccio 私有仓库,可以按照以下步骤进行操作。由于 node_modules 目录中包含大量依赖包,这些包可能已经在公共 npm 仓库中存在,因此手动逐个发布效率较低。为了简化操作,可以编写脚本来自动化发布流程。

1. 设置 npm Registry 指向 Verdaccio

首先,确保 npm 指向你的 Verdaccio 私有仓库:

npm set registry http://<your-verdaccio-server>:4873/

2. 登录到 Verdaccio

使用 npm adduser 登录到 Verdaccio 仓库:

npm adduser --registry http://<your-verdaccio-server>:4873/

输入用户名、密码和电子邮件地址。

3. 编写脚本发布 node_modules 中的包

你可以编写一个脚本,自动遍历 node_modules 目录,并将每个包发布到 Verdaccio 仓库中。

以下是一个简单的 Bash 脚本示例,能够发布 node_modules 中的包:

#!/bin/bash

# 设置 Verdaccio 仓库地址
VERDACCIO_REGISTRY="http://<your-verdaccio-server>:4873/"

# 遍历 node_modules 目录中的包
for package in $(ls node_modules); do
  # 忽略 .bin 目录和 scoped packages
  if [[ "$package" != ".bin" && "$package" != "@"* ]]; then
    # 进入包目录
    cd "node_modules/$package"
    
    # 创建 package.json 文件的副本
    cp package.json package.json.bak
    
    # 确保 version 字段存在且唯一
    npm version patch --no-git-tag-version

    # 发布包到 Verdaccio
    npm publish --registry $VERDACCIO_REGISTRY

    # 恢复原始的 package.json 文件
    mv package.json.bak package.json

    # 返回项目根目录
    cd ../../
  fi
done

注意事项:

  • 该脚本仅发布顶级依赖(非嵌套依赖包),如果你需要发布嵌套依赖包,也可以调整脚本递归遍历。
  • 使用 npm version patch --no-git-tag-version 确保每次发布时包的版本号都递增,避免重复发布相同版本的包。

4. 发布 Scoped Packages (如果有)

如果你的项目使用了 Scoped Packages(如 @scope/package-name),它们会存储在 node_modules/@scope/ 目录下。可以通过修改脚本来处理这部分包:

# 遍历 Scoped Packages
for scope in $(ls node_modules | grep "^@"); do
  for package in $(ls node_modules/$scope); do
    cd "node_modules/$scope/$package"
    
    cp package.json package.json.bak
    npm version patch --no-git-tag-version
    npm publish --registry $VERDACCIO_REGISTRY
    mv package.json.bak package.json
    
    cd ../../../
  done
done

这个部分脚本会处理 node_modules 目录中的 Scoped Packages。

5. 检查发布结果

完成后,你可以通过访问 Verdaccio Web 界面或使用 npm view 命令来验证发布的包:

npm view <package-name> --registry http://<your-verdaccio-server>:4873/

6. 使用发布的包

在项目中,通过配置 npm 指向 Verdaccio 仓库来使用刚发布的包:

npm install <package-name>

注意事项

  • 重复发布: 避免重复发布同一版本的包。确保每个包的版本号在发布前递增。
  • 发布顺序: 如果依赖包之间存在依赖关系,确保先发布底层依赖再发布上层依赖。

通过这些步骤,你可以批量发布 node_modules 目录下的所有包到 Verdaccio 私有仓库。


文章作者: growdu
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 growdu !
  目录
分类导航
随笔3 AI29 计算机基础13 算法1 博客搭建7 ChatGPT2 集群63 计算机通信1 数据库59 数据库深入93 数据库93 Docker11 DPDK26 编辑工具4 Elasticsearch4 FAQ1 Go Web1 hometown2 编程语言16 人生11 网络9 Linux38 OPC1 openGauss4 页面12 PostgreSQL54 程序员自我修养1 协议11 stock1 存储5 成长之路1 工具20 视频作品1 VPP18 Vue13 Web1 代码示例11 BenchmarkSQL1 PostgreSQL 源码修炼之路14
最热文章
1
PostgreSQL 逻辑复制全链路:以一个真实事务为例,从 `INSERT` 到 `apply` 的源码级旅程
数据库🔥 2162
2
PostgreSQL 逻辑复制 Stream 执行逻辑源码级拆解:从 reorderbuffer 触发到订阅端落盘回放
数据库🔥 1765
3
PostgreSQL 行锁机制源码级深度拆解:4 种锁模式 + xmax + MultiXact 的完整链路
数据库🔥 1656
4
PostgreSQL reorderbuffer.c 函数级源码全集:5615 行 / 95 个函数的逐函数解析
数据库深入🔥 1650
5
PostgreSQL 目录快照源码级深度拆解:系统表读取的 MVCC 真相与失效机制
数据库🔥 1604
6
13 逻辑复制深入
数据库深入🔥 1570
7
0 Postgresql存储、索引及系统优化、主备切换
PostgreSQL🔥 1495
8
PostgreSQL 读一行数据源码级深度拆解:MVCC 在每个环节的落点
数据库🔥 1464
9
PostgreSQL WAL 记录类型完全指南:21 个 RMGR × 80+ 种记录的源码级拆解
数据库🔥 1431
10
一文读懂openguass dcf网络模块
集群🔥 1420
11
PostgreSQL 元数据存储机制:从磁盘文件到内存缓存,`pg_class` 撑起的整个系统表体系
数据库🔥 1411
12
openGauss 并行解码设计原理深度拆解:reader + 多 worker + CSN 三层架构的源码级剖析
数据库深入🔥 1344
13
逻辑复制源码分析
数据库深入🔥 1327
14
PostgreSQL 逻辑复制:catalog 改动、可见性判定与 xmin/xmax 推进全景
数据库深入🔥 1317
15
自托管服务全家桶:从原文方案到可复制实操手册
人生🔥 1278
16
PostgreSQL CREATE_REPLICATION_SLOT 端到端源码分析:从 SQL 到 snapbuild 状态机的完整链路(每个函数每个参数)
数据库深入🔥 1277
17
PostgreSQL syscache 模块源码深度拆解:CatCache 数据结构、LRU 哈希表、cache invalidation 全链路
数据库深入🔥 1216
18
PostgreSQL 18 内核数据结构全景:RangeVar 与 20+ 个核心数据结构源码级拆解
数据库🔥 1158
19
PostgreSQL 逻辑复制里 `RUNNING_XACTS` 写入机制与快照 `xmin / xmax / xip` 的演化:源码级深度拆解
数据库🔥 1119
20
PostgreSQL 分区表:从一行 `PARTITION BY` 到路由热路径的全链路拆解
数据库🔥 1094