如何在Docker容器内部正确发起Docker Engine API调用以列出所有镜像？

1. 404 报错的直接修正 #

执行Unix套接字调用时出现{"message":"page not found"}，核心原因是curl请求的URL格式不符合路径解析规则。
错误命令：
curl --unix-socket /var/run/docker.sock http://images/json
上述命令的URL结构会被解析为：使用http协议、目标主机为images、请求路径为/json，和Docker API定义的/images/json端点完全不匹配，因此返回404。
修正后的正确命令为：
curl --unix-socket /var/run/docker.sock http://localhost/images/json
执行后即可正常返回本地所有Docker镜像的结构化列表。

2. 连通性前置校验 #

如果修正命令后仍无法正常返回结果，依次检查两项基础配置：

• 容器启动时必须完成宿主机Docker套接字挂载。Docker run启动时需添加-v /var/run/docker.sock:/var/run/docker.sock参数；compose部署时需在对应服务的volumes配置中追加相同的挂载路径。无此挂载的容器内部不存在套接字文件，所有API调用都会失败。
• 容器基础镜像已预装curl工具。多数精简类基础镜像（如Alpine、Distroless）默认不带curl，需先通过对应包管理器安装后再执行请求。

3. TCP连接方案失效原因 #

之前尝试的容器IP、localhost、compose服务名等TCP连通方式全部失败，是由于Docker Engine默认仅监听本地Unix套接字，未开放TCP端口远程访问。除非手动修改Docker daemon配置显式开启TCP监听，否则所有基于TCP的API请求都会无法连通，无需在这类地址上继续排查。

安全提示：将Docker套接字挂载到容器内相当于赋予容器对宿主机Docker的完整操作权限，生产环境使用需做严格的权限管控，避免未授权的镜像篡改、容器逃逸风险。

内容的提问来源于stack exchange，提问作者Veverke