如何在Nginx配置中避免硬编码服务器IP以适配Docker跨环境部署

很简单，在Docker Compose环境里我们完全可以摆脱硬编码IP的困扰——Docker自带的服务发现机制能帮我们自动处理容器间的网络访问，不用关心容器实际分配的IP地址。下面是具体的修改方案：

1. 修改Nginx配置文件 #

把硬编码的IP替换成Docker Compose中定义的服务名，同时调整server_name让配置更通用：

server {
 listen 80 default_server;
 server_name _; # 匹配所有请求的主机名，也可以换成你的实际域名，比如example.com

 location / {
 proxy_set_header Host $host;
 proxy_set_header X-Forwarded-For $remote_addr;
 proxy_set_header X-Real-IP $remote_addr;
 proxy_pass http://api:3000; # 用docker-compose里的服务名`api`代替硬编码IP
 }
}

关键说明： #

• server_name _;：如果你的服务不需要绑定特定域名，这个配置会接收所有80端口的请求；如果有固定域名，直接替换成你的域名即可。
• proxy_pass http://api:3000;：Docker Compose会自动创建内部DNS，把服务名api解析到对应容器的IP地址，哪怕容器重启后IP变化也能正常访问。

2. 优化Docker Compose配置（可选） #

你的现有配置已经能正常工作，但如果不需要让宿主机直接访问api服务，可以移除api的ports字段（这个字段是用来把容器端口暴露给宿主机的），这样只有Nginx能访问api，安全性更高：

version: "3"
services:
 api:
 build: .
 # 移除不需要的宿主机端口映射，仅保留容器间访问
 # ports:
 # - ${PORT}:3000
 nginx:
 image: nginx:latest
 volumes:
 - ./deploy/certs:/deploy/certs
 - ./deploy/nginx/conf.d:/etc/nginx/conf.d
 ports:
 - 80:80/tcp
 - 443:443/tcp
 restart: always

进阶：用环境变量动态配置（可选） #

如果需要在不同环境中灵活调整配置（比如不同的域名或服务名），可以用Nginx的环境变量替换功能：

1. 先把Nginx配置改成模板文件（比如命名为default.conf.template）：

server {
 listen 80 default_server;
 server_name ${SERVER_NAME};

 location / {
 proxy_set_header Host $host;
 proxy_set_header X-Forwarded-For $remote_addr;
 proxy_set_header X-Real-IP $remote_addr;
 proxy_pass http://${API_SERVICE}:3000;
 }
}

2. 然后修改Docker Compose中的nginx服务，添加环境变量并在启动时替换模板：

nginx:
 image: nginx:latest
 volumes:
 - ./deploy/certs:/deploy/certs
 - ./deploy/nginx/conf.d:/etc/nginx/conf.d
 environment:
 - SERVER_NAME=_
 - API_SERVICE=api
 # 启动时替换模板中的环境变量，然后启动Nginx
 command: /bin/bash -c "envsubst < /etc/nginx/conf.d/default.conf.template > /etc/nginx/conf.d/default.conf && nginx -g 'daemon off;'"
 ports:
 - 80:80/tcp
 - 443:443/tcp
 restart: always

这样就能通过修改环境变量快速适配不同部署环境，完全不用改动Nginx配置文件本身。

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