hairyhenderson/socat 镜像文档

镜像概述

hairyhenderson/socat是一个轻量级Docker镜像，基于Alpine Linux构建，集成了Socat网络工具及ca-certificates证书包。Socat（Socket CAT）是一款功能强大的网络数据转发工具，支持多种协议和连接类型，而ca-certificates的预装则优化了HTTPS等加密连接场景的使用体验。

核心功能与特性

• 轻量级基础：采用Alpine Linux作为基础镜像，具有体积小（通常小于10MB）、启动快、资源占用低的特点
• Socat工具集成：完整包含Socat功能，支持TCP/UDP端口转发、协议转换、文件描述符连接、网络调试等多种网络操作
• HTTPS支持：内置ca-certificates证书集合，可直接处理HTTPS相关连接，无需额外配置根证书

使用场景

• 临时网络端口转发（如本地服务转发至远程服务器）
• 不同网络协议间的转换（如TCP转UDP、IPv4转IPv6）
• HTTPS连接调试与数据捕获
• 简单的网络代理或数据中继服务搭建
• 容器间或容器与主机间的网络连接桥接

使用方法与配置说明

基本用法

镜像运行时直接通过命令行参数指定Socat操作，基本格式如下：

bash
docker run --rm hairyhenderson/socat [socat-命令参数]

可通过以下命令查看Socat完整帮助信息：

bash
docker run --rm hairyhenderson/socat -h

常用操作示例

1. TCP端口转发

将本地8080端口的TCP流量转发至example.com的80端口：

bash
docker run --rm -p 8080:8080 hairyhenderson/socat TCP4-LISTEN:8080,fork TCP4:example.com:80

参数说明：fork选项允许处理多个并发连接；-p 8080:8080将容器内8080端口映射到主机

2. HTTPS连接测试

建立HTTPS连接并查看原始通信数据：

bash
docker run --rm hairyhenderson/socat - OPENSSL:example.com:443

此时可在终端输入HTTP请求（如GET / HTTP/1.1\r\nHost: example.com\r\n\r\n），查看服务器响应

3. UDP流量转发

将本地5353端口的UDP流量转发至公共DNS服务器（8.8.8.8:53）：

bash
docker run --rm -p 5353:5353/udp hairyhenderson/socat UDP4-LISTEN:5353,fork UDP4:8.8.8.8:53

4. 双向管道连接

创建两个终端间的双向数据管道（需先启动服务端，再启动客户端）：

• 服务端（监听本地9000端口）：

  bash
  docker run --rm -p 9000:9000 hairyhenderson/socat TCP4-LISTEN:9000 STDIO
  

• 客户端（连接服务端）：

  bash
  docker run --rm hairyhenderson/socat TCP4:host.docker.internal:9000 STDIO
  

注意事项

• 涉及端口映射时需正确使用-p/--publish参数暴露容器端口
• 处理敏感数据时应注意网络传输安全性，避免未加密的明文传输
• 复杂网络场景（如跨主机通信）可能需要配合--network参数配置网络模式（如--net=host）
• 更多Socat高级用法可参考***文档