怎样使用Navicat连接Mac上的Docker容器

浅宇同学_2390

浅宇同学_2390

2026-08-24

589人浏览

原创

mac上navicat连接docker mysql应填localhost(前提是-p显式映射端口如3306:3306),host.docker.internal仅用于容器内访问宿主机;wsl2或linux docker需用宿主机ip或手动添加--add-host参数。

navicat 主机地址填 localhost 还是 host.docker.internal?

mac 上绝大多数情况填 localhost 就能连上,前提是容器端口已正确映射到宿主机(比如 -p 3306:3306)。host.docker.internal 是 docker desktop for mac 自带的特殊 dns 名,只在容器内部访问宿主机时有用,navicat 运行在 mac 本机,不需要它。

例外情况:如果你用的是 WSL2 或 Linux 环境下的 Docker(非 Docker Desktop),localhost 指向的是 WSL2 虚拟机自身,此时 Navicat 必须填宿主机真实 IP(如 192.168.x.x)或手动配置 --add-host=host.docker.internal:host-gateway 后才可用该域名。

  • Mac + Docker Desktop → 填 localhost,端口对应映射的宿主机端口(如 3306 或 3307)
  • WSL2 + Docker CLI → 不要用 localhost,查 Mac 的局域网 IP 并填入
  • Linux Docker(非 Desktop)→ 默认不支持 host.docker.internal,必须加 --add-host 参数或直接用宿主机 IP

MySQL 容器连不上?先检查这三件事

Navicat 报错“Connection refused”或“Can’t connect to MySQL server”,90% 是以下三个环节出问题:

  • 运行容器时没加 -p 显式映射:只写 -p 3306 是无效的,Docker 会随机分配宿主机端口;必须写成 -p 3306:3306 或 -p 3307:3306
  • docker ps 输出的 PORTS 列没有显示 0.0.0.0:3306->3306/tcp → 说明映射失败,删掉容器重跑
  • MySQL 8+ 默认用 caching_sha2_password 插件,而旧版 Navicat(v16.2 及更早)不兼容,报错 Authentication plugin 'caching_sha2_password' cannot be loaded;解决方法是进容器执行:ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'your_password'; FLUSH PRIVILEGES;

SQL Server 容器连接失败常见原因

Mac 上跑 SQL Server 容器(mcr.microsoft.com/mssql/server),Navicat 连接失败通常卡在密码或端口上:

  • SA 密码不符合复杂度要求:必须含大小写字母、数字、特殊字符,且 ≥8 位;YourStrong!Passw0rd 是安全底线,123456 会直接导致容器启动失败
  • 端口映射写错:SQL Server 默认监听 1433,命令中必须写 -p 1433:1433;如果宿主机 1433 被占用,可改用 -p 1434:1433,Navicat 主机填 localhost,端口填 1434
  • 容器内存不足:SQL Server 最低需 4GB 内存,Docker Desktop 设置里要调高 Memory Limit,否则容器反复重启,docker logs sql_server_demo 会看到 Out of memory 提示

Navicat 测试连接成功但无法建库/执行 SQL?

测试连接通过 ≠ 权限就位。MySQL 容器默认只允许 root@localhost,而 Navicat 是从宿主机发起连接,等效于 root@'172.17.0.1' 或 root@'%',必须显式授权:

OpenClaw Docker Setup
OpenClaw Docker Setup

在 Linux 上通过 Docker 运行 OpenClaw,并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...

下载

进容器执行:docker exec -it mysql-container mysql -uroot -p,然后运行:

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

注意:GRANT ALL ON *.* 是开发环境快捷方案;生产环境应限定数据库名和权限类型(如 SELECT,INSERT)。

SQL Server 不需要额外授权,只要 SA 密码正确、端口通、容器在运行,Navicat 就能建库执行 T-SQL —— 但它对中文字符集支持弱,导入含中文的 .sql 文件前,务必在 Navicat 连接设置里勾选 Use Unicode UTF-8,否则乱码无法回滚。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

navicat docker docker容器

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
k8s和docker区别
k8s和docker区别

k8s和docker区别有抽象层次不同、管理范围不同、功能不同、应用程序生命周期管理不同、缩放能力不同、高可用性等等区别。本专题为大家提供k8s和docker区别相关的各种文章、以及下载和课程。

2023.07.24

705

4

docker进入容器的方法有哪些
docker进入容器的方法有哪些

docker进入容器的方法:1. Docker exec;2. Docker attach;3. Docker run --interactive --tty;4. Docker ps -a;5. 使用 Docker Compose。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

5079

6

docker容器无法访问外部网络怎么办
docker容器无法访问外部网络怎么办

docker 容器无法访问外部网络的原因和解决方法:配置 nat 端口映射以将容器端口映射到主机端口。根据主机兼容性选择正确的网络驱动(如 host 或 overlay)。允许容器端口通过主机的防火墙。配置容器的正确 dns 服务器。选择正确的容器网络模式。排除主机网络问题,如防火墙或连接问题。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

6057

6

docker镜像有什么用
docker镜像有什么用

docker 镜像是预构建的软件组件,用途广泛,包括:应用程序部署:简化部署,提高移植性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

2293

7

Docker容器化部署与DevOps实践
Docker容器化部署与DevOps实践

本专题面向后端与运维开发者,系统讲解 Docker 容器化技术在实际项目中的应用。内容涵盖 Docker 镜像构建、容器运行机制、Docker Compose 多服务编排,以及在 DevOps 流程中的持续集成与持续部署实践。通过真实场景演示,帮助开发者实现应用的快速部署、环境一致性与运维自动化。

2026.02.11

239

16

Docker 容器部署
Docker 容器部署

本专题整合了Docker容器部署相关内容,阅读专题下面的文章了解更多详细操作教程。

2026.03.31

431

14

Java容器化部署与Docker实践教程合集
Java容器化部署与Docker实践教程合集

聚焦 Java 应用的容器化与云原生部署,讲解 Dockerfile 编写规范与 Java 应用镜像构建、多阶段构建(Multi-stage Build)减小镜像体积、Jib / Buildpacks 免 Dockerfile 镜像构建方案、JVM 容器感知参数(-XX:MaxRAMPercentage)配置、Docker Compose 编排多服务(应用 + MySQL + Redis)、容器健康检查与资源限制、Kubernetes

2026.05.11

400

26

Go Docker与容器化部署教程合集
Go Docker与容器化部署教程合集

聚焦 Go 应用的容器化部署优势与实践,讲解 Go 静态编译特性(CGO_ENABLED=0)与 scratch / distroless 极小基础镜像构建、多阶段 Dockerfile 编写规范、交叉编译生成目标平台二进制、镜像安全扫描(Trivy)与漏洞修复、Docker Compose 本地编排开发环境、Kubernetes Deployment / Service / ConfigMap 部署 Go 服务、健康检查(Livene

2026.05.15

285

24

Hyperf 项目部署运维与性能调优手册
Hyperf 项目部署运维与性能调优手册

聚焦 Hyperf 在生产环境的落地,包含 Docker 高效打包、Swoole 配置优化、常见的内存溢出(OOM)问题排查方法以及热更新方案。

2026.05.19

425

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpMyAdmin 安装文档
phpMyAdmin 安装文档

共0课时 | 0人学习

Docker 官方文档
Docker 官方文档

共0课时 | 0人学习

宝塔 Docker 模块使用手册
宝塔 Docker 模块使用手册

共0课时 | 0人学习