Docker主机网络模式下NextJS容器启动失败：地址不可用

核心原因 #

在--net=host模式下，容器直接复用宿主机的网络栈，包括所有IPv4/IPv6网络接口。NextJS默认会尝试监听所有可用网络地址（IPv4的0.0.0.0和IPv6的::），但宿主机上的fdc4:f303:9324::7这个IPv6地址可能处于未激活、无路由或不可用状态，导致NextJS无法绑定到该地址，抛出EADDRNOTAVAIL错误。

解决方案 #

1. 强制NextJS仅监听IPv4地址 #

修改容器的启动命令，让NextJS只绑定到IPv4的0.0.0.0地址，避免尝试绑定不可用的IPv6地址：

• 直接在docker run命令中覆盖启动命令：

  docker run --net=host --name myapp_ui myimage_ui next start -H 0.0.0.0
  

• 或者修改Dockerfile，通过环境变量或启动参数固化配置：

  # 方式1：设置环境变量
  ENV HOST=0.0.0.0
  CMD ["npm", "run", "start"]
  
  # 方式2：直接指定启动参数
  CMD ["next", "start", "-H", "0.0.0.0"]
  

重新构建镜像后再启动容器即可。

2. 检查并清理宿主机无效IPv6地址 #

如果需要保留IPv6监听，可以先排查宿主机的IPv6配置：

• 执行ip -6 addr查看所有IPv6地址，确认fdc4:f303:9324::7是否存在且处于UP状态
• 如果该地址是无效或多余的，可通过ip -6 addr del fdc4:f303:9324::7/[前缀长度] dev [网卡名]删除，或禁用对应网卡的IPv6功能

关于IPv6地址的疑问 #

--net=host模式下，容器并非被“分配”IPv6地址，而是直接共享宿主机的所有网络接口和地址。NextJS默认的监听策略会遍历宿主机的所有网络地址尝试绑定，因此才会出现针对该IPv6地址的错误。

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