我明白你的痛点——不想每次部署都手动修改配置，希望Nginx能智能适配主机的IPv6支持情况。下面我给你两个可行的自动解决方案，都是无需手动干预的：

方案一：自定义Entrypoint脚本动态修改配置 #

这个思路是在Nginx启动前，先检查主机是否支持IPv6，再修改配置文件移除IPv6监听规则，避免启动报错。

步骤1：编写Entrypoint脚本 #

创建一个名为nginx-entrypoint.sh的脚本，内容如下：

#!/bin/sh
set -e

# 检查主机是否启用IPv6（通过检查/proc/net/if_inet6文件是否存在）
if [ ! -f /proc/net/if_inet6 ]; then
    echo "检测到主机未启用IPv6，移除Nginx配置中的IPv6监听规则"
    # 替换你的配置文件路径，这里假设是/etc/nginx/conf.d/your-app.conf
    sed -i '/listen \[::\]:8080 ssl/d' /etc/nginx/conf.d/your-app.conf
else
    echo "主机已启用IPv6，保留IPv6监听规则"
fi

# 启动Nginx
exec nginx -g 'daemon off;'

步骤2：在Docker Compose中配置 #

修改你的docker-compose.yml，挂载这个脚本并设置为容器的entrypoint：

services:
  nginx:
    image: nginx:alpine
    volumes:
      - ./your-app.conf:/etc/nginx/conf.d/your-app.conf
      - ./nginx-entrypoint.sh:/usr/local/bin/nginx-entrypoint.sh
    entrypoint: ["nginx-entrypoint.sh"]
    ports:
      - "8080:8080"
      - "[::]:8080:8080"  # Docker会自动跳过主机不支持的端口绑定，不会报错
    # 其他配置（比如证书挂载）...

原理说明 #

• 脚本通过/proc/net/if_inet6文件判断IPv6是否启用（这是Linux系统的标准方式）
• 如果未启用，就用sed删除配置中IPv6的listen行
• Docker的端口绑定中即使写了[::]:8080，主机无IPv6时只会出现警告，不会导致容器启动失败

方案二：用Envsubst生成动态配置文件 #

这个方案更灵活，通过模板文件和环境变量自动生成最终的Nginx配置，避免修改原配置文件。

步骤1：创建Nginx配置模板 #

把你的配置文件改成模板（比如命名为app.conf.template），将IPv6监听规则替换为环境变量占位符：

server {
  listen 8080 ssl;
  # 动态生成IPv6监听规则
  ${LISTEN_IPV6}
  server_name localhost;
  ssl on;
  ssl_certificate /etc/nginx/cert.pem;
  ssl_certificate_key /etc/nginx/key.pem;
  # 其他配置...
}

步骤2：编写Entrypoint脚本 #

创建nginx-entrypoint.sh脚本，根据IPv6支持情况设置环境变量，再用envsubst生成最终配置：

#!/bin/sh
set -e

# 设置LISTEN_IPV6变量
if [ -f /proc/net/if_inet6 ]; then
    export LISTEN_IPV6="listen [::]:8080 ssl ipv6only=on;"
else
    export LISTEN_IPV6=""
fi

# 用模板生成最终配置文件
envsubst '$LISTEN_IPV6' < /etc/nginx/conf.d/app.conf.template > /etc/nginx/conf.d/default.conf

# 启动Nginx
exec nginx -g 'daemon off;'

步骤3：Docker Compose配置 #

services:
  nginx:
    image: nginx:alpine
    volumes:
      - ./app.conf.template:/etc/nginx/conf.d/app.conf.template
      - ./nginx-entrypoint.sh:/usr/local/bin/nginx-entrypoint.sh
      - ./cert.pem:/etc/nginx/cert.pem
      - ./key.pem:/etc/nginx/key.pem
    entrypoint: ["nginx-entrypoint.sh"]
    ports:
      - "8080:8080"
      - "[::]:8080:8080"

为什么之前的分离配置会报错？ #

你之前尝试的listen 8080 ssl; listen [::]:8080 ssl ipv6only=on;会报错，是因为Nginx启动时会尝试绑定所有配置的监听端口，只要其中一个绑定失败（比如IPv6端口），整个Nginx进程就会退出。所以必须在启动前就移除或不生成那个失败的监听规则，而不是让Nginx去尝试绑定。

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