### Docker 中 Nginx 的 `proxy_pass` 配置教程 在 Docker 容器中运行 Nginx 并配置 `proxy_pass` 是一种常见的需求，用于反向代理请求到其他服务或容器。以下是详细的说明以及一个完整的配置示例。 #### 1. 基本概念 当使用 `proxy_pass` 将请求转发至动态目标地址时，如果 URL 地址包含变量，则需要通过 DNS 解析来定位实际的目标服务器。此时，Nginx 必须显式声明一个 resolver 来完成此操作[^1]。 #### 2. 配置文件结构 假设我们有一个简单的场景：Docker 网络中有两个容器——一个是前端应用（监听端口 3000），另一个是后端 API 应用（监听端口 5000）。我们需要配置 Nginx 使用 `proxy_pass` 转发流量给这两个容器中的应用程序。 以下是一个典型的 Nginx 配置： ```nginx server { listen 80; server_name localhost; # Frontend application (React, Vue.js etc.) location / { proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; # Forward requests to the frontend container on port 3000 proxy_pass http://frontend:3000/; } # Backend API service location /api/ { proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; # Forward requests starting with '/api/' to backend container on port 5000 proxy_pass http://backend:5000/api/; } } ``` 上述配置实现了以下功能： - 所有根路径 `/` 下的请求会被转发到名为 `frontend` 的容器上，该容器监听的是 3000 端口。 - 对于以 `/api/` 开头的请求，它们被路由到了名为 `backend` 的容器上的 5000 端口，并保留原始 URI 结构。 #### 3. Resolver 设置 如果目标主机名不是静态 IP 或者无法预先解析成固定地址，则需引入外部 DNS 查询支持。例如，在 Kubernetes 环境下或者跨多个网络的情况下，可以这样设置： ```nginx http { ... resolver 127.0.0.11 ipv6=off valid=30s; # Use Docker's internal DNS server upstream dynamic_backend { zone backend 64k; server ${dynamic_host}:${dynamic_port}; # Variables can be used here } server { ... location /dynamic-api/ { set $target "${dynamic_host}:${dynamic_port}/"; proxy_pass http://$target; } } } ``` 这里指定了一个内部 DNS 服务器作为 resolver，确保能够实时更新目标地址的信息。 #### 4. Docker Compose 文件 为了简化多容器环境下的管理，通常会借助 `docker-compose.yml` 文件定义整个架构。下面展示了一个可能的例子： ```yaml version: '3' services: nginx: image: nginx:latest ports: - "80:80" volumes: - ./nginx.conf:/etc/nginx/conf.d/default.conf depends_on: - frontend - backend frontend: build: ./frontend expose: - "3000" backend: build: ./backend expose: - "5000" ``` 在此例子中，我们将自定义的 Nginx 配置挂载进了容器内，并依赖于另外两个分别代表前后端的服务实例。 ---