如何配置Docker远程API实现跨主机容器管理指南

云强酱_4681

云强酱_4681

2026-04-04

692人浏览

原创

要让 Docker 支持远程 API 访问,需配置 dockerd 监听 TCP 端口(如 2376),推荐通过修改 systemd service 文件添加 -H tcp://0.0.0.0:2376,并强制启用双向 TLS 加密;客户端通过 docker context 管理证书与连接,同时需开放防火墙端口并验证监听状态。

如何配置docker远程api实现跨主机容器管理指南

要让 Docker 支持远程 API 访问,核心是修改 Docker 守护进程(dockerd)的启动参数,使其监听指定网络地址和端口,并确保通信安全。默认情况下,Docker 只通过本地 Unix socket(/var/run/docker.sock)提供服务,不对外暴露 HTTP API。

启用远程 API 的基本配置

Docker 守护进程需显式配置为监听 TCP 端口(如 2376 或 2375),同时保留或禁用 Unix socket。推荐使用 systemd 管理的系统(如 Ubuntu 20.04+/CentOS 7+)进行持久化配置:

  • 编辑 /etc/docker/daemon.json,添加监听地址(注意:该文件不支持直接配置 -H,需配合 systemd)
  • 更可靠的方式是修改 systemd service 文件:/lib/systemd/system/docker.service,找到 ExecStart= 行,在其后追加 -H fd:// -H tcp://0.0.0.0:2376
  • 若只要特定网卡监听,可将 0.0.0.0 替换为内网 IP(如 192.168.1.10),避免公网暴露
  • 执行 sudo systemctl daemon-reload && sudo systemctl restart docker 生效

必须启用 TLS 加密(生产环境强制要求)

裸开 2375(非加密)端口存在严重安全风险,Docker 官方已弃用明文远程访问。正确做法是启用双向 TLS:

  • 生成 CA、服务端证书(docker-server.crt/key)和客户端证书(docker-client.crt/key),证书需包含 SAN(Subject Alternative Name),如 DNS 名或 IP
  • 将服务端证书路径写入 daemon.json:
      "tls": true,
      "tlscacert": "/etc/docker/certs/ca.pem",
      "tlscert": "/etc/docker/certs/server.pem",
      "tlskey": "/etc/docker/certs/server-key.pem"
  • 客户端调用时需指定证书:docker -H tcp://192.168.1.10:2376 --tlsverify --tlscacert=ca.pem --cert=client.pem --key=client-key.pem ps

配合 Docker Context 简化多主机管理

手动传证书参数易出错,可用 docker context 封装连接配置,实现一键切换目标主机:

  • 创建上下文:docker context create my-host-01 --docker "host=tcp://192.168.1.10:2376,ca=/path/ca.pem,cert=/path/client.pem,key=/path/client-key.pem"
  • 切换上下文:docker context use my-host-01,此后所有 docker 命令自动路由到该主机
  • 查看全部上下文:docker context ls;导出为 JSON 备份:docker context export my-host-01 > ctx.json

防火墙与权限注意事项

即使配置完成,仍可能因系统层拦截导致连接失败:

  • 检查防火墙是否放行目标端口:sudo ufw allow 2376(Ubuntu)或 sudo firewall-cmd --add-port=2376/tcp --permanent(CentOS)
  • 确认 Docker 进程实际监听状态:sudo ss -tlnp | grep :2376 或 sudo netstat -tulpn | grep :2376
  • 避免将 docker.sock 权限开放给普通用户;远程访问应严格依赖 TLS + 客户端证书鉴权,而非降权运行 dockerd
  • 若容器需跨主机通信,还需额外配置 CNI 网络插件(如 Weave、Calico)或使用 Docker Swarm 内置覆盖网络

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

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

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

下载

相关标签:

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

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2295

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

3722

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1236

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

4319

7

k8s和docker区别
k8s和docker区别

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

2023.07.24

805

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

6599

6

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

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

2024.04.08

7737

6

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

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

2024.04.08

3073

7

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

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

2026.02.11

339

16

热门下载

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

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.1万人学习