socat-test Docker镜像文档

一、镜像概述

1.1 主要用途

socat-test镜像是一个轻量级容器，通过socat工具将Docker Unix socket（默认路径/var/run/docker.sock）转发并暴露在TCP 2375端口，实现Docker守护进程的网络访问能力。其核心用途是为开发测试场景提供快速、便捷的Docker socket远程访问方案，尤其适用于结合Rancher SDN（软件定义网络）进行跨节点Docker通信或集成测试。

二、核心功能与特性

• Docker Socket TCP暴露：通过socat将Unix域套接字（/var/run/docker.sock）转发至TCP 2375端口，支持外部通过网络访问Docker API。
• 轻量级设计：基于极简基础镜像，资源占用低，启动速度快。
• 即开即用：无需复杂配置，挂载Docker socket后即可运行。
• 兼容性：兼容标准Docker API，支持通过TCP端口调用Docker守护进程功能（如容器管理、镜像操作等）。

三、使用场景与适用范围

3.1 适用场景

• 开发测试环境：临时需要远程访问Docker守护进程的场景（如多节点协作测试、CI/CD工具链调试）。
• Docker API验证：快速验证Docker API功能或第三方工具与Docker的集成效果。
• Rancher SDN集成测试：结合Rancher提供的SDN能力，测试跨节点Docker容器通信、网络策略等功能。

3.2 限制与安全提示

• 仅限测试环境：暴露Docker socket存在严重安全风险（如未授权访问可直接控制宿主机资源），严禁在生产环境使用。
• 需控制访问范围：建议仅在隔离网络中使用，并限制TCP 2375端口的访问来源（如通过防火墙或网络策略限制IP）。

四、使用方法与配置说明

4.1 前提条件

• 宿主机已安装Docker引擎（版本≥1.12），且Docker守护进程正在运行（确保/var/run/docker.sock存在且可访问）。
• 宿主机网络需允许TCP 2375端口通信（如需外部访问，需配置端口映射或防火墙规则）。

4.2 基本使用（docker run命令）

通过docker run直接启动容器，需挂载宿主机Docker socket并映射TCP端口：

docker run -d \
  --name socat-test \
  -p 2375:2375 \  # 将容器内2375端口映射到宿主机2375端口
  -v /var/run/docker.sock:/var/run/docker.sock \  # 挂载宿主机Docker socket
  rancher/socat-test  # 镜像名称（基于Dockerfile仓库推断）

参数说明：

• -p 2375:2375：端口映射，格式为宿主机端口:容器内端口，默认使用2375端口（可根据需求修改宿主机端口，如-p 12375:2375）。
• -v /var/run/docker.sock:/var/run/docker.sock：挂载宿主机Docker socket至容器内，是实现转发功能的核心依赖。

4.3 Docker Compose配置

如需通过Docker Compose管理，可创建docker-compose.yml文件：

version: '3.8'
services:
  socat-test:
    image: rancher/socat-test
    container_name: socat-test
    ports:
      - "2375:2375"  # 端口映射
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock  # 挂载Docker socket
    restart: unless-stopped  # 容器退出时自动重启（可选）

启动命令：

docker-compose up -d

4.4 验证与测试

容器启动后，可通过以下方式验证功能是否正常：

1. 本地访问测试：在宿主机执行命令，检查Docker API是否可通过TCP 2375访问：

   curl http://localhost:2375/version  # 调用Docker API获取版本信息
   

   若返回类似以下内容，说明配置成功：

   {"Version":"20.10.21","ApiVersion":"1.41",...}
   

2. 远程访问测试：在同一网络的其他节点，通过宿主机IP访问TCP 2375端口（需确保网络可达）：

   curl http://<宿主机IP>:2375/containers/json  # 列出宿主机上的容器
   

五、参考链接

• Dockerfile源码：[***]
• Socat工具文档：[***]
• Docker Unix Socket说明：Docker官方文档 - 守护进程 socket