nginx源码安装启用ipv6支持需在configure时添加--with-ipv6（≥1.3版本默认启用但建议显式保留），并配置listen 80和listen [::]:80实现双栈监听，同时确保系统内核、网卡地址及防火墙均就绪。
源码安装 Nginx 时启用 IPv6 支持，关键不是“额外加模块”，而是确保编译时开启 IPv6 协议栈能力，并配合正确的运行时配置实现双栈高性能解析。Nginx 自 1.3 起已将 IPv6 支持内置，无需单独加载模块；但若使用较老版本（如 1.2.x 或更早），需显式启用 --with-ipv6 编译选项。
确认系统和内核已就绪
IPv6 功能依赖操作系统底层支持，而非仅 Nginx 本身：
- Linux 内核需启用 IPv6（默认现代发行版均已开启），可通过
cat /proc/sys/net/ipv6/conf/all/disable_ipv6检查值是否为 0 - 网卡必须分配有效 IPv6 地址（非仅
fe80::/10链路本地地址），用ip -6 addr show验证 - 防火墙（iptables/nftables）及云服务商安全组需放行 IPv6 的 TCP 80/443 端口
源码编译时的关键配置项
进入解压后的 Nginx 源码目录（如 nginx-1.26.2），执行 ./configure 时注意以下几点：
-
IPv6 支持开关：Nginx ≥1.3 默认启用 IPv6，无需指定
--with-ipv6；但为兼容性和明确性，仍可保留该参数（不报错，也不影响） -
必选功能建议一并开启：
--with-http_ssl_module（HTTPS 必需）、--with-http_v2_module（HTTP/2 提升 IPv6 下的传输效率）、--with-compat（便于后续动态模块扩展） -
性能相关选项：
--with-file-aio（异步 I/O，对高并发 IPv6 连接有益）、--with-threads（线程池支持，缓解 epoll 在海量连接下的压力）
示例完整 configure 命令：
./configure --prefix=/usr/local/nginx \--with-http_ssl_module \
--with-http_v2_module \
--with-file-aio \
--with-threads \
--with-ipv6
运行时双栈监听与性能调优
编译安装后，真正的双栈高性能解析由 Nginx 配置驱动，而非编译参数决定：
- 在
server块中同时写两行listen：listen 80;和listen [::]:80;—— 这是最清晰、最兼容的做法 - 如需更高并发吞吐，添加
reuseport（Linux 3.9+）：listen 80 reuseport;和listen [::]:80 reuseport;，让内核均衡分发连接到多个 worker 进程 - 避免使用
ipv6only=off（旧版兼容写法），现代 Nginx 默认ipv6only=on更安全；双listen已足够，无需合并监听 - 启用
http_v2并在 HTTPS 中配置 ALPN，可显著降低 IPv6 下 TLS 握手延迟
验证是否生效
启动后，用以下方式交叉验证：
- 检查监听状态：
ss -tln | grep ':80\|:443'应同时显示*:80（IPv4）和[::]:80（IPv6） - 从纯 IPv6 环境（如教育网、某些移动网络）访问站点，或用
curl -g -6 http://[2408:abcd::1]测试直连 - 查看 access log 中
$remote_addr是否出现 IPv6 地址（形如2408:abcd::123或[2408:abcd::123]）
