如何在Dockerfile中获取宿主机hostname并设为ARG适配多环境

要实现这个需求，核心是在构建镜像时把宿主机的hostname传递给Dockerfile的ARG，然后在容器里通过环境变量让entrypoint脚本可以直接使用。下面是具体的分步操作：

1. 修改docker-compose.yml，传递宿主机hostname到构建参数 #

在nginx服务的build配置里添加args，直接引用宿主机的系统环境变量（Linux/macOS下是$HOSTNAME，Windows下是%COMPUTERNAME%，docker-compose v2+已经能自动适配不同系统的环境变量）：

...
nginx:
  restart: always
  build:
    context: ./nginx
    args:
      - HOST_HOSTNAME=${HOSTNAME}  # 跨平台通用，Windows下也能识别COMPUTERNAME
  ports:
    - "80:80"
    - "443:443"
  volumes_from:
    - web
  depends_on:
    - web
  container_name: 'nginx'
...

执行docker-compose build时，会自动把当前宿主机的hostname作为HOST_HOSTNAME参数传递给Dockerfile，无需手动输入。

2. 微调Dockerfile的ARG配置（优化默认值） #

你的Dockerfile已经有了基础的ARG和ENV配置，这里可以把默认值设为空字符串，避免默认值和实际hostname冲突：

FROM nginx:latest
ARG HOST_HOSTNAME=""  # 设为空默认值，确保构建时优先使用传入的参数
ENV HOST_HOSTNAME=$HOST_HOSTNAME
COPY docker-entrypoint.sh /
RUN chmod +x /docker-entrypoint.sh
ENTRYPOINT ["/docker-entrypoint.sh"]

3. 在docker-entrypoint.sh中使用${HOST_HOSTNAME} #

现在可以直接在脚本里通过环境变量判断宿主机hostname，执行对应环境的逻辑。比如：

#!/bin/sh

# 根据宿主机hostname匹配环境规则
case "${HOST_HOSTNAME}" in
  prod-*)
    echo "启动生产环境配置..."
    # 加载生产环境的Nginx配置
    cp /etc/nginx/conf.d/prod.conf /etc/nginx/conf.d/default.conf
    ;;
  preprod-*)
    echo "启动预生产环境配置..."
    cp /etc/nginx/conf.d/preprod.conf /etc/nginx/conf.d/default.conf
    ;;
  *)
    echo "未知主机${HOST_HOSTNAME}，使用默认配置..."
    ;;
esac

# 最后启动Nginx
exec nginx -g "daemon off;"

关键说明 #

• 容器默认无法直接获取宿主机hostname：因为容器是隔离的运行环境，不能直接读取宿主机的系统信息，所以必须在构建阶段通过build-arg主动传递。
• 跨平台兼容性：上述配置在Linux、macOS、Windows上都能正常运行，docker-compose会自动解析当前系统的hostname环境变量。
• 零代码适配不同机器：只要在entrypoint.sh里写好hostname的匹配规则（比如前缀标识生产/预生产），后续在任何机器上运行时，docker-compose都会自动传递当前机器的hostname，无需修改配置或脚本。

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