宝塔面板如何配置IPv6访问_修改监听配置与防火墙-php教程-PHP中文网

宝塔面板启用IPv6需三步：1. 创建空文件/www/server/panel/data/ipv6.pl并写入::，再重启面板；2. 手动为Nginx各网站配置添加listen [::]:80;和listen [::]:443 ssl http2;；3. 系统防火墙与云安全组须显式放行IPv6端口，并配置DNS AAAA记录。

宝塔面板如何配置ipv6访问_修改监听配置与防火墙

宝塔面板自身监听IPv6必须改配置文件并重启

只在面板后台勾选“监听IPv6”不生效，echo '::' > /www/server/panel/data/ipv6.pl 这一步不可跳过，否则面板仍只监听 IPv4 的 8888 端口。

执行完后必须运行 /etc/init.d/bt restart，单纯重载 Nginx 或刷新页面没用。验证方式是用另一台支持 IPv6 的机器访问 https://[你的IPv6地址]:8888，如果连接被拒绝，说明监听未真正启用。

常见错误：勾选了面板设置里的选项但没执行命令，导致 netstat -tlnp | grep :8888 只显示 *:8888（IPv4 any），没有 [::]:8888
注意 /www/server/panel/data/ipv6.pl 是一个空文件，内容仅为 ::，不是 JSON 或配置项，写错格式（如加引号、换行）会导致失败
部分低版本宝塔（如 7.9.x 之前）不支持该机制，需升级到 8.0+ 再操作

Nginx 配置里 listen [::]:80 和 listen [::]:443 必须手动加

宝塔不会自动为已有网站补全 IPv6 监听指令，哪怕你开启了面板 IPv6 支持。每个网站的配置文件都要单独编辑，在对应 server 块里插入两行：

listen [::]:80;
listen [::]:443 ssl http2;

不能只写 listen [::]:80 ssl http2;（没开 HTTPS 的网站加 ssl 会启动失败），也不能把 [::] 写成 :: 或 [:::]——语法错误会导致 Nginx 重载失败，面板会提示“配置错误”。

SSL 网站务必确认原有 listen 443 ssl http2; 行存在，再在其下方加 IPv6 版本，顺序不影响，但缺失原始行会导致 HTTP/2 不生效
若使用了自定义端口（如 8080），也要同步加 listen [::]:8080;，否则 IPv6 用户无法访问该端口
加完保存后，点【重载配置】而非【保存】，否则变更不会加载进运行中的 Nginx 进程

系统防火墙和云厂商安全组都要放行 IPv6 端口

Linux 自带的 firewalld 或 ufw 默认不管理 IPv6 规则，即使 IPv4 的 80/443/8888 已放行，IPv6 流量仍会被静默丢弃。

以 firewalld 为例，必须显式添加：

firewall-cmd --permanent --add-port=80/tcp --zone=public
firewall-cmd --permanent --add-port=80/tcp --zone=public --ipset=ipv6
firewall-cmd --permanent --add-port=443/tcp --zone=public --ipset=ipv6
firewall-cmd --permanent --add-port=8888/tcp --zone=public --ipset=ipv6
firewall-cmd --reload

注意：--ipset=ipv6 是关键，漏掉就只作用于 IPv4；Ubuntu 用户用 ufw 则需确认 /etc/default/ufw 中 IPV6=yes 已启用，并执行 ufw allow 80/tcp 等命令（ufw 默认对 IPv6 生效）。

腾讯云、阿里云、Vultr 等平台的安全组默认只管 IPv4，必须单独新建 IPv6 安全组规则，协议选 TCP，端口填 80,443,8888，源地址填 ::/0
Cloudflare 代理下，你的服务器只需响应 IPv6 请求，但 Cloudflare 本身必须开启 IPv6 支持（DNS 设置页有开关），否则 AAAA 查询返回空
用 tcpdump -i eth0 ip6 and port 80 可抓包确认 IPv6 请求是否抵达服务器网卡，排除上层拦截