Docker 远程连接怎么开?三大系统配置 + IDE 插件一键部署
Docker 默认只接受本机 Unix 套接字的请求,远程机器和 IDE 想直接操作它,得先把 TCP 端口开出来。
下面按 Linux、Windows、Mac 三套系统分别讲配置方法,再讲 IDE 插件怎么连上去一键部署。
最后单独说安全,这块最容易被忽略,也最容易出事。
为什么要开启 Docker 远程连接?
Docker 远程连接,本质是把 Docker 守护进程的 API 暴露到一个 TCP 端口上,让远程客户端能通过网络调用它。
开了之后能干嘛?最常见的两件事。
一是本地 IDE 直接连远程服务器的 Docker,改完代码点一下就部署,不用手动 ssh 上去敲命令。
二是 CI 流水线、监控工具远程拉取容器状态。
Docker 远程 API 默认走两个端口:2375 是明文 HTTP,2376 是 TLS 加密。
这俩的区别后面会专门讲,先记住一句话:2375 千万别裸奔到公网。
Linux 怎么开启远程连接?
Linux 上改 docker.service 配置,给启动命令加一个监听参数就行。
先编辑服务文件。
vi /usr/lib/systemd/system/docker.service找到 ExecStart 那一行,在结尾追加 -H tcp://0.0.0.0:2375。
注意 ExecStart 默认已经带了 -H fd://,不要把它删掉,两个 -H 参数可以共存。
改完大概长这样。
保存退出后,重新加载配置并重启 Docker。
systemctl daemon-reload
systemctl restart docker这里有个坑。
原文写的是 systemctl start docker,如果 Docker 已经在跑,start 是不生效的,必须用 restart 才能让新参数加载进去。
重启完验证一下端口通没通。
curl http://127.0.0.1:2375/version能返回一段 JSON 版本信息,就说明远程 API 已经在监听了。
Windows 怎么开启远程连接?
Windows 上用 Docker Desktop 的话,不用改配置文件,勾一个选项就行。
打开 Docker Desktop,进入 Settings,在 General 里找到 Expose daemon on tcp://localhost:2375 without TLS,把它打开。
勾上之后 Docker Desktop 会自动重启服务。
要提醒一句,这个选项明确写了 without TLS,也就是没有任何加密和认证。
它默认只绑 localhost,仅本机访问问题不大,真要让局域网其他机器连,得另外配端口转发或者 TLS。
Mac 怎么开启远程连接?
Mac 上 Docker Desktop 没有直接暴露 TCP 端口的开关,得借助 socat 做一层转发。
socat 是一个双向数据转发工具,思路是监听一个 TCP 端口,把流量转发到 Docker 的 Unix 套接字。
先装 socat。
brew install socat然后开启转发。
socat TCP-LISTEN:2375,reuseaddr,fork UNIX-CONNECT:/var/run/docker.sock这条命令会一直占着前台终端。
TCP-LISTEN:2375 表示监听 2375 端口,reuseaddr 允许端口复用,fork 让它能同时处理多个连接,最后转发到 /var/run/docker.sock。
终端一关,转发就断了。
要常驻的话,可以丢到后台运行,或者写成 launchd 服务,按需选择就行。
IDE 插件怎么连上去一键部署?
以 IntelliJ IDEA 为例,它自带 Docker 插件,不用额外装。
配置入口在 Settings → Build, Execution, Deployment → Docker,点加号新建一个连接。
连接方式选 TCP socket,Engine API URL 填 tcp://服务器IP:2375。
连接成功后下方会显示 Connection successful,这时候 IDEA 的 Services 面板就能看到远程服务器上所有的镜像和容器了。
配合 Dockerfile,可以做到改完代码点一下 Run,自动构建镜像、推送、重启容器。
更详细的 IDEA Docker 插件一键部署流程,可参考网络上的图文教程,本文不再展开每一步截图。
端口安全:2375 和 2376 的区别
这一节最重要,前面反复提醒的安全问题,在这里说清楚。
2375 是明文端口,没有任何加密和身份认证。
任何能访问到这个端口的人,都等于拿到了你 Docker 的完全控制权,能随意创建、删除容器,甚至挂载宿主机根目录拿到 root 权限。
把 2375 直接暴露到公网,是真实发生过大量服务器被植入挖矿木马的重灾区。
正确的做法是用 2376 加 TLS 证书。
| 对比项 | 2375(明文) | 2376(TLS) |
|---|---|---|
| 加密 | 无 | TLS 加密 |
| 身份认证 | 无 | 双向证书校验 |
| 适用场景 | 本机或可信内网调试 | 生产环境、跨网络访问 |
| 暴露公网风险 | 极高 | 较低 |
几条实用建议。
本机或纯内网调试,用 2375 图省事可以,但别绑 0.0.0.0 暴露出去。
跨网络访问,老老实实配 2376 + TLS 证书。
实在不想折腾证书,更推荐直接走 SSH 隧道,docker -H ssh://user@host 这种方式,安全又简单。
常见问题
Q1. 开启 2375 后远程连不上怎么办?
先确认端口真的在监听,curl http://127.0.0.1:2375/version 能通说明 Docker 侧没问题。
连不上多半是防火墙拦了,检查服务器安全组和 iptables、firewalld 有没有放行 2375 端口。
云服务器还要去控制台的安全组规则里加放行。
Q2. 2375 和 2376 端口必须二选一吗?
不是,它们可以同时监听,分别对应明文和 TLS 两种接入方式。
但实际中没必要同时开,按场景选一个就行,公网环境只留 2376。
Q3. Mac 上 socat 转发命令一关终端就断,怎么常驻?
命令末尾加 & 丢后台只能管到终端关闭前。
要真正常驻,建议写成 launchd 的 plist 服务文件,开机自启,或者用 nohup 配合后台运行。
Q4. Linux 改完 docker.service 重启报错启动不了?
最常见的原因是 -H 参数冲突。
如果你的 daemon.json 里已经配过 hosts,又在 ExecStart 里加了 -H,两边会打架导致启动失败。
二选一即可,要么只改 daemon.json,要么只改 ExecStart。
Q5. IDEA 连接远程 Docker 提示连接超时?
先排除网络和端口,确认本地能 telnet 服务器IP 2375。
如果服务器开的是 2376,IDEA 里要勾选 TLS 并指定证书目录,URL 也要相应改成 tcp://IP:2376。
小结
开启 Docker 远程连接不难,Linux 改 docker.service,Windows 勾选项,Mac 靠 socat 转发,三套路子各不一样但都好上手。
真正要上心的是安全,2375 明文端口图的是方便,代价是把整台机器的控制权交出去。
内网调试随便用,一旦涉及公网,请务必上 TLS 或者干脆走 SSH 隧道。
如果大家在配置过程中遇到连不上、启动报错之类的问题,欢迎在评论区交流,把报错信息贴出来一起看~~~
版权声明
未经授权,禁止转载本文章。
如需转载请保留原文链接并注明出处。即视为默认获得授权。
未保留原文链接未注明出处或删除链接将视为侵权,必追究法律责任!
本文原文链接: https://fiveyoboy.com/articles/docker-remote-connection-ide-plugin/
备用原文链接: https://blog.fiveyoboy.com/articles/docker-remote-connection-ide-plugin/
🍵 若本篇文章帮到了你
不必多,一杯茶的心意,就是我继续写作的动力 🌿