czerasz/http-debugger

Simple HTTP Debugging Application

本仓库包含用于Docker的Dockerfile，对应https://registry.hub.docker.com/u/czerasz/http-debugger/%E5%B7%B2%E5%8F%91%E5%B8%83%E8%87%B3%E5%85%AC%E5%85%B1https://registry.hub.docker.com/%E3%80%82

镜像概述和主要用途

Simple HTTP Debugging Application是一个轻量级HTTP调试工具的Docker镜像，基于Node.js构建，主要用于捕获并展示HTTP请求的详细信息。通过该镜像，开发者可直观查看请求方法、路径、头信息、请求体等内容，适用于开发和调试阶段验证HTTP请求是否符合预期。

核心功能和特性

• 请求详情捕获：完整展示HTTP请求的方法、路径、协议版本、头信息、请求体及时间戳
• 轻量级设计：基于node:6.7.0-slim基础镜像，体积小且启动快速
• 易用性：无需复杂配置，启动容器即可开始调试
• 多访问方式：支持通过TCP端口或Unix Socket接收HTTP请求

使用场景和适用范围

• 开发过程中调试客户端与服务端的HTTP交互
• 验证请求头信息、请求体格式是否符合接口规范
• 排查第三方服务或客户端发送的异常请求
• 教学场景中展示HTTP请求结构

详细使用方法和配置说明

基础镜像

• https://registry.hub.docker.com/_/node/

安装

1. 安装Docker环境
2. 获取镜像：
   • 从Docker Hub拉取（推荐）：

     bash
     docker pull czerasz/http-debugger
     

   • 或通过Dockerfile构建：

     bash
     docker build --tag czerasz/http-debugger github.com/czerasz/docker-http-debugger
     

使用方法

基本使用

1. 启动容器：

   bash
   docker run -t --rm -p 3000:3000 czerasz/http-debugger
   

   • -t：分配终端以查看日志输出
   • --rm：容器退出后自动删除
   • -p 3000:3000：将容器3000端口映射至主机3000端口

2. 测试请求：使用curl发送测试请求

   bash
   curl -i -XPOST localhost:3000/test -d 'test=true'
   

   响应示例：

   HTTP/1.1 200 OK
   X-Powered-By: Express
   X-Debug: true
   Content-Type: text/html; charset=utf-8
   Content-Length: 2
   ETag: W/"2-79dcdd47"
   Date: Wed, 13 May 2015 16:25:37 GMT
   Connection: keep-alive
   
   ok
   

3. 查看请求详情：返回容器运行的终端，可看到完整请求日志：

   > debugging_application@1.0.0 start /usr/local/bin/app
   > node index.js
   
   Debugging app listening at http://:::3000
   
   --- --- --- --- --- --- --- --- --- --- --- --- ---
   
   [2015-05-13 16:25:37] Request 1
   
   POST/1.1 /test on :::3000
   
   Headers:
    - user-agent: curl/7.38.0
    - host: localhost:3000
    - accept: */*
    - content-length: 9
    - content-type: application/x-www-form-urlencoded
   
   No cookies
   
   Body:
   test=true
   

使用Unix Socket

若需通过Unix Socket接收请求：

1. 创建Socket目录（确保目录存在）：

   bash
   SOCKET_DIRECTORY=/var/app/app_name/shared/tmp/sockets/
   mkdir -p $SOCKET_DIRECTORY
   

2. 启动容器（挂载目录并指定Socket路径）：

   bash
   docker run -t --rm \
         -v $SOCKET_DIRECTORY:$SOCKET_DIRECTORY \
         -e LISTEN_SOCKET="${SOCKET_DIRECTORY}app_name.0.sock" \
         czerasz/http-debugger