jsonstiananan/pretender-proxy repository overview

# 1. 运行容器
docker run -d -p 8888:8888 jsonstiananan/pretender-proxy:latest

# 2. 测试 HTTP Mock
curl -x http://127.0.0.1:8888 http://www.example.com/api/test

# 运行容器（挂载配置目录）
docker run -d -p 8888:8888 -v ./mockConfig:/app/config jsonstiananan/pretender-proxy:latest

# 1. 克隆项目
git clone https://github.com/anansite/pretender.git
cd pretender

# 2. 安装依赖
pip install -r requirements.txt

# 3. 启动服务
python app.py

# 或使用便捷脚本
./start.sh

docker cp <container>:/app/certs/ca.crt ~/pretender-ca.crt

sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain ~/pretender-ca.crt

# 方式1：指定 CA 证书
curl -x http://127.0.0.1:8888 --cacert certs/ca.crt https://api.example.com/api/test

# 方式2：跳过证书验证
curl -k -x http://127.0.0.1:8888 https://api.example.com/api/test

mocks:
  # HTTPS Mock（URL以https://开头）
  - url: ^https://api\.example\.com/api/test$
    method: GET
    response:
      code: 200
      msg:
        message: "Hello from HTTPS Mock!"
        timestamp: "{{datetime.now}}"

  # 支持 IP 地址 + 非标准端口
  - url: ^https://172\.25\.224\.105:11111/api/rest/.*$
    method: GET
    response:
      code: 200
      msg:
        data: "HTTPS Mock Response"

mocks:
  - url: "^https?://example\.com/api/.*$"  # 正则匹配URL（支持http/https）
    method: "GET"                           # HTTP方法
    headers:                                # 请求头验证（可选）
      Authorization: "Bearer.*"
    response:                               # 响应配置
      code: 200                             # HTTP状态码
      msg:                                  # 响应内容
        message: "{{faker.sentence}}"
        data: "{{random.randint:1,100}}"
      delay: 1000                           # 延迟时间（毫秒，可选）

- url: ^http://api\.example\.com/users$
  method: GET
  response:
    code: 200
    msg:
      id: "{{faker.uuid4}}"
      name: "{{faker.name}}"

- url: ^http://api\.example\.com/secure$
  method: GET
  headers:
    Authorization: "Bearer.*"
  response:
    code: 200
    msg:
      message: "认证成功"

- url: ^http://api\.example\.com/slow$
  method: GET
  response:
    code: 200
    msg:
      message: "延迟响应"
    delay: 3000  # 延迟3秒

# Mock 响应
curl -x http://127.0.0.1:8888 http://www.example.com/api/test

# 代理转发（未匹配Mock规则）
curl -x http://127.0.0.1:8888 http://httpbin.org/get

# 使用 CA 证书
curl -x http://127.0.0.1:8888 --cacert certs/ca.crt https://api.example.com/api/test

# 跳过证书验证
curl -k -x http://127.0.0.1:8888 https://api.example.com/api/test

# HTTPS 透传（未匹配，转发到真实服务器）
curl -k -x http://127.0.0.1:8888 https://httpbin.org/get

-Dhttp.proxyHost=localhost -Dhttp.proxyPort=8888
-Dhttps.proxyHost=localhost -Dhttps.proxyPort=8888

import os
os.environ['HTTP_PROXY'] = 'http://localhost:8888'
os.environ['HTTPS_PROXY'] = 'http://localhost:8888'

process.env.HTTP_PROXY = 'http://localhost:8888';
process.env.HTTPS_PROXY = 'http://localhost:8888';

# 基础运行
docker run -d -p 8888:8888 jsonstiananan/pretender-proxy:latest

# 挂载配置 + 持久化证书
docker run -d -p 8888:8888 \
  -v ./mockConfig:/app/config \
  -v ./certs:/app/certs \
  jsonstiananan/pretender-proxy:latest

# 导出 CA 证书
docker cp <container>:/app/certs/ca.crt .

pip install -r requirements.txt
python app.py

pretender/
├── app.py                        # 主入口（asyncio 事件循环）
├── requirements.txt              # 依赖
├── Dockerfile
├── start.sh
├── config/
│   └── mock_config.yaml          # Mock 配置
├── certs/                        # 自动生成
│   ├── ca.key                    # Root CA 私钥
│   ├── ca.crt                    # Root CA 证书（客户端需信任）
│   └── domains/                  # 域名证书缓存
└── src/
    ├── core/
    │   ├── config_manager.py     # 配置管理（热更新）
    │   ├── cert_manager.py       # CA + 域名证书签发
    │   └── data_generator.py     # 模板数据生成
    ├── handlers/
    │   └── response_handler.py   # Legacy 同步响应处理
    └── server/
        ├── async_proxy.py        # asyncio TCP 代理（HTTP + HTTPS MITM）
        └── proxy_server.py       # Legacy 同步代理服务器

Client → Proxy(8888)
  ├─ HTTP:    解析URL → 噪音过滤 → match_mock()
  │             ├─ 匹配 → DataGenerator → Mock JSON 响应
  │             └─ 未匹配 → httpx 转发 → 真实服务器
  └─ CONNECT: 动态签发证书 → TLS 握手 → 读取明文请求 → 同上流程