pysergio/stubborn

Stubborn

概述

Stubborn 是前端开发及API测试调试的终极工具。通过Stubborn，您可以轻松创建模拟响应以模拟不同场景，将请求代理至其他服务器，调用webhook测试集成效果，并提供完整的请求与响应日志，清晰查看后台交互过程。此外，Stubborn为开源且自托管工具，可部署在自有基础设施并根据特定需求定制。

核心功能与特性

• 可定制的web资源模拟
• 支持自定义响应超时
• 完整的“中间人服务”功能：允许将请求代理至第三方资源，全面捕获被测应用与第三方服务间的所有交互（包括选择性模拟端点的能力）
• 可在被测应用与Stubborn交互的任意时刻调用其webhook
• 支持JSON、XML和文本格式的响应体
• 包含请求与响应数据的详尽事件日志，并提供GUI界面

前提条件

Stubborn以https://hub.docker.com/r/pysergio/stubborn%E5%BD%A2%E5%BC%8F%E6%8F%90%E4%BE%9B%E3%80%82%E4%BD%BF%E7%94%A8%E5%89%8D%E9%9C%80%E5%9C%A8%E8%AE%BE%E5%A4%87%E4%B8%8A%E5%AE%89%E8%A3%85Docker Engine，强烈推荐同时安装Docker Compose。

支持平台：

• linux/amd64
• linux/arm64
• linux/arm32/v7（是的！您可以在树莓派上运行它！）

快速开始

以下是实际使用示例：

1. 在任意目录创建 docker-compose.yml 文件：

yaml
version: '3'

services:
  postgres:
    image: postgres:14-alpine
    restart: unless-stopped
    volumes:
      - pg_data:/var/lib/postgresql/data
    environment:
      POSTGRES_DB: stubborn
      POSTGRES_USER: stubborn
      POSTGRES_PASSWORD: notsecret

  stubborn:
    image: pysergio/stubborn:latest
    restart: unless-stopped
    environment:
      DATABASE_URL: postgres://stubborn:notsecret@postgres:5432/stubborn
      ADMIN_EMAIL: admin@example.com
      ADMIN_PASSWORD: admin
      ADMIN_USERNAME: admin
      SECRET_KEY: 'stubborn-not-secure!k%6kqx6a)-a6d7j8*n(!154#t+^5f)#^z5mjvlrf#u!'
      UWSGI_THREADS: 3
    ports:
      - "8000:8000"
    depends_on:
      - postgres

volumes:
  pg_data:

上述示例中，部分环境变量对应用配置至关重要，说明如下：

• DATABASE_URL (必填)：包含数据库连接信息的URL
• SECRET_KEY (必填)：提供加密签名的密钥，需设置为唯一且不可预测的值
• ADMIN_USERNAME (仅首次运行必填)：管理员账户的用户名
• ADMIN_PASSWORD (仅首次运行必填)：管理员账户的密码
• ADMIN_EMAIL (仅首次运行必填)：管理员账户的***
• DOMAIN_DISPLAY (可选)：应用实例的协议和域名，如 https://mysite.com、http://192.168.1.150:8000，默认值为 http://127.0.0.1:8000
• UWSGI_THREADS (可选)：每个uWSGI工作进程的线程数（与Stubborn无直接关联）

2. 运行以下命令：

shell
docker-compose up -d

注意，上述命令中的 -d 参数会使Docker Compose在后台运行 docker-compose.yml 中定义的应用。

服务启动后，可通过 <[***]> 访问。要进入管理面板，请访问 http://localhost:8000/admin/ 并使用管理员账户登录。

更多示例请访问 https://github.com/s-nagaev/stubborn/tree/main/examples%E3%80%82