本地Debian虚拟机连接Docker中MariaDB失败求助

问题排查与解决步骤 #

1. 修正容器网络模式的误解
   你执行的docker run命令未添加--network host参数，容器默认使用bridge网络而非host网络。docker inspect host是查询名为host的容器（实际不存在），正确的容器信息查询命令应为：

   docker inspect my_mariadb_host
   

   查看输出中NetworkSettings.IPAddress字段，这才是容器的实际内部IP（例如192.168.50.2）。

2. 调整MariaDB绑定地址
   默认情况下，MariaDB容器可能仅绑定127.0.0.1，导致外部网络无法访问。进入容器修改配置：

   docker exec -it my_mariadb_host bash
   

   编辑配置文件/etc/mysql/mariadb.conf.d/50-server.cnf，找到bind-address行，修改为0.0.0.0（允许所有地址访问），之后重启容器：

   docker restart my_mariadb_host
   

3. 授权MariaDB用户远程访问权限
   本地能连接是因为端口映射到了主机，但虚拟机属于外部网络，需给root用户授权远程访问：
   先在本地主机登录MariaDB：

   mysql -h 192.168.50.1 -P 3306 -u root -p
   

   执行授权SQL（若需限制访问范围，可将%替换为虚拟机的IP段，例如192.168.xxx.%）：

   GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY '1234' WITH GRANT OPTION;
   FLUSH PRIVILEGES;
   

4. 检查本地主机防火墙规则
   虚拟机能ping通192.168.50.1但无法连接3306端口，大概率是本地主机防火墙拦截了该端口的外部请求。可临时关闭防火墙测试，或添加允许规则：

   • 临时关闭（Debian/Ubuntu）：

     sudo ufw disable
     

   • 添加永久允许规则：

     sudo ufw allow 3306/tcp
     

5. 使用本地主机物理IP连接
   docker0是主机内部虚拟网卡，虚拟机可能无法直接通过该IP访问。应使用本地主机的物理网卡IP（通过ip addr命令查看，例如192.168.1.100），在虚拟机执行连接命令：

   mysql -h 192.168.1.100 -P 3306 -u root -p
   

内容的提问来源于stack exchange，提问作者Mircea