Docker Compose本地chaincode目录与容器目录同步问题求助

问题背景 #

你已经配置了Hyperledger Fabric CLI服务的Docker Compose文件：

container_name: cli
image: hyperledger/fabric-tools:$IMAGE_TAG
tty: true
stdin_open: true
environment:
  - GOPATH=/opt/gopath
working_dir: /opt/gopath/src/github.com/hyperledger/fabric/peer
command: /bin/bash
volumes:
  - ./chaincode/:/opt/gopath/src/github.com/chaincode
  - ./crypto-config:/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/
  - ./artifacts:/opt/gopath/src/github.com/hyperledger/fabric/peer/channel-artifacts

尝试用以下命令同步本地chaincode目录到容器，但容器内/opt/gopath/src/github.com/chaincode始终为空：

docker run -v ./chaincode/:/opt/gopath/src/github.com/chaincode hyperledger/fabric-tools
docker run -i -t -volumes-from hyperledger/fabric-tools bash

问题分析 #

你之前的命令存在两个核心问题：

1. 第一条docker run命令启动容器后没有保持交互模式，容器启动后立刻退出，且没有指定匹配的$IMAGE_TAG（和Compose里的版本不一致可能导致路径结构差异）；
2. 第二条volumes-from命令试图复用名为hyperledger/fabric-tools的容器卷，但这个容器本身并没有挂载你的本地chaincode目录，而且很可能已经处于退出状态，自然无法同步内容。

解决方案 #

方案1：直接使用Docker Compose启动（推荐）

你的Compose配置已经正确定义了卷挂载，直接用Compose启动CLI容器即可：

# 启动CLI容器（后台运行）
docker-compose up -d cli

# 进入容器交互终端
docker exec -it cli bash

进入容器后，你就能看到/opt/gopath/src/github.com/chaincode目录和本地目录完全同步了。

方案2：修正docker run命令手动挂载

如果需要单独用docker run启动容器，注意以下几点：

• 必须指定和Compose一致的$IMAGE_TAG（比如2.5.3，避免版本差异导致路径不匹配）；
• 使用绝对路径挂载（Linux/macOS可以用$(pwd)获取当前目录，确保Docker能识别路径）；
• 开启交互模式保证容器持续运行：

docker run -it \
  -v $(pwd)/chaincode/:/opt/gopath/src/github.com/chaincode \
  hyperledger/fabric-tools:$IMAGE_TAG \
  bash

方案3：检查本地目录权限（Linux/macOS）

如果以上操作后目录仍为空，可能是本地chaincode目录的权限问题：

• 先确认本地目录存在且有内容：ls ./chaincode/
• 调整目录权限，让容器内用户能正常访问：

sudo chmod -R 755 ./chaincode/
sudo chown -R 1000:1000 ./chaincode/

（Hyperledger Fabric容器通常使用UID/GID为1000的用户运行）

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