cilium/echoserver

cilium/echoserver 镜像文档

镜像概述

cilium/echoserver是k8s.gcr.io/echoserver的分支镜像，主要作为轻量级回声服务器使用。与原镜像相比，其核心差异在于监听端口可通过环境变量$PORT灵活配置，替代了原有的固定8080端口，更适用于不同网络环境下的测试需求。

核心功能与特性

• 回声服务：接收HTTP请求并返回详细的请求信息，包括HTTP方法、头信息、请求路径、客户端IP等
• 端口可配置：通过环境变量$PORT指定服务监听端口，默认替换原镜像的8080端口
• 轻量级设计：镜像体积小，启动快速，适合作为测试工具或示例应用部署

使用场景

• Kubernetes集群内服务间网络连通性测试
• 容器网络配置验证（如端口映射、服务发现）
• HTTP请求处理流程测试（如代理、负载均衡）
• 开发环境中的临时服务占位或示例应用

使用方法

基本运行方式

通过docker run命令启动容器，指定监听端口：

bash
docker run -d -p <宿主机端口>:<容器端口> -e PORT=<容器端口> cilium/echoserver

示例：将容器端口设置为80，宿主机端口映射为8080

bash
docker run -d -p 8080:80 -e PORT=80 cilium/echoserver

启动后，可通过http://localhost:8080访问服务，将收到包含请求信息的响应。

环境变量配置

Docker Compose配置示例

yaml
version: '3'
services:
  echoserver:
    image: cilium/echoserver
    ports:
      - "8080:80"  # 宿主机8080端口映射到容器80端口
    environment:
      - PORT=80  # 设置容器内监听端口为80
    restart: always

启动命令：docker-compose up -d

注意事项

• 确保宿主机端口与容器端口映射正确，避免端口冲突
• 若未指定PORT环境变量，将默认使用原镜像的8080端口
• 该镜像主要用于测试目的，不建议在生产环境中部署