docksal/socat

docker.sock proxy

镜像概述

该镜像基于socat工具，用于将Docker守护进程的Unix套接字(/var/run/docker.sock)代理为TCP服务，暴露在tcp://docker-sock-proxy:2375地址，实现容器内或远程对Docker守护进程的访问。

核心功能与特性

• 套接字代理：将Docker Unix套接字转换为TCP服务，简化跨容器或远程访问Docker API的配置
• 轻量级实现：基于socat工具，镜像体积小，资源占用低
• 灵活部署：支持基础本地代理和远程访问两种模式

使用场景

• 容器化应用需要与宿主机Docker守护进程交互的场景
• CI/CD流水线中容器内管理Docker资源（如构建、推送镜像）
• 多容器环境中跨容器访问Docker API的需求

使用方法

基础本地代理

通过以下命令启动容器，将Docker套接字代理到容器内的TCP服务：

bash
docker run -v /var/run/docker.sock:/var/run/docker.sock -d --restart=always --name docker-sock-proxy docksal/socat

参数说明：

• -v /var/run/docker.sock:/var/run/docker.sock: 挂载宿主机Docker套接字到容器内
• -d: 后台运行容器
• --restart=always: 容器退出时自动重启
• --name docker-sock-proxy: 指定容器名称为docker-sock-proxy

允许远程连接（风险提示）

如需允许外部非TLS连接访问宿主机Docker守护进程（风险自负），可使用以下命令：

bash
docker run -v /var/run/docker.sock:/var/run/docker.sock -d --restart=always --privileged -p 2375:2375 --name docker-sock-proxy docksal/socat

说明：

• 新增-p 2375:2375参数将容器2375端口映射到宿主机，允许外部访问
• --privileged赋予容器特权模式
• 此配置会暴露未加密的Docker守护进程访问，存在安全风险，仅建议在隔离环境中使用