Docker Entrypoint执行HFS二进制文件无法读取环境变量问题

问题背景 #

我正在Docker化Rejetto开发的开源项目HFS，该项目支持通过HFS_前缀的环境变量（如HFS_PORT=80）进行配置。但遇到异常：

• Docker运行时传递的环境变量能在Entrypoint脚本中通过env | grep HFS正常输出，但自动启动的HFS二进制无法读取这些变量，仍使用默认配置
• 进入同一运行中的容器手动执行./hfs时，HFS能正确读取环境变量并应用配置

相关配置 #

Dockerfile

# syntax=docker/dockerfile:1

ARG hfs_version=latest

FROM alpine AS build
WORKDIR src

ARG hfs_version
ENV HFS_VERSION=${hfs_version}

RUN apk --update --no-cache add \
  wget \
  zip

RUN wget https://github.com/rejetto/hfs/releases/download/${HFS_VERSION}/hfs-linux.zip \
  && unzip hfs-linux.zip

FROM node:20
WORKDIR hfs

COPY --from=build src/hfs ./hfs
COPY ./entrypoint.sh ./entrypoint.sh
RUN chmod +x ./hfs

ENTRYPOINT ["/bin/bash", "entrypoint.sh"]

Entrypoint脚本

#!/bin/bash

env | grep HFS
./hfs

构建与运行命令

docker build --build-arg hfs_version=v0.50.5 -t gbrlfrc/hfs:1.0.0 -f hfs.Dockerfile .
docker run -it --rm -e HFS_PORT=3838 -p 0.0.0.0:80:3838 --name hfs gbrlfrc/hfs:1.0.0

解决思路与方案 #

1. 使用exec替换当前进程启动HFS #

在Entrypoint脚本中，直接运行./hfs会以子进程形式启动，部分场景下环境变量传递可能存在异常。改用exec ./hfs让HFS取代当前bash进程，确保环境变量完全继承：

修改后的entrypoint.sh：

#!/bin/bash

env | grep HFS
exec ./hfs

2. 检查运行用户权限差异 #

node:20镜像默认以node用户运行进程，而手动进入容器时默认是root用户，可能存在权限或环境加载差异：

• 若需要以root用户运行，可在Dockerfile末尾添加：

  USER root
  

• 若坚持使用node用户，确保HFS相关文件权限正确：

  RUN chown -R node:node /hfs
  USER node
  

3. 直接以exec形式启动HFS #

如果Entrypoint脚本仅用于调试环境变量，可简化Dockerfile，直接以exec形式启动HFS，避免shell层的干扰：

ENTRYPOINT ["./hfs"]

额外排查步骤 #

• 查看HFS容器日志（docker logs hfs），确认是否有环境变量读取相关的错误提示
• 在Entrypoint脚本中打印完整环境变量（env），验证HFS_PORT确实存在
• 核对HFS官方文档，确认环境变量的命名规则与生效条件

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