inanimate/echo-server

Echo Server 增强版

这是一个用Go编写的轻量级HTTP回声服务器，最初为Kubernetes设计，但也适用于其他场景，同时支持WebSocket功能。其目标是可靠地提供当前会话、服务实例的有用信息，帮助测试负载均衡器、Web服务器和浏览器等组件。

核心功能

• 默认GET请求返回丰富的实用信息（如请求头、环境变量、DNS配置等）。
• WebSocket客户端发送的消息会被回声返回。
• 访问/ws路径可通过交互式UI连接并发送WebSocket消息。
• 通过PORT和SSLPORT环境变量设置对应的服务端口。
• 内置SSL/TLS支持（包含测试用自签名证书）。

使用场景

• 测试负载均衡器的请求分发逻辑。
• 验证Web服务器的请求转发和头信息传递。
• 调试浏览器与服务器的交互过程。
• 查看Kubernetes Pod的实例信息（如Pod名称、IP、命名空间）。

配置说明

基础部署

bash
docker run -d -p 8080:8080 inanimate/echo-server

访问localhost:8080即可查看回声结果。

SSL/TLS配置

默认加密端口为8443，内置自签名证书（CN为cakewalk.herpderp.com），仅用于测试，请勿在生产环境公开使用。如需自定义证书，可克隆仓库生成证书后重新构建镜像。

自定义响应头

通过ADD_HEADERS环境变量设置JSON格式的响应头，默认包含X-Real-Server: echo-server：

bash
docker run -d -p 8080:8080 -e ADD_HEADERS='{"X-Foo": "bar", "X-Server": "cats1.0"}' inanimate/echo-server

Kubernetes变量支持

可通过以下Kubernetes变量在页面顶部快速查看Pod信息：

• POD_NAME：Pod名称（通过metadata.name设置）
• POD_NAMESPACE：Pod命名空间（通过metadata.namespace设置）
• POD_IP：Pod IP（通过status.podIP设置）

示例输出

（注：示例输出与英文描述一致，包含主机名、Pod信息、请求头、环境变量、DNS配置等内容）

Welcome to echo-server!  Here's what I know.
  > Head to /ws for interactive websocket echo!

-> My hostname is: echo-server-4282639374-6bvzg

-> My Pod Name is: echo-server-4282639374-6bvzg
-> My Pod Namespace is: playground
-> My Pod IP is: 10.2.1.30

...（其余内容与英文描述示例一致）

// 感谢使用echo-server，项目由Mario Loria（InAnimaTe）开发。 // 项目地址：https://github.com/inanimate/echo-server // Docker镜像地址：https://hub.docker.com/r/inanimate/echo-server