纯IPv6环境下的服务器由于缺少IPv4地址，直接运行官方默认的宝塔面板安装脚本会因为无法访问IPv4资源导致安装失败，需要对安装流程做针对性调整才能完成部署。
环境准备
首先确认服务器满足基础要求：系统为CentOS 7+、Ubuntu 18.04+、Debian 10+等主流Linux发行版，拥有root权限，纯IPv6网络已正常连通，可以通过ping6命令测试IPv6网络连通性。
执行以下命令测试IPv6连通性：
# 测试IPv6连通性，能收到回复说明网络正常 ping6 ipipp.com
调整系统网络配置
部分系统的IPv6 DNS配置可能不完整，需要先配置可用的IPv6 DNS服务器，避免后续拉取资源时出现域名解析失败的问题。
编辑DNS配置文件，添加IPv6 DNS：
# 编辑resolv.conf文件 vi /etc/resolv.conf # 在文件中添加以下内容，保存退出 nameserver 2001:4860:4860::8888 nameserver 2001:4860:4860::8844
修改宝塔安装脚本适配IPv6
官方默认安装脚本会优先使用IPv4地址拉取安装包，需要手动修改脚本中的资源地址，替换为支持IPv6的镜像源。
首先下载官方安装脚本到本地：
# 下载安装脚本 curl -O https://download.bt.cn/install/install_panel.sh
编辑下载后的install_panel.sh文件，找到所有指向download.bt.cn的地址，替换为支持IPv6的镜像地址，同时检查脚本中是否有强制使用IPv4的配置项，注释或删除相关配置。
修改后的脚本片段示例如下：
# 原地址可能为http://download.bt.cn/xxx，替换为IPv6可用的镜像地址 # 修改后示例 BT_URL="https://ipipp.com/bt_mirror"
执行安装命令
修改完成脚本后，赋予脚本执行权限并运行安装：
# 赋予执行权限 chmod +x install_panel.sh # 运行安装脚本 bash install_panel.sh
安装过程中会提示选择面板版本和安装组件，根据服务器用途选择即可，等待安装流程完成。
验证安装结果
安装完成后，脚本会输出面板的访问地址、用户名和密码，由于是纯IPv6环境，访问地址为IPv6格式，需要在支持IPv6的网络环境下访问。
访问格式示例：
http://[服务器IPv6地址]:8888
如果无法访问，检查服务器防火墙是否放行了8888端口，执行以下命令放行端口：
# CentOS系统放行端口 firewall-cmd --add-port=8888/tcp --permanent firewall-cmd --reload # Ubuntu/Debian系统放行端口 ufw allow 8888/tcp ufw reload
常见问题处理
- 安装过程中提示资源拉取失败：检查IPv6网络连通性，确认DNS配置正确，重新修改安装脚本的镜像地址
- 面板安装完成无法访问：确认访问设备支持IPv6网络，检查服务器端口是否放行，查看面板服务是否正常运行
- 面板内软件安装失败：在面板设置中更换软件源为IPv6可用的镜像源，避免软件拉取时依赖IPv4网络