Dockerfile无法从Docker Compose获取环境变量部署以太坊链问题

原本使用硬编码参数的Geth Dockerfile可正常运行，改用环境变量后出现参数解析错误，无法解锁账户导致容器启动失败。

现有Dockerfile #

FROM ethereum/client-go:v1.10.1

COPY ./chain/accounts/swap.ethash.genesis.json /tmp

COPY ./chain/accounts/boot.key /tmp

RUN mkdir -p /tmp/keystore

COPY ./chain/accounts/keystore/${NODE_ACCOUNT_PWD_FILENAME} /tmp/keystore

RUN geth --datadir /tmp init /tmp/swap.ethash.genesis.json \
    && rm -f ~/.ethereum/geth/nodekey 

COPY ./test-pwd.sh /tmp 
RUN chmod +x ./tmp/test-pwd.sh && ./tmp/test-pwd.sh

RUN geth --unlock 0x367103555b34Eb9a46D92833e7293D540bFd7143 --password /tmp/pwd.txt --keystore /tmp/keystore

ENTRYPOINT ["geth"]

Docker Compose配置 #

version: '3.8'

services:
  geth-bootnode:
    hostname: geth-bootnode
    env_file:
      - .env
    image: geth-client
    build:
      context: .
      args:
        - ACCOUNT_PASSWORD=${ACCOUNT_PASSWORD}
        - NODE_ACCOUNT_PWD_FILENAME=${NODE_1_ACCOUNT_PWD_FILENAME}
        - NODE_ACCOUNT_PWD=${NODE_1_ACCOUNT_PWD}
        - NODE_ACCOUNT=${NODE_1_ACCOUNT}
    command:
      --nodekeyhex="c26d705bd5933bc2be72813f1b74f140aa6b3726d2a71a43b163a5c084e9dcb4"
      --nodiscover
      --ipcdisable
      --networkid=${NETWORK_ID}
      --netrestrict="172.16.254.0/28"
    networks:
      priv-eth-net:
networks:
  priv-eth-net:
    driver: bridge
    ipam:
      config:
      - subnet: 172.16.254.0/28

错误信息 #

[9/9] RUN geth --unlock ${NODE_ACCOUNT} --password /tmp/pwd.txt --keystore /tmp/keystore:
#0 0.397 invalid command: "/tmp/pwd.txt"

已尝试操作 #

• 将Compose传递的build args转为Dockerfile的ENV变量（如ENV node_acc=${NODE_ACCOUNT}），再在RUN命令中引用，仍出现类似错误
• 将密码文件生成逻辑封装到shell脚本test-pwd.sh中，密码相关变量仍存在解析问题

问题根源与解决方法 #

1. 核心问题：构建阶段与运行阶段变量作用域混淆 #

Dockerfile中的RUN指令属于镜像构建阶段，此时只能访问通过ARG声明的构建参数；而Compose的env_file里的变量是容器运行阶段才生效的。你直接在RUN geth --unlock...中引用${NODE_ACCOUNT}，但这个变量未通过ARG声明并传递，构建阶段无法解析，导致变量被替换为空，进而让--password被当成独立命令，引发错误。

2. 正确的变量传递与配置方式 #

步骤1：Dockerfile中区分构建参数与运行环境变量

如果需要在构建阶段（如复制文件、初始化账户）和运行阶段都使用变量，需先通过ARG接收Compose传递的参数，再用ENV转为运行时环境变量：

FROM ethereum/client-go:v1.10.1

# 声明构建阶段需要的参数
ARG NODE_ACCOUNT_PWD_FILENAME
ARG NODE_ACCOUNT
ARG NODE_ACCOUNT_PWD

# 将构建参数转为运行时环境变量（供启动阶段使用）
ENV NODE_ACCOUNT=${NODE_ACCOUNT}

COPY ./chain/accounts/swap.ethash.genesis.json /tmp
COPY ./chain/accounts/boot.key /tmp

RUN mkdir -p /tmp/keystore
# 构建阶段使用ARG复制指定密码文件
COPY ./chain/accounts/keystore/${NODE_ACCOUNT_PWD_FILENAME} /tmp/keystore

RUN geth --datadir /tmp init /tmp/swap.ethash.genesis.json \
    && rm -f ~/.ethereum/geth/nodekey 

# 直接在构建阶段生成密码文件，避免依赖外部脚本
RUN echo "${NODE_ACCOUNT_PWD}" > /tmp/pwd.txt

# 构建阶段使用ARG执行账户解锁
RUN geth --unlock ${NODE_ACCOUNT} --password /tmp/pwd.txt --keystore /tmp/keystore

ENTRYPOINT ["geth"]

步骤2：修正Compose的command格式

Compose的command字段使用数组格式时，不要给参数加引号，否则引号会被当成参数的一部分传递给Geth，引发解析错误：

command:
  --nodekeyhex=c26d705bd5933bc2be72813f1b74f140aa6b3726d2a71a43b163a5c084e9dcb4
  --nodiscover
  --ipcdisable
  --networkid=${NETWORK_ID}
  --netrestrict=172.16.254.0/28

3. 可选优化：将解锁移到容器启动阶段 #

如果账户解锁不需要在镜像构建时执行，而是每次启动容器时才需要，可以修改ENTRYPOINT为shell形式，确保能解析运行时环境变量：

# 替换原ENTRYPOINT，先执行解锁再启动Geth
ENTRYPOINT ["sh", "-c", "geth --unlock ${NODE_ACCOUNT} --password /tmp/pwd.txt --keystore /tmp/keystore $@", "geth"]

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