dellabetta/tcpserver

dellabetta/tcpserver

基于Alpine的镜像，包含D.J.Bernstein开发的tcpserver工具（来自ucspi-tcp项目），灵感来源于https://github.com/appropriate/docker-nc%EF%BC%8C%E6%BA%90%E7%A0%81%E5%8F%8A%E8%A1%A5%E4%B8%81%E5%9D%87%E6%9D%A5%E8%87%AA%E5%90%88%E6%B3%95%E5%85%AC%E5%BC%80%E6%B8%A0%E9%81%93%E3%80%82

镜像概述

此镜像提供轻量级TCP服务能力，通过tcpserver工具监听指定端口，接收客户端连接并运行用户指定程序，程序可通过标准输入输出与客户端交互，同时设置相关环境变量。

核心功能

1. 监听指定TCP端口（支持端口号或/etc/services中的服务名）
2. 为每个连接运行指定程序，程序通过0号描述符读取网络数据、1号描述符写入网络数据
3. 设置环境变量（如远程主机IP、主机名、本地端口等）
4. 支持连接数限制、DNS解析控制、用户/组切换等配置选项

使用场景

• 快速搭建测试用TCP服务（如回声服务、简单数据接收服务）
• 轻量级TCP协议原型验证
• 本地开发环境中的临时TCP服务需求

配置说明

基本用法

console
docker run -it --rm dellabetta/tcpserver [选项] 主机 端口 程序 [程序参数]

关键选项

• 通用选项：-q（静默模式，不打印错误信息）、-v（ verbose模式，打印错误及状态信息）
• 连接选项：-c n（最大同时连接数，默认40）、-x cdb（使用tcprules编译的规则文件）、-u uid/-g gid（切换运行程序的用户/组ID）
• 数据收集选项：-h/-H（是否解析远程主机名）、-p/-P（是否验证远程主机名的IP一致性）
• 其他选项：-1（启动后输出本地端口号）、-b n（TCP SYN backlog大小）

部署示例

回声服务示例

监听本地5678端口，客户端连接时返回"5678"：

console
docker run -it -p 5678:5678 --rm dellabetta/tcpserver 0 5678 echo 5678

许可证

版权所有 © 2017 Filippo Della Betta，所有内容基于MIT许可证授权。