这是个很常见的部署需求，核心思路是把Nginx配置文件做成模板，然后在容器启动或构建阶段用环境变量替换占位符。我给你分步骤拆解最实用的两种实现方式，优先推荐灵活度更高的启动时替换方案：

1. 准备模板化的Nginx配置文件 #

先把你的nginx.conf改成模板格式，把需要动态替换的内容（比如域名）用${变量名}作为占位符。比如命名为nginx.conf.template：

server {
    listen 80;
    server_name ${HOSTNAME}; # 这里用环境变量占位符

    location / {
        root /usr/share/nginx/html;
        index index.html index.htm;
    }
}

把这个模板文件放在你的项目根目录，和Dockerfile、docker-compose.yml同级。

2. 编写Dockerfile和入口脚本（启动时替换） #

这种方式不需要每次改环境变量都重新构建镜像，灵活性更强。

首先创建一个entrypoint.sh脚本，用来在容器启动时替换模板中的环境变量：

#!/bin/sh
# 替换模板中的HOSTNAME变量，生成最终的Nginx配置
envsubst '${HOSTNAME}' < /etc/nginx/conf.d/nginx.conf.template > /etc/nginx/conf.d/default.conf
# 启动Nginx（保持前台运行，符合Docker容器规范）
exec nginx -g 'daemon off;'

然后编写Dockerfile，复制模板和脚本，设置容器启动入口：

FROM nginx:alpine

# 复制模板文件到Nginx的配置目录
COPY nginx.conf.template /etc/nginx/conf.d/
# 复制自定义的入口脚本
COPY entrypoint.sh /usr/local/bin/
# 给脚本添加执行权限
RUN chmod +x /usr/local/bin/entrypoint.sh

# 设置容器启动时执行的脚本
ENTRYPOINT ["entrypoint.sh"]

注：如果用的是Debian版Nginx镜像（不是alpine），需要先安装gettext-base包（添加RUN apt-get update && apt-get install -y gettext-base），因为envsubst工具属于这个包。

3. 配置docker-compose.yml传递环境变量 #

在docker-compose.yml中直接定义环境变量，启动时会传递给容器：

version: '3.8'

services:
  web-app:
    build: .
    ports:
      - "80:80"
    # 这里设置你需要的环境变量
    environment:
      - HOSTNAME=example.com
    # 可选：挂载你的Web应用静态文件到容器内
    volumes:
      - ./your-web-content:/usr/share/nginx/html

现在执行docker-compose up --build，容器启动时就会自动把HOSTNAME=example.com替换到Nginx配置里了。

可选：构建时替换的方案 #

如果你的环境变量不会频繁修改，也可以在构建镜像时就完成替换：

修改Dockerfile，用ARG接收构建参数，再用ENV固化，最后替换模板：

FROM nginx:alpine

# 定义构建时参数
ARG HOSTNAME
# 将构建参数转为环境变量（可选，若只在构建时用可以省略）
ENV HOSTNAME=${HOSTNAME}

COPY nginx.conf.template /etc/nginx/conf.d/
# 构建阶段直接替换模板生成最终配置
RUN envsubst '${HOSTNAME}' < /etc/nginx/conf.d/nginx.conf.template > /etc/nginx/conf.d/default.conf

然后在docker-compose.yml中传递构建参数：

version: '3.8'

services:
  web-app:
    build:
      context: .
      args:
        - HOSTNAME=example.com
    ports:
      - "80:80"
    volumes:
      - ./your-web-content:/usr/share/nginx/html

这种方式的缺点是：每次修改环境变量都需要重新构建镜像，适合变量固定的场景。

注意事项 #

• 如果需要替换多个环境变量，要在envsubst里明确列出所有变量，比如envsubst '${HOSTNAME} ${PORT} ${API_URL}'，避免误替换Nginx配置中原本的$uri、$request_uri等内置变量。
• 确保模板文件的路径和脚本、Dockerfile中的路径一致，避免找不到文件的错误。

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