python-requests-logging 镜像文档

镜像概述和主要用途

python-requests-logging 是一个轻量级的Python HTTP服务器镜像，主要功能是接收并记录所有传入的HTTP请求。该镜像设计简洁，易于部署，适用于开发、测试环境中快速搭建请求记录服务，帮助开发者调试和分析HTTP请求数据。

核心功能和特性

• 轻量级设计：基于Python构建，镜像体积小，资源占用低
• 请求记录：捕获并记录HTTP请求的完整信息，包括请求方法、URL、头信息、查询参数及请求体
• 简单易用：无需复杂配置，启动即可使用
• 灵活部署：支持通过Docker快速启动，可自定义监听端口
• 日志输出：默认将请求日志打印至标准输出，便于查看和收集

使用场景和适用范围

• 开发环境中调试API接口，验证客户端发送的请求格式
• 测试Webhook接收服务，记录第三方系统发送的回调请求
• 教学或演示场景中，直观展示HTTP请求的组成结构
• 临时搭建请求中转站，收集客户端请求数据用于分析

使用方法和配置说明

快速启动（Docker Run）

通过以下命令可快速启动容器，默认监听80端口：

docker run -p 8080:80 adrienkuhn/python-requests-logging

• -p 8080:80：将容器内的80端口映射到主机的8080端口（可根据需求修改主机端口）

自定义端口

若需修改容器内监听端口，可通过环境变量 PORT 指定（需确保镜像支持该配置，具体以实际镜像实现为准）：

docker run -p 3000:3000 -e PORT=3000 adrienkuhn/python-requests-logging

Docker Compose 配置

创建 docker-compose.yml 文件，内容如下：

version: '3'
services:
  requests-logger:
    image: adrienkuhn/python-requests-logging
    ports:
      - "8080:80"
    restart: always

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

注意事项

• 该镜像主要面向开发、测试场景，不建议直接用于生产环境
• 更多高级配置（如日志格式自定义、持久化日志等）可参考项目GitHub仓库：AdrienKuhn/python-requests-logging