当前位置：首页 > 文章列表 > 文章 > php教程 > phpEnv怎么配置Nginx监听IPV6 phpEnv开启双栈支持方法

phpEnv怎么配置Nginx监听IPV6 phpEnv开启双栈支持方法

2026-05-05 20:58:01 0浏览收藏

欢迎各位小伙伴来到golang学习网，相聚于此都是缘哈哈哈！今天我给大家带来《phpEnv怎么配置Nginx监听IPV6 phpEnv开启双栈支持方法》，这篇文章主要讲到等等知识，如果你对文章相关的知识非常感兴趣或者正在自学，都可以关注我，我会持续更新相关文章！当然，有什么建议也欢迎在评论留言提出！一起学习！

Nginx在phpEnv中默认不监听IPv6，需实测nginx -V | findstr "IPv6"确认支持，不支持则替换为官方Windows版；配置必须写listen 80; listen [::]:80;，禁用ipv6only=off；并开放Windows防火墙IPv6端口、验证netstat -ano | findstr :80含[::]:80。

Nginx 在 phpEnv 中默认完全不监听 IPv6，必须手动改配置且重启服务才生效；Windows 下 ipv6only=off 基本无效，别信网上那些“加个参数就双栈”的说法。

确认 phpEnv 自带的 Nginx 是否支持 IPv6

phpEnv 是 Windows 下的集成环境，其内置 Nginx 多为精简编译版，IPv6 支持常被裁掉。不能只看版本号（如 1.24.x），得实测：

打开命令行，进入 phpEnv 的 Nginx 目录（如 D:\phpEnv\phpEnv\nginx\）
执行：nginx -V 2>&1 | findstr "IPv6"
若输出中没有 IPv6 support: enabled 或类似字样，说明不支持 —— 此时改配置也没用，需替换 Nginx
推荐直接下载官方最新 Windows 二进制包（如 nginx-1.26.0.zip），替换 phpEnv 中的 nginx 文件夹（保留原 conf/nginx.conf 和 html/）

修改 nginx.conf 启用 IPv6 监听（双栈写法）

phpEnv 的 Nginx 配置文件通常位于 D:\phpEnv\phpEnv\nginx\conf\nginx.conf。在 server 块中，**必须同时写两条 listen 指令**，不能依赖 ipv6only=off：

server {
    listen 80;
    listen [::]:80;
    server_name localhost;
    root html;
    index index.php index.html;
    # ... 其他配置
}

listen 80：绑定 IPv4 的 0.0.0.0:80
listen [::]:80：绑定 IPv6 的 :::80（注意方括号不可省）
不要写 listen [::]:80 ipv6only=off —— Windows 下该参数被忽略，还可能引发 nginx -t 报错
如果用了 HTTPS，同样要配两行：listen 443 ssl 和 listen [::]:443 ssl

检查 Windows 防火墙与本地网络环境

即使 Nginx 配置正确、也监听了 [::]:80，外部仍无法访问 IPv6 的常见原因全在这里：

运行 ipconfig，确认网卡有 global 类型 IPv6 地址（如 2001:db8::100），不是只有 fe80::/64（链路本地）
Windows 防火墙默认阻止所有 IPv6 入站 —— 必须新建入站规则：协议选 TCP、端口填 80、作用域勾选“任何 IP 地址”、操作设为“允许连接”
phpEnv 自带的“服务管理器”里点击“重启 Nginx”往往不生效，应手动执行：nginx -s stop && nginx（在 Nginx 目录下）
验证是否真在监听：netstat -ano | findstr :80，看到 TCP [::]:80 才算成功

测试 IPv6 访问时最容易忽略的点

很多人改完就去浏览器输 http://[::1]/，结果 404 或连接失败，其实问题不在 Nginx：

浏览器地址栏输 IPv6 地址必须加方括号：http://[::1]/，http://::1/ 会当成域名解析失败
局域网其他设备访问时，对方设备必须已启用 IPv6 协议栈（Win10/11 默认开，老系统或某些路由器 LAN 口可能关着）
phpEnv 的 PHP-FPM 默认只监听 127.0.0.1:9000，若 Nginx 用 fastcgi_pass 127.0.0.1:9000，IPv6 请求进来后仍能走通；但若改成 fastcgi_pass [::1]:9000，需确保 PHP-FPM 也监听了 IPv6（phpEnv 一般不监听，不建议改）
真正需要双栈的是 Nginx 接入层，PHP 层保持 IPv4 回环通信即可，这是最稳的组合

今天关于《phpEnv怎么配置Nginx监听IPV6 phpEnv开启双栈支持方法》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于phpenv的内容请关注golang学习网公众号！

phpenv