traefik/whoamiudp

WhoamiUDP

https://github.com/traefik/whoamiudp/workflows/Main/badge.svg?branch=master](https://github.com/traefik/whoamiudp/actions)

镜像概述和主要用途

WhoamiUDP 是一个基于 Go 语言开发的轻量级 UDP 服务器镜像。其核心功能是接收 UDP 请求，并将操作系统信息及请求内容输出至控制台。该镜像设计简洁，资源占用低，主要用于 UDP 网络环境下的测试与调试场景。

核心功能和特性

• 轻量级设计：基于 Go 语言构建，镜像体积小，运行资源消耗低。
• UDP 协议支持：专注于 UDP 协议请求处理，适配无连接网络场景。
• 信息输出：自动打印服务器运行环境的操作系统信息（如系统类型、架构等）及接收到的 UDP 请求原始数据。
• 可配置性：支持自定义监听端口和服务器名称，适配不同网络环境需求。

使用场景和适用范围

• UDP 网络测试：验证 UDP 流量是否正常传输（如通过反向代理、负载均衡器后的 UDP 转发是否生效）。
• 服务调试：调试 UDP 服务接收逻辑，快速查看请求源信息及数据格式。
• 请求信息收集：临时部署以收集 UDP 请求元数据（如来源 IP、端口、 payload 内容）。
• 教学演示：作为简单 UDP 服务器示例，展示基础网络编程与 Docker 容器化实践。

详细使用方法和配置说明

Docker 运行命令

通过 docker run 直接启动容器，需指定 UDP 端口映射及必要参数：

bash
docker run -d \
  --name whoamiudp \
  -p 8080:8080/udp \  # 映射 UDP 端口（主机端口:容器端口）
  traefik/whoamiudp \
  --port :8080 \       # 容器内 UDP 监听端口（默认 :8080）
  --name my-udp-server # 自定义服务器名称（用于输出标识，可选）

说明：

• -p 8080:8080/udp：必须显式指定 UDP 协议，否则默认使用 TCP。
• 若不指定 --port 和 --name，将使用默认值（端口 :8080，名称为空）。

Docker Compose 配置

创建 docker-compose.yml 文件，定义服务配置：

yaml
version: '3'
services:
  whoamiudp:
    image: traefik/whoamiudp
    container_name: whoamiudp
    ports:
      - "8080:8080/udp"  # UDP 端口映射
    command:
      - --port=:8080     # 监听端口（默认 :8080）
      - --name=demo-udp  # 服务器名称（可选）
    restart: unless-stopped  # 异常退出后自动重启（可选）

启动服务：

bash
docker-compose up -d

配置参数说明

使用示例：
若需修改监听端口为 9000 并命名为 test-server，命令行参数为 --port :9000 --name test-server。

查看输出日志

容器运行后，通过以下命令查看实时输出日志（包含 OS 信息和请求数据）：

bash
docker logs -f whoamiudp  # -f 表示实时跟踪日志

典型输出示例：
当接收到 UDP 请求时，日志将显示：

[my-udp-server] OS Info: linux/amd64
[my-udp-server] Request received from 192.168.1.100:54321: "Hello UDP Server"