如何安装带有私有npm依赖（私有仓库）的Hyperledger Fabric链码

当然可以！Hyperledger Fabric在安装Node.js链码时，本质上是在peer节点的容器内执行npm install来解析package.json中的依赖——这意味着只要peer节点能访问到你的私有依赖源，就能正常安装私有包。下面分两种常见场景给出具体配置方法：

场景1：依赖托管在私有npm源（如公司内部源、Verdaccio） #

这种情况需要让peer节点知道私有源的地址和认证信息，最稳妥的方式是配合.npmrc文件：

1. 在你的链码根目录下创建一个.npmrc文件，填入私有源的配置和认证凭证：

   # 指定私有包的scope对应的源地址
   @your-company:registry=https://your-private-npm-registry.com/
   # 私有源的认证token（如果需要的话）
   //your-private-npm-registry.com/:_authToken=your-secure-auth-token
   

2. 在package.json的dependencies中添加你的私有包：

   {
     "dependencies": {
       "@your-company/your-private-utils": "^2.1.0"
     }
   }
   

3. 打包链码时，务必将.npmrc文件包含在打包内容里——这样peer节点在执行npm install时会自动读取配置，拉取私有源的包。

场景2：依赖托管在私有Git仓库（如GitHub/GitLab私有仓） #

如果你的私有包是放在Git私有仓库里，可以直接在package.json中指定Git地址，同时处理好认证：

方式A：HTTPS地址（简单但需注意凭证安全） #

可以在URL中嵌入Git账号的个人访问令牌（PAT）来实现认证：

{
  "dependencies": {
    "your-private-sdk": "git+https://your-username:your-pat-token@gitlab.com/your-org/private-sdk.git#v1.0.0"
  }
}

注意：这种方式会把凭证明文写在package.json里，不要提交到公开代码仓库，建议仅在测试环境临时使用，或者通过脚本动态注入。

方式B：SSH地址（更安全） #

使用SSH协议访问私有仓，需要在peer节点上配置SSH密钥对：

1. 生成SSH密钥对，将公钥添加到Git仓库的授权列表中（比如GitHub的Settings -> SSH and GPG keys）。
2. 将私钥放置在peer节点的用户目录下（通常是/root/.ssh/id_rsa，因为Fabric peer容器默认用root用户运行），确保权限设置为600。
3. 在package.json中配置依赖：

   {
     "dependencies": {
       "your-private-sdk": "git+ssh://git@gitlab.com/your-org/private-sdk.git#v1.0.0"
     }
   }
   

必须注意的关键细节 #

• 网络可达性：确保peer节点能访问到你的私有源或Git仓库——如果是内部私有服务，peer要处于同一个内网；如果是公网服务，要开放peer节点的出站访问权限。
• 凭证安全：对于敏感的认证信息（如token、SSH私钥），绝对不要硬编码到代码仓库中，可以通过CI/CD流程动态生成.npmrc或注入密钥，或者使用Fabric的链码配置功能传递敏感信息。
• 版本锁定：建议生成package-lock.json并一起打包，避免不同peer节点安装的依赖版本不一致，导致链码运行时出现兼容性问题。
• 链码打包验证：打包后可以解压检查，确认.npmrc、package.json和lock文件都在打包内容里，避免遗漏导致安装失败。

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