Docker容器运行MariaDB，MySQL Workbench无法连接的排查与修复

1. 明确Docker容器MariaDB的服务暴露方式 #

先确认你的容器是通过TCP/IP端口映射还是Unix Socket挂载提供服务：

• 执行docker ps获取容器ID，再运行docker inspect <容器ID> | grep -A 10 "Ports"查看端口映射状态；
• 运行docker inspect <容器ID> | grep -A 5 "Mounts"检查是否挂载了主机的socket目录（如/var/run/mysqld）。

方案A：切换为TCP/IP连接（推荐） #

如果容器已映射3306端口到主机（输出显示类似0.0.0.0:3306->3306/tcp）：

• 打开MySQL Workbench，新建连接时选择Standard (TCP/IP)；
• 主机名填127.0.0.1，端口填3306，用户名root，输入数据库root密码后测试连接。

若容器未映射端口，先停止容器，重新启动时添加端口映射参数（保留原有挂载/配置参数）：

docker stop <容器名/ID>
docker run -d --name <容器名> -p 127.0.0.1:3306:3306 -e MARIADB_ROOT_PASSWORD=<你的密码> mariadb

方案B：调整Unix Socket权限（若依赖socket连接） #

如果容器挂载了主机socket目录：

• 查看socket文件权限：ls -l /var/run/mysqld/mysqld.sock，若权限为srwxr-xr-x 1 root root，普通用户无访问权限；
• 临时修复：sudo chmod 777 /var/run/mysqld/mysqld.sock，然后在Workbench选择Local Socket/Pipe连接，socket路径填/var/run/mysqld/mysqld.sock；
• 永久修复：将当前用户加入mysql用户组，调整目录权限：

sudo groupadd mysql
sudo usermod -aG mysql $USER
sudo chown root:mysql /var/run/mysqld
sudo chmod 770 /var/run/mysqld

重启容器后，普通用户即可通过socket正常连接。

2. 检查Workbench连接配置细节 #

• 确保Workbench的Default Schema填写为mydb（和命令行指定的数据库一致）；
• 排查本地防火墙拦截：执行sudo ufw status，若防火墙开启，添加规则：sudo ufw allow from 127.0.0.1 to any port 3306。

3. 关于sudo运行Workbench打不开窗口的说明 #

这是因为root用户无普通用户的X11窗口访问权限，临时解决可执行xhost +si:localuser:root后再运行sudo mysql-workbench，但不推荐长期使用，优先通过上述方法修复普通用户连接问题更安全。

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