如何用配置文件自定义Docker与IPFS？运行容器遇挂载错误求助

问题分析 #

从你给出的错误信息和命令来看，主要存在两个核心问题：

1. 挂载路径类型不匹配：Docker尝试将主机的/home/ubuntu/.ipfs/config挂载到容器内的/data/ipfs/config时提示“不是目录”——这大概率是因为主机端的路径类型不对（比如误把目录当成了文件），或者容器启动时/data/ipfs目录未初始化，导致Docker误判了目标路径的类型。
2. 命令参数错误：你在镜像名称后直接加了IPFS哈希值，这会让容器执行ipfs <哈希>，但这并不是有效的IPFS子命令（如果是想pin这个哈希，正确的写法应该是pin add <哈希>）。

解决方案 #

第一步：排查并修复挂载路径问题 #

先确认主机端配置文件的类型，执行以下命令：

ls -l /home/ubuntu/.ipfs/config

• 如果输出开头是d：说明你把目录当成文件挂载了，需要删除这个错误的目录，确保/home/ubuntu/.ipfs/config是一个合法的IPFS配置文件（可以从本地已初始化的IPFS节点复制，或者手动编写）。
• 如果输出开头是-：说明这是正确的文件，继续下一步操作。

第二步：正确使用自定义配置启动容器 #

推荐两种稳妥的方式来实现自定义配置的IPFS节点启动：

方式1：先初始化数据卷，再替换配置（更稳定）

1. 启动临时容器初始化IPFS数据卷，生成基础的目录结构和配置：

   sudo docker run --rm -v /tmp/ipfs-docker-data:/data/ipfs jbenet/go-ipfs:latest init
   

2. 将你的自定义配置文件复制到数据卷中，覆盖默认配置：

   sudo cp /home/ubuntu/.ipfs/config /tmp/ipfs-docker-data/config
   

3. 启动正式的IPFS节点，同时添加pin哈希的正确参数：

   sudo docker run -d --name ipfs-node \
   -v /tmp/ipfs-docker-staging:/export \
   -v /tmp/ipfs-docker-data:/data/ipfs \
   -p 8080:8080 -p 4001:4001 -p 127.0.0.1:5001:5001 \
   jbenet/go-ipfs:latest pin add ee613bda861afb7af65a2e9ba414f4421f76e232fcc4e10aee835038143372ca
   

方式2：直接挂载配置文件（需确保文件存在）

如果想直接挂载主机的配置文件，需要先确保容器内的/data/ipfs目录存在，避免Docker自动将其创建为目录。可以通过指定--entrypoint先创建目录，再启动IPFS：

sudo docker run -d --name ipfs-node \
-v /tmp/ipfs-docker-staging:/export \
-v /tmp/ipfs-docker-data:/data/ipfs \
-v /home/ubuntu/.ipfs/config:/data/ipfs/config \
-p 8080:8080 -p 4001:4001 -p 127.0.0.1:5001:5001 \
--entrypoint sh jbenet/go-ipfs:latest -c "mkdir -p /data/ipfs && ipfs pin add ee613bda861afb7af65a2e9ba414f4421f76e232fcc4e10aee835038143372ca && ipfs daemon"

验证启动状态 #

执行以下命令查看容器日志，确认节点是否正常启动：

sudo docker logs ipfs-node

如果日志中出现Daemon is ready的提示，说明节点启动成功，你可以通过http://127.0.0.1:5001/webui访问IPFS WebUI进行后续操作。

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