根本原因是phpMyAdmin无法解析NAS主机名，因容器默认不支持mDNS，应改用静态IP并确保MySQL绑定0.0.0.0、开放远程访问、配置对应网段用户权限、Docker需调整网络模式、多实例需避免controluser冲突且三者（bind-address/防火墙/用户host）必须同时对齐。
phpMyAdmin 无法解析 NAS 上的 MySQL 主机名
根本原因不是密码或权限，而是 phpmyadmin 容器（或本地安装）压根不知道 nas 的 ip 或主机名该怎么解析——尤其当 nas 启用了 avahi/mdns（如 my-nas.local）或使用非标准端口时，mysqli::real_connect() 会直接报 getaddrinfo failed: name or service not known。
实操建议：
- 不要在
config.inc.php里写$cfg['Servers'][$i]['host'] = 'my-nas.local';—— 大多数 PHP 环境（尤其 Alpine Linux 容器）默认不启用 mDNS 解析，getaddrinfo直接失败 - 改用 NAS 的静态 IPv4 地址（如
192.168.1.120），确保该地址能从 phpMyAdmin 所在机器 ping 通 - 如果 NAS MySQL 绑定了
127.0.0.1而非0.0.0.0，需登录 NAS 后台修改 MySQL 配置，放开远程监听（通常在 MariaDB/MySQL 设置页勾选“允许远程访问”）
连接被拒绝：MySQL 用户权限未开放给 NAS 外部 IP
即使网络通了，Access denied for user 'root'@'192.168.1.50' 这类错误说明 MySQL 拒绝了来自 phpMyAdmin 所在设备的连接请求——默认只允许 localhost 或 127.0.0.1。
实操建议：
- 登录 NAS 的 SSH 或管理后台，进入 MySQL/MariaDB 命令行（如
mysql -u root -p） - 执行：
CREATE USER 'phpmyadmin'@'192.168.1.%' IDENTIFIED BY 'StrongPass123';<br>GRANT ALL PRIVILEGES ON *.* TO 'phpmyadmin'@'192.168.1.%' WITH GRANT OPTION;<br>FLUSH PRIVILEGES;
（把192.168.1.%替换为你的局域网段） - 避免用
'root'@'%'—— NAS 系统通常限制 root 远程登录，且存在安全风险
Docker 环境下 phpMyAdmin 连不到 NAS MySQL
如果你是用 Docker 运行 phpMyAdmin（比如通过 docker run 或 Compose），它默认处于桥接网络中，host.docker.internal 在 Linux 上不可用，192.168.1.120 也可能因防火墙或 Docker 网络策略不通。
立即学习“PHP免费学习笔记（深入）”；
实操建议：
- 启动容器时加
--network host（Linux）或--add-host=host.docker.internal:host-gateway（Mac/Win），让容器共享宿主机网络栈 - 或者改用
docker-compose.yml并显式声明extra_hosts：extra_hosts:<br> - "nas-mysql:192.168.1.120"
，然后在环境变量中设PMA_HOST=nas-mysql - 检查 NAS 是否启用了防火墙：Synology 要在「控制面板 → 安全性 → 防火墙」中放行 TCP 3306；QNAP 则需在「系统管理 → 安全性」里确认端口规则
多实例连接混乱：config.inc.php 配置覆盖或顺序错误
想在一个 phpMyAdmin 实例里管理 NAS 上的多台 MySQL（比如测试库、生产库、旧项目库），但切换后总是连错，甚至提示 #1045 Cannot log in to the MySQL server —— 很可能是 $i 索引重复、auth_type 冲突或 controluser 配置干扰。
实操建议：
- 每个服务器块必须有唯一
$i值（不要手动写死$i = 1，用$i++自增） - 禁用 controluser：注释掉或删掉
$cfg['Servers'][$i]['controluser']和$cfg['Servers'][$i]['controlpass']，它们只在高级功能（如用户管理）中需要，且极易引发认证冲突 - 明确指定认证方式：
$cfg['Servers'][$i]['auth_type'] = 'cookie'; // 推荐，每次登录可选不同服务器<br>$cfg['Servers'][$i]['host'] = '192.168.1.120';<br>$cfg['Servers'][$i]['port'] = '3306';<br>$cfg['Servers'][$i]['verbose'] = 'NAS-Production';
多个 NAS 数据库之间真正容易被忽略的点是：MySQL 的 bind-address、防火墙、用户 host 白名单三者必须同时对齐，缺一不可。光改配置文件或光开权限，都只是半截子事。
