如何配置phpMyAdmin以支持对远程IPv6数据库服务器的连接？-phpMyAdmin-PHP中文网

能连上远程ipv6数据库取决于mysql监听ipv6（bind-address=::）、phpmyadmin配置host为带方括号的ipv6地址（如'[2001:db8::1]'）、以及远程mysql用户授权匹配ipv6客户端地址。

phpmyadmin 本身不处理网络连接，能否连上远程 ipv6 数据库，取决于三件事：mysql 服务是否监听 ipv6 地址、phpmyadmin 的 $cfg['servers'][$i]['host'] 是否填对 ipv6 地址（含方括号）、以及中间链路（防火墙、路由、dns）是否支持 aaaa 解析和透传。

MySQL 服务必须绑定到 IPv6 地址

只改 phpMyAdmin 配置没用。MySQL 默认通常只监听 127.0.0.1 或 0.0.0.0，对 IPv6 完全无视。

检查 MySQL 配置文件（my.cnf 或 mysqld.cnf）里的 bind-address：若设为 127.0.0.1 或 localhost，IPv6 连接直接被拒；设为 0.0.0.0 也不自动包含 IPv6
正确做法是显式写 bind-address = ::（双冒号，不是 * 或 [::]），表示监听所有 IPv6 和 IPv4 地址（双栈）
重启 MySQL：sudo systemctl restart mysql，然后验证：ss -tln | grep :3306 应同时看到 *:3306（IPv4）和 [::]:3306（IPv6）
如果只看到 IPv4，说明配置未生效或被其他配置覆盖（如 skip-networking 开启、或 systemd override 文件强行重置了 bind-address）

phpMyAdmin config.inc.php 中 host 必须带方括号

IPv6 地址在 URL 和 PHP 连接字符串中必须用方括号包裹，否则会被解析器误判为端口分隔符。

错误写法：$cfg['Servers'][$i]['host'] = '2001:db8::1'; → PHP 会尝试连 2001:db8::1:3306，实际连接失败
正确写法：$cfg['Servers'][$i]['host'] = '[2001:db8::1]';（注意单引号内完整包裹）
如果用域名，确保该域名有 AAAA 记录，并且你的服务器 DNS 能解析出 IPv6 地址；但即使有 AAAA，PHP 的 MySQL 扩展仍可能 fallback 到 IPv4，所以显式写带方括号的地址最可靠
别漏掉端口：$cfg['Servers'][$i]['port'] = '3306';，虽然默认值是 3306，但显式声明可避免某些旧版本扩展的歧义

远程 MySQL 用户授权必须匹配 IPv6 客户端地址

MySQL 的用户权限是按 'user'@'host' 精确匹配的。'user'@'%' 在 IPv6 下不一定生效，尤其当客户端真实来源是 IPv6 地址时。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

用 MySQL root 登录后执行：CREATE USER 'pmauser'@'2001:db8::100' IDENTIFIED BY 'strong_pass';
再授权：GRANT SELECT, INSERT, UPDATE, DELETE ON *.* TO 'pmauser'@'2001:db8::100';
如果 phpMyAdmin 所在服务器有多条 IPv6 出口地址，或你希望更宽松一点，可用 CIDR 段：'pmauser'@'2001:db8::/64'（注意 MySQL 8.0+ 才支持 IPv6 CIDR，5.7 只支持完整地址或 %）
FLUSH PRIVILEGES; 后测试连接：mysql -u pmauser -h '[2001:db8::1]' -p，成功再配 phpMyAdmin

Apache/Nginx 不影响 phpMyAdmin 连远程数据库，但影响你访问 phpMyAdmin 自身

很多人混淆“访问 phpMyAdmin 页面”和“phpMyAdmin 连远程数据库”。前者靠 Web 服务器（Apache/Nginx），后者靠 PHP 的 MySQL 扩展直连目标数据库。

如果你要从外网用 IPv6 访问 phpMyAdmin 页面本身（比如 https://[2001:db8::1]/phpmyadmin），那才需要 Apache 的 Listen [::]:443 或 Nginx 的 listen [::]:443 ssl ipv6only=off
但即使你只从本地 IPv4 网络访问 phpMyAdmin 页面，它照样可以去连远程 IPv6 数据库——只要 PHP 进程所在机器能路由到那个 IPv6 地址
所以，检查 phpinfo() 里是否有 mysqli 或 pdo_mysql 扩展启用，比折腾 Web 服务器监听更重要

最容易被忽略的是 MySQL 的 bind-address = :: 和 phpMyAdmin 里 host 值的方括号——少一个，连接就静默失败，错误日志里往往只报“Connection refused”或“Can't connect to MySQL server”，不会提示 IPv6 格式问题。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！