itzg/web-debug-server

web-debug-server 镜像文档

概述

web-debug-server 是一个极简的Web服务器，主要用于调试和查看HTTP请求详情。它能够接收HTTP请求并返回一个包含请求头、请求内容等详细信息的页面，帮助开发者快速分析请求数据。

核心功能与特性

• 轻量级设计：镜像体积小，资源占用低，启动速度快
• 请求信息展示：完整显示请求头（Headers）、请求方法、请求路径、查询参数及请求体内容
• 跨平台兼容：可在任何支持Docker的环境中运行
• 零配置启动：无需复杂配置，开箱即可使用

使用场景

• 开发调试：快速验证客户端发送的HTTP请求结构
• API测试：检查第三方服务或前端发送的请求详情
• 教学演示：展示HTTP请求的组成部分
• 网络问题排查：分析请求头和内容是否符合预期

使用方法

基本运行

通过以下命令启动容器，默认监听8080端口：

bash
docker run -p 8080:8080 itzg/web-debug-server

启动后，访问 http://localhost:8080 即可查看示例响应页面。发送POST、PUT等请求时，服务器会返回相应的请求内容。

自定义端口

如需使用自定义端口（如80端口），可通过端口映射实现：

bash
docker run -p 80:8080 itzg/web-debug-server

Docker Compose配置

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  web-debug:
    image: itzg/web-debug-server
    ports:
      - "8080:8080"
    restart: always

执行 docker-compose up -d 启动服务。

注意事项

• 该镜像仅用于开发调试环境，不建议在生产环境中使用
• 默认不提供身份验证和加密功能，请勿用于处理敏感数据
• 更多详细文档请访问 https://github.com/itzg/web-debug-server