怎么通过 REST API 与 Docker 守护进程交互

雨墨同学_9660

雨墨同学_9660

2026-09-28

875人浏览

原创

可直接通过http请求调用docker守护进程rest api,无需docker命令行工具;核心是docker cli仅为api封装客户端,所有操作终转为标准http请求。

你可以直接通过 http 请求调用 docker 守护进程暴露的 rest api,无需依赖 docker 命令行工具。核心在于:docker cli 本身只是 api 的封装客户端,所有操作最终都转为标准 http 请求。

确认守护进程监听地址和权限

Docker 默认通过 Unix 域套接字 /var/run/docker.sock 与本地守护进程通信,普通用户需在 docker 用户组中才能访问;若要远程调用,需配置 DOCKER_HOST 并启用 TCP 监听(如 tcp://0.0.0.0:2375 或带 TLS 的 tcp://0.0.0.0:2376)。

  • 检查是否启用本地 socket:ls -l /var/run/docker.sock
  • 验证守护进程状态:systemctl is-active docker(Linux)或查看 Docker Desktop 是否运行(macOS/Windows)
  • 远程调用前务必配置 TLS 认证,避免未授权访问风险

构造标准 REST 请求

每个 API 调用由三部分组成:HTTP 方法(GET/POST/DELETE 等)、API 版本路径(如 /v1.44)、以及可选查询参数和 JSON 请求体。

Docker Cli
Docker Cli

使用 Docker CLI 构建、运行、停止、检查和管理容器与镜像的助手。用于执行容器相关任务。

下载
  • 获取守护进程信息:curl --unix-socket /var/run/docker.sock http://localhost/v1.44/info
  • 列出所有容器:curl --unix-socket /var/run/docker.sock "http://localhost/v1.44/containers/json?all=1"
  • 创建容器:curl -X POST --unix-socket /var/run/docker.sock -H "Content-Type: application/json" -d '{"Image":"nginx:alpine"}' http://localhost/v1.44/containers/create
  • 启动容器:curl -X POST --unix-socket /var/run/docker.sock http://localhost/v1.44/containers/{id}/start(将 {id} 替换为实际容器 ID)

使用编程语言调用更可靠

手动发 curl 请求适合调试,生产环境建议用官方或社区维护的 SDK,自动处理连接、版本协商、错误解析和流式响应。

  • Go:用 github.com/docker/docker/client,支持 socket/TCP/TLS 自动适配
  • Python:推荐 docker-py(import docker; client = docker.from_env())
  • Java:使用 docker-java 库,基于 OkHttp 封装,类型安全
  • Node.js:可用 docker-modem 或 dockerode

调试与排错要点

遇到“connection refused”或“permission denied”,优先查通信路径和权限;返回 404 多因 API 路径或版本不匹配;400 通常因 JSON 格式错误或必填字段缺失。

  • 开启 CLI 调试模式看底层请求:docker --debug info
  • 用 tcpdump -i lo port 2375 抓包验证 TCP 流量(远程场景)
  • 检查 API 文档对应版本:https://www.php.cn/link/35e5b98f0069039f5e0b4cdcbb9e34a5,注意 v1.42、v1.44 等版本差异
  • 容器创建失败时,先确认镜像已存在本地,或在请求体中设置 "Pull": true

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

相关文章

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

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

下载

相关标签:

docker rest api docker 容器

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

相关专题

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

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

2023.07.24

645

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

4539

6

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

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

2024.04.08

5417

6

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

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

2024.04.08

2033

7

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

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

2026.02.11

219

16

Docker 容器部署
Docker 容器部署

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

2026.03.31

411

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

360

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

265

24

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

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

2026.05.19

385

15

热门下载

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

精品课程

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

共0课时 | 0人学习

Docker 官方文档
Docker 官方文档

共0课时 | 0人学习

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

共0课时 | 0人学习