在 macOS 上用 Docker Desktop 启动 MySQL 容器，再使用 Sequel Ace 管理数据库是很常见的本地开发组合。但不少人在实际操作时，会遇到 Sequel Ace 一直提示无法连接、超时或者认证失败的情况。本文从容器网络、端口映射、账号权限和客户端配置几个角度，详细说明出现这类问题的原因以及对应的解决办法。
一、确认 Docker 容器端口映射是否正确
Docker Desktop 中的 MySQL 容器默认只在容器内部监听 3306 端口。如果启动容器时没有把该端口映射到 macOS 宿主机，Sequel Ace 作为宿主机上的应用程序根本无法访问容器内的服务。很多人直接用 docker run mysql 而忘了加 -p 参数，这是最典型的疏漏。
你可以通过下面的命令检查容器端口映射状态：
# 查看正在运行的容器及端口映射 docker ps # 若看到类似 0.0.0.0:3306->3306/tcp 才说明映射成功 # 如果没有端口映射，需要重新创建容器并指定端口 docker run --name mysql-local -e MYSQL_ROOT_PASSWORD=yourpassword -p 3306:3306 -d mysql:8.0
上面的 -p 3306:3306 表示把宿主机的 3306 端口转发到容器的 3306 端口。在 Sequel Ace 中，host 应填写 127.0.0.1，端口填 3306。如果宿主机 3306 已被占用，可以改成 -p 3307:3306，此时客户端端口就要填 3307。
二、MySQL 用户认证方式不兼容
MySQL 8.0 之后默认的身份认证插件是 caching_sha2_password，而某些版本的 Sequel Ace 或某些连接驱动对这种方式支持不完善，会导致连接时直接报认证错误。与之相对，旧版 MySQL 使用的是 mysql_native_password，兼容性更好。
如果你确定端口没问题但仍连不上，可以进入容器查看用户使用的插件：
-- 进入容器执行 mysql 客户端后运行 SELECT user, host, plugin FROM mysql.user WHERE user = 'root';
若结果显示 caching_sha2_password 且客户端报错，可将该用户改为旧插件：
-- 修改 root 用户认证方式并刷新权限 ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'yourpassword'; FLUSH PRIVILEGES;
这种修改方式简单直接，适合本地开发环境。但在生产环境应谨慎评估安全性，因为 mysql_native_password 的加密强度相对较弱。如果只是某个特定账号连不上，也可以新建一个使用旧插件的账号专门给 Sequel Ace 使用。
三、检查 MySQL 用户 Host 授权范围
另一个常见问题是 MySQL 用户只允许从特定 host 连接。例如 root@localhost 只能容器内连接，而 Sequel Ace 是从宿主机连进来的，会被判定为远程连接从而拒绝。你需要确保用户 host 包含 % 或具体的宿主机 IP。
创建允许远程连接的用户并授权的示例如下：
-- 创建用户并允许任意 host 连接 CREATE USER 'dev'@'%' IDENTIFIED WITH mysql_native_password BY 'devpass'; GRANT ALL PRIVILEGES ON *.* TO 'dev'@'%'; FLUSH PRIVILEGES;
在 Sequel Ace 里使用 dev 账号、host 填 127.0.0.1 即可。注意 % 代表所有 IP，本地开发没问题，但在共享网络环境中应注意缩小授权范围，避免数据库暴露。
四、Sequel Ace 连接配置要点
在 Sequel Ace 的图形界面中，几个关键字段必须和容器配置对应。很多人错把 host 填成容器名称或 Docker 内网 IP，这在 macOS 本机客户端是不通的。正确做法是 host 用回环地址，用户名和密码对应容器内 MySQL 账号。
| 配置项 | 推荐值 | 说明 |
|---|---|---|
| Host | 127.0.0.1 | 连接本地 Docker 映射端口 |
| Port | 3306 或映射端口 | 与 docker run -p 一致 |
| User | root 或 dev | 有授权且插件兼容 |
| Password | 对应密码 | 创建用户时设定 |
如果使用了 Docker Compose，也要确认 ports 字段正确书写。下面是一段标准的 Compose 配置片段：
version: '3.8'
services:
mysql:
image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD: yourpassword
ports:
- "3306:3306"
配置完成后，可在终端先用 mysql -h 127.0.0.1 -P 3306 -u dev -p 测试。若命令行能连但 Sequel Ace 不能连，通常是客户端版本问题，建议升级到最新版再试。
五、通过容器日志快速定位问题
当以上检查都无异常仍无法连接时，应查看 Docker 容器日志。日志会明确记录连接被拒、密码错误还是端口冲突等信息，是排查的最终依据。
# 查看 mysql 容器最新日志 docker logs mysql-local --tail 50
若日志出现 Access denied for user，重点查账号密码和 host 授权；若出现 Can't start server: Bind on TCP/IP port，说明容器端口冲突。根据日志对症下药，基本都能让 Sequel Ace 顺利连上 Docker Desktop 里的 MySQL。
Docker_DesktopMySQLSequel_Ace修改时间：2026-08-08 21:30:31