目錄
- 原 Dockerfile 配置
- 原 nginx.conf 配置
- 修改 Dockerfile
- 修改 nginx.conf
- 打包鏡像
- 啟動容器,傳入環境變量
- 參考鏈接
當我們使用 Docker 部署 Nginx 時,可能會遇到需要根據不同環境,配置不同端口或者反向代理地址的場景。那么 Docker 的環境變量是否能夠傳遞給 Nginx 配置呢?實際是可以的,官方提供的 nginx 鏡像就支持這一操作。
本文介紹如何將 Docker 環境變量透穿給 Nginx 配置。
原 Dockerfile 配置
以下是一個前端單頁應用的 Dockerfile,基本流程是打包前端項目,復制 nginx.conf 配置,將產物放在 nginx 的網站目錄,啟動 nginx 服務。
FROM node:16-alpine as builder WORKDIR /usr/src/app/ USER root COPY package-lock.json ./ COPY package.json ./ RUN npm ci COPY ./ ./ RUN npm run build FROM nginx WORKDIR /usr/share/nginx/html/ COPY ./docker/nginx.conf /etc/nginx/conf.d/default.conf COPY --from=builder /usr/src/app/dist /usr/share/nginx/html/ EXPOSE 80 CMD ["nginx", "-g", "daemon off;"]
原 nginx.conf 配置
server {
listen 80;
# gzip config
gzip on;
gzip_min_length 1k;
gzip_comp_level 9;
gzip_types text/plain text/css text/javascript application/json application/javascript application/x-javascript application/xml;
gzip_vary on;
gzip_disable "MSIE [1-6]\.";
root /usr/share/nginx/html;
include /etc/nginx/mime.types;
location / {
try_files $uri $uri/ /index.html;
}
# 代理后端接口
location /api {
proxy_pass http://api.someserver.com;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Real-IP $remote_addr;
}
}
nginx 鏡像中自 1.19 開始已支持環境變量。只需要將 Dockerfile 中的 Nginx 配置地址放在 /etc/nginx/templates/*.template 中,并且 nginx.conf 的配置中使用 $ENV_NAME 指定對應的環境變量即可。

修改 Dockerfile
- COPY ./docker/nginx.conf /etc/nginx/conf.d/default.conf + COPY ./docker/nginx.conf /etc/nginx/templates/default.conf.template
修改 nginx.conf
- proxy_pass http://api.someserver.com; + proxy_pass $API_URL;
打包鏡像
docker build -t some-nginx .
啟動容器,傳入環境變量
docker run -d -p 80:80 -e API_URL=http://api.someserver.com some-nginx
參考鏈接
- Docker Nginx image
- Stack Overflow






