cilium/echoserver-udp 镜像文档

镜像概述和主要用途

cilium/echoserver-udp 是一个轻量级TFTP服务器镜像，专注于UDP连接性测试。它支持单端口UDP监听，能够接收TFTP请求并返回详细的请求信息，包括客户端IP、端口、请求路径及服务器主机名等，功能类似于 cilium/echoserver，但专为UDP协议优化。

核心功能和特性

• 单端口UDP支持：默认启用单端口模式，简化UDP端口管理
• 详细请求信息输出：返回客户端IP地址、端口、请求路径、请求协议等关键信息
• 可配置监听地址：支持自定义监听的主机和端口
• 轻量级部署：可通过二进制、Makefile或Docker容器快速启动

使用场景和适用范围

适用于以下场景：

• UDP连接性测试与验证
• TFTP协议通信调试
• 网络环境中UDP端口可达性检测
• 开发和测试环境中的UDP服务模拟

使用方法和配置说明

镜像获取

容器镜像托管于Quay.io：quay.io/cilium/echoserver-udp

启动服务器

支持多种启动方式，以下为常用示例：

1. 直接运行二进制（本地编译后）

console
# 默认监听 :69 端口
./echoserver-udp

# 自定义非特权端口监听
./echoserver-udp -listen :6969

# 自定义主机名
HOSTNAME=deathstar ./echoserver-udp

2. 通过Makefile运行（源码环境）

console
HOSTNAME=deathstar make run

3. 通过Docker容器运行

console
docker run --rm -it --name echoserver-udp -p 69:69/udp quay.io/cilium/echoserver-udp

注：-p 69:69/udp 映射容器UDP端口到主机，--rm 退出时自动清理容器

发送测试请求

使用TFTP客户端发送请求（示例使用curl）：

console
$ curl t[***]

示例响应

Hostname: deathstar

Request Information:
	client_address=::1
	client_port=50797
	real path=/hello
	request_scheme=tftp

可用配置参数（Flags）

启动时可通过以下标志调整服务器行为：

console
Usage of ./echoserver-udp:
  -listen string
        监听的主机:端口（默认 ":69"）
  -single-port
        是否使用单UDP端口（默认 true）

参数说明

• -listen：指定监听地址，格式为host:port，默认值为:69（监听所有网卡的69端口）
• -single-port：是否启用单端口模式（默认true），禁用时可能使用多端口处理请求