企业内网中绕过NPM固定URL依赖的解决方案求助

下面是几个比sidecar容器更简便的解决方案，直接针对NPM依赖的源替换问题：

方案1：直接修改package.json的依赖URL #

1. 在外网环境下载目标tgz包：

   wget https://sdk-team-cdn.decentraland.org/@dcl/protocol/branch//dcl-protocol-1.0.0-3130782694.commit-94713ab.tgz
   

2. 将这个包上传到企业内网的文件服务器（比如HTTP服务可访问的地址http://internal-file-server/dcl-protocol.tgz）
3. 在Dockerfile中添加步骤，替换package.json里的依赖地址：

   # 复制项目文件到容器
   COPY . /app
   WORKDIR /app
   
   # 替换@dcl/protocol的依赖URL为内网地址
   RUN sed -i 's#"@dcl/protocol": "https://sdk-team-cdn.decentraland.org/@dcl/protocol/branch//dcl-protocol-1.0.0-3130782694.commit-94713ab.tgz"#"@dcl/protocol": "http://internal-file-server/dcl-protocol.tgz"#' package.json
   
   # 使用公司NPM镜像安装依赖
   RUN npm install --registry=https://your-company-npm-mirror.com/
   

方案2：使用NPM的overrides字段强制替换依赖 #

这个方案不用修改原始的dependencies，而是通过overrides强制指定依赖源，更灵活：

1. 同样先把tgz包上传到内网可访问地址
2. 在Dockerfile中通过jq工具修改package.json添加overrides（如果基础镜像没有jq，先安装）：

   COPY . /app
   WORKDIR /app
   
   # 安装jq（如果基础镜像没有）
   RUN apt-get update && apt-get install -y jq
   
   # 添加overrides配置
   RUN jq '. + {"overrides": {"@dcl/protocol": "http://internal-file-server/dcl-protocol.tgz"}}' package.json > temp.json && mv temp.json package.json
   
   RUN npm install --registry=https://your-company-npm-mirror.com/
   

   如果不想安装jq，也可以手动在项目的package.json里提前添加overrides字段，再复制到容器中。

方案3：利用NPM离线缓存构建 #

适合需要频繁构建的场景，一次性缓存所有依赖：

1. 在外网环境的本地机器上执行：

   # 初始化项目并安装依赖，缓存所有包
   npm install --registry=https://your-company-npm-mirror.com/
   # 打包缓存目录
   tar -czf npm-cache.tgz ~/.npm
   

2. 将npm-cache.tgz和项目文件一起上传到内网构建环境
3. 在Dockerfile中导入缓存并离线安装：

   COPY . /app
   COPY npm-cache.tgz /tmp/
   WORKDIR /app
   
   # 解压缓存到容器的NPM缓存目录
   RUN mkdir -p ~/.npm && tar -xzf /tmp/npm-cache.tgz -C ~/.npm --strip-components=1
   
   # 离线安装依赖，无需访问外网
   RUN npm install --offline --registry=https://your-company-npm-mirror.com/
   

内容的提问来源于stack exchange，提问作者Paul