如何解决WSL2中Nginx容器配置服务器名称时的502错误？

核心问题分析 #

1. Nginx配置语法错误：你当前的set指令使用了无效变量名（test.localhost包含点且未以$开头），导致Nginx无法正确解析上游服务地址。
2. WSL2网络特性限制：Docker容器中的host.docker.internal指向Windows主机，而非运行服务的WSL2本地环境，因此无法访问WSL内的3001/3002端口服务。

分步修复 #

第一步：修正Nginx配置语法 #

将错误的set指令替换为合法变量定义，或直接指定上游地址：

server {
    listen 80;
    server_name test.localhost;
    location / {
        # 方式1：使用合法变量（推荐）
        set $upstream http://172.xx.xx.xx:3001; # 替换为WSL2的IP
        proxy_pass $upstream;

        # 方式2：直接写上游地址
        # proxy_pass http://172.xx.xx.xx:3001;

        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $remote_addr;
    }
}

server {
    listen 80;
    server_name test2.localhost;
    location / {
        set $upstream http://172.xx.xx.xx:3002; # 替换为WSL2的IP
        proxy_pass $upstream;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $remote_addr;
    }
}

第二步：解决WSL2与Docker容器的连通问题 #

以下是几种可行方案，按需选择：

方案1：使用WSL2静态IP（稳定可靠）

• 在WSL终端执行hostname -I，获取WSL2的本地IP（如172.28.156.78）
• 将上述IP替换到Nginx配置的上游地址中
• 可选：将WSL2 IP添加到Windows和WSL的hosts文件，方便后续维护：

  # Windows hosts（C:\Windows\System32\drivers\etc\hosts）
  172.28.156.78 wsl.local
  
  # WSL2 /etc/hosts
  172.28.156.78 wsl.local
  

  之后Nginx可使用http://wsl.local:3001作为上游地址

方案2：通过Docker extra_hosts映射WSL2地址

修改docker-compose.yml，添加extra_hosts字段动态映射WSL2 IP：

nginx:
    image: nginx:alpine
    container_name: nginx
    volumes:
      - ./config/nginx.conf:/etc/nginx/nginx.conf
    ports:
      - 80:80
      - 443:443
    networks:
      - backend
    extra_hosts:
      - "wsl.local:${WSL_IP}"

启动前在WSL终端执行：

export WSL_IP=$(hostname -I | awk '{print $1}')
docker-compose up -d

随后Nginx配置中可使用http://wsl.local:3001作为上游地址

方案3：使用Docker host网络模式（简单直接）

如果不需要容器独立网络，将Nginx容器切换为host模式，直接使用WSL2的网络栈：

nginx:
    image: nginx:alpine
    container_name: nginx
    volumes:
      - ./config/nginx.conf:/etc/nginx/nginx.conf
    network_mode: host # 启用host模式
    # 注释掉ports字段，因为host模式直接使用主机端口

此时Nginx配置中可直接使用http://localhost:3001访问WSL内的服务

第三步：检查防火墙配置 #

确保WSL2的防火墙允许3001/3002端口的入站连接：

sudo ufw allow 3001/tcp
sudo ufw allow 3002/tcp
sudo ufw reload

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