alchen99/web-echo

alchen99/web-echo镜像说明

镜像概述

alchen99/web-echo是一个轻量级HTTP/HTTPS请求回显工具，可将请求的详细属性（如方法、路径、头信息、请求体）返回给客户端，并同步记录到Docker日志中，是开发者调试网络请求的实用工具。

核心功能

• 支持HTTP和HTTPS协议的请求回显
• 回显内容包含请求方法、路径、头信息、请求体等关键属性
• 同步将请求详情写入Docker日志，便于后台排查
• 允许自定义SSL证书，适配生产环境HTTPS需求

使用场景

• 开发者调试API接口，验证请求参数和头信息是否正确
• 测试代理服务器、负载均衡器的请求转发逻辑
• 学习HTTP/HTTPS协议，直观理解请求结构
• 验证客户端发送的请求格式是否符合预期

配置说明与部署示例

Docker Run快速部署

bash
docker run -p 8080:80 -p 8443:443 --rm -t alchen99/http-https-echo

部署后可通过以下方式测试：

• 浏览器访问：http://localhost:8080 或 https://localhost:8443（HTTPS需忽略证书警告）
• Curl命令：

  bash
  curl -k -X PUT -H "Arbitrary:Header" -d aaa=bbb https://localhost:8443/hello-world
  

Docker Compose部署（自定义证书）

可替换为自己的SSL证书，示例使用系统默认snakeoil证书：

yaml
my-http-listener:
    image: alchen99/http-https-echo
    ports:
        - "8080:80"
        - "8443:443"
    volumes:
        - /etc/ssl/certs/ssl-cert-snakeoil.pem:/app/fullchain.pem
        - /etc/ssl/private/ssl-cert-snakeoil.key:/app/privkey.pem

Kubernetes部署

执行项目k8目录下的YAML文件即可完成部署：

bash
kubectl apply -f k8/[对应的YAML文件名]

输出示例

• 客户端输出：直接返回请求的方法、路径、头信息、请求体等内容
• Docker日志输出：详细记录请求的所有属性，便于后台分析和调试
• 项目提供的截图展示了浏览器、curl及Docker日志的输出效果（可参考原镜像文档中的截图链接）