2024年Win11无Docker Desktop的WSL2中访问Docker localhost问题

• 环境：Windows 11 + WSL2（未安装Docker Desktop）
• 现象：执行docker run --rm -ti -p 80:80 nginx可通过localhost正常访问，但自定义Next.js容器无法通过localhost或其他IP访问
• 相关配置：

  docker-compose.yml #

  version: '3.8'
  
  services:
    web:
      image: easypanel-nextjs:0.0.1
      build:
        context: .
        dockerfile: Dockerfile
      container_name: nextjs-sqlite
      env_file:
        - .env.production
      ports:
        - 3000:3000
      volumes:
        - ./data:/data
  

  Dockerfile #

  EXPOSE 3000
  
  ENV PORT 3000
  ENV HOSTNAME localhost
  

• 已尝试无效方案：使用WSL2 IP、0.0.0.0:3000、127.0.0.1:3000、host.docker.internal:3000访问；修改.wslconfig开启localhost转发和镜像网络模式并重启WSL；尝试无重启脚本但报错
• 临时可行方案：将Dockerfile中ENV HOSTNAME改为0.0.0.0；注释ENV PORT 3000和ENV HOSTNAME localhost

直接修改Dockerfile中的HOSTNAME环境变量为0.0.0.0，修改后内容如下：

EXPOSE 3000

ENV PORT 3000
ENV HOSTNAME 0.0.0.0

或者更简洁的方式：删除ENV HOSTNAME localhost这一行——Next.js在未指定HOST/HOSTNAME环境变量时，默认会监听0.0.0.0，允许外部访问。

容器内的服务如果绑定localhost（即127.0.0.1），仅能在容器内部被访问，WSL2的端口转发机制无法将外部请求路由到容器的127.0.0.1地址。而Nginx默认监听0.0.0.0（允许所有网卡地址访问），所以能正常通过localhost访问。修改Next.js的监听地址为0.0.0.0后，服务会绑定容器的所有网卡，WSL2的端口转发就能正常将Windows主机的localhost请求转发到容器服务上。

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