纯IPv6服务器需手动启用宝塔面板IPv6监听:确认IPv6网络连通后,执行echo '::' > /www/server/panel/data/ipv6.pl并重启面板;必要时修改config.py中bind_addr为'::';访问时须用https://[IPv6地址]:端口格式。

如果您在纯IPv6服务器上尝试安装宝塔面板但无法正常访问或启动,则可能是由于面板默认未启用IPv6监听,且安装过程未适配无IPv4环境。以下是针对纯IPv6环境安装宝塔面板的具体操作步骤:
一、确认服务器已启用纯IPv6网络
在执行安装前,必须确保系统已正确配置IPv6协议栈,并能通过IPv6地址完成基础网络通信。纯IPv6环境不分配IPv4地址,因此所有服务均需基于IPv6运行。
1、执行 ip -6 addr show 命令,确认至少有一个 global 类型的 IPv6 地址(非 fe80::/10 链路本地地址)。
2、执行 ping6 -c 4 2400:3200:baba::1 测试 IPv6 DNS 连通性(使用阿里云 IPv6 DNS)。
3、检查 /etc/resolv.conf 文件中是否仅包含 IPv6 DNS 服务器,例如:nameserver 2400:3200:baba::1。
二、手动启用宝塔面板的IPv6支持
宝塔面板在纯IPv6机器上安装后默认不监听IPv6端口,需在安装完成后立即注入IPv6启用标记,否则面板无法响应IPv6连接请求。
1、执行安装命令(以 CentOS 7 为例):wget -O install.sh http://download.bt.cn/install/install_6.0.sh && bash install.sh。
2、安装完成后,立即执行以下任一命令启用IPv6监听:echo True > /www/server/panel/data/ipv6.pl。
3、或使用更明确的绑定方式:echo '::' > /www/server/panel/data/ipv6.pl。
4、重启面板服务:/etc/init.d/bt restart。
三、修改面板监听配置文件强制绑定IPv6
当自动启用失败时,需直接编辑面板主配置文件,将监听地址由 0.0.0.0 显式改为 ::,确保其接受所有IPv6连接。
1、打开面板配置文件:vi /www/server/panel/data/port.pl,确认端口号(如 8888)未被占用。
2、编辑主服务配置:vi /www/server/panel/class/config.py。
3、查找包含 bind_addr = '0.0.0.0' 的行,将其替换为:bind_addr = '::'。
4、保存退出后,再次执行:/etc/init.d/bt restart。
四、通过IPv6地址访问面板
面板成功启用IPv6监听后,必须使用标准IPv6 URL 格式访问,括号包裹地址是必需语法,否则浏览器可能解析失败。
1、获取服务器分配的全局单播 IPv6 地址(如 2001:db8:abcd:ef00:1234:5678:9abc:def0)。
2、在浏览器地址栏输入完整 URL:https://[2001:db8:abcd:ef00:1234:5678:9abc:def0]:8888。
3、首次访问若提示证书错误,点击“高级”→“继续前往”,因自签名证书未绑定IPv6域名所致。
五、解决面板后台IPv6检测为空的问题
部分纯IPv6主机(如 Hax 提供的机器)在面板首页显示 IPv6 地址为空,系因面板初始化时未能自动读取接口信息,需人工补全。
1、执行命令查看实际 IPv6 地址:ip -6 route | grep via | awk '{print $1}' | head -n1。
2、将输出的网段(如 2001:db8:abcd:ef00::/64)写入数据文件:echo '2001:db8:abcd:ef00::/64' > /www/server/panel/data/ipv6_addr.pl。
3、重启面板:/etc/init.d/bt restart。










