Docker容器中MariaDB无法通过DBeaver连接的问题求助

核心问题梳理 #

你终端能直接访问容器内部IP（172.18.0.2）成功，但DBeaver连接失败，本质是容器IP属于Docker内部网络，宿主机不能直接用这个IP访问。你看到的端口映射是把宿主机的3308端口转发到容器的3308端口，所以DBeaver应该连接宿主机的地址，而非容器内部IP。

具体解决步骤 #

1. 修正DBeaver连接参数 #

• 主机地址填localhost或127.0.0.1（如果是远程机器就填宿主机的局域网/公网IP）
• 端口固定填3308（和docker ps显示的宿主机映射端口一致）
• 用户名直接填username，不需要额外加@localhost或@IP后缀

2. 验证宿主机端口连通性 #

在终端执行以下命令，确认宿主机的3308端口是否能正常访问：

# 用telnet测试
telnet localhost 3308
# 或者用nc命令（如果已安装）
nc -zv localhost 3308

如果能连通，说明端口映射正常；如果不通，检查容器是否在运行，或者本地防火墙/安全软件是否拦截了3308端口。

3. 检查MariaDB绑定配置 #

容器内的MariaDB可能仅绑定了容器内部IP，导致外部无法通过映射端口连接。需要修改配置让它绑定所有IP：

• 进入容器终端：

docker exec -it <你的容器ID或名称> bash

• 编辑MariaDB配置文件（通常路径为/etc/mysql/mariadb.conf.d/50-server.cnf），找到bind-address项，修改为：

bind-address = 0.0.0.0

• 重启容器生效：

docker restart <你的容器ID或名称>

4. 调整用户访问权限 #

你的username可能仅被授权从容器内部IP访问，需要开放宿主机的访问权限：

• 先通过终端连接MariaDB：

mysql -h 172.18.0.2 -u username -psecret

• 执行授权命令（允许从任意地址访问，也可以替换%为宿主机具体IP提升安全性）：

GRANT ALL PRIVILEGES ON *.* TO 'username'@'%' IDENTIFIED BY 'secret';
FLUSH PRIVILEGES;

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