Hoppscotch logo

Hoppscotch

开源、基于 Web 的轻量 API 调试平台

API调试开源WebGraphQL

开源、基于浏览器的 API 调试平台，无需安装即可发送 HTTP、GraphQL、WebSocket 等请求。以极轻量、隐私友好和自托管能力著称，是个人开发者、开源项目和快速 API 验证的理想选择，也可作为 Postman/Insomnia 的轻量替代。

访问官网

Hoppscotch 开源 Web API 调试工具技术调研

Hoppscotch 是开源、基于浏览器的 API 调试平台，无需安装即可发送 HTTP、GraphQL、WebSocket 等请求。以极轻量、隐私友好和自托管能力著称，是个人开发者、开源项目和快速 API 验证的理想选择，也可作为 Postman/Insomnia 的轻量替代。

一、 基本信息

维度关键指标 / 描述
技术标签API 客户端 / 开源 / Web / GraphQL / WebSocket / 自托管
开发商Hoppscotch 开源社区
官方网站https://hoppscotch.com/
GitHub 仓库hoppscotch/hoppscotch
许可协议MIT License
首次发布2019 年（前身 Postwoman）
当前版本持续更新（2026 年维护活跃）
支持平台Web 浏览器、Docker 自托管、桌面 PWA
生态成熟度中高（开源 API 工具明星项目）

二、 技术定位与简介

Hoppscotch 定位为 零安装、开源、隐私优先的 API 调试工具：

  • 浏览器直接访问 https://hoppscotch.io 即可使用。
  • 数据默认存储在浏览器本地（LocalStorage/IndexedDB），不上传云端。
  • 支持 REST、GraphQL、WebSocket、SSE、Socket.IO。
  • 提供 Collections、环境变量、历史记录。
  • 支持 Docker 自托管企业内网部署。
  • Hoppscotch Desktop（PWA）提供类原生体验。

适合快速验证 API、不愿安装重型客户端、或需要自托管的团队。

三、 快速上手安装说明

1. 在线使用（零安装）

访问 https://hoppscotch.io

2. Docker 自托管

docker run -d -p 3000:3000 hoppscotch/hoppscotch

3. 本地开发构建

git clone https://github.com/hoppscotch/hoppscotch.git
cd hoppscotch
pnpm install
pnpm dev

4. 发送第一个请求

  1. 选择 REST 标签。
  2. 输入 URL，选择 GET/POST 等方法。
  3. 配置 Params、Headers、Body。
  4. 点击 Send 查看响应。

5. 环境变量

在 Environments 面板创建变量：

{
  "baseUrl": "https://api.example.com"
}

URL：&lt;<baseUrl&gt;>/users（Hoppscotch 变量语法）

四、 核心特性

1. 多协议支持

REST、GraphQL（Schema 内省）、WebSocket、SSE、Socket.IO、MQTT（扩展）。

2. Collections 管理

组织请求为 Collection，支持导入导出。

3. 环境变量

多环境切换，支持全局与 Collection 级变量。

4. 代码生成

生成 cURL、JavaScript、Python 等代码片段。

5. 团队协作（Hoppscotch Teams）

自托管或云服务下的团队工作区与共享 Collection。

6. 代理与 CORS

浏览器 CORS 限制下可通过 Hoppscotch 代理或浏览器扩展解决。

7. 导入兼容

支持 Postman Collection、OpenAPI、Insomnia 等格式导入。

8. 开源可审计

MIT 许可，可 fork 定制企业内网版本。

五、 适用场景

1. 黄金适用场景

  • 快速 API 验证，无需安装软件。
  • 开源项目文档中的 API 示例调试。
  • 隐私敏感、数据不愿上云的个人使用。
  • 企业内网自托管 API 调试平台。
  • 轻量替代 Postman 的日常调试。
  • 教学与演示环境。

2. 局限适用场景

  • 大型企业 API 治理与自动化测试（选 Postman/Apifox）。
  • 复杂 Pre-request 脚本与 CI 集成。
  • 需要强大 Mock 服务器。
  • 离线无浏览器环境。

六、 技术亮点

1. 零摩擦启动

打开网页即可用，适合临时调试。

2. 隐私默认本地

请求数据不经过 Hoppscotch 服务器（直连模式）。

3. 现代技术栈

Vue/Nuxt 构建，UI 简洁响应快。

4. 自托管友好

Docker 一键部署，满足合规要求。

5. 活跃开源社区

GitHub 高 star，持续维护。

七、 核心概念与架构

digraph Hoppscotch_Architecture {
  rankdir=LR
  node [shape=box, style="rounded,filled", fillcolor="#f0f9ff"]
  Browser [label="Browser / PWA", fillcolor="#bae6fd"]
  UI [label="Hoppscotch UI"]
  Storage [label="Local Storage\n(Collections/Env)"]
  Proxy [label="Optional Proxy\n(CORS)"]
  API [label="Target API"]
 
  Browser -> UI
  UI -> Storage
  UI -> Proxy
  UI -> API
  Proxy -> API
}

八、 技术局限与边界

  1. 浏览器 CORS 限制：跨域请求可能需代理或扩展。
  2. 脚本能力弱于 Postman：无完整 Tests/Pre-request 生态。
  3. 团队协作功能较新：不如 Postman 成熟。
  4. 无原生 Mock 平台：需配合 MSW/json-server。
  5. 本地数据风险：清除浏览器数据会丢失 Collection（需导出备份）。
  6. 企业 SSO/治理：弱于商业 API 平台。

九、 生态地图

类别集成
导入Postman、OpenAPI、Insomnia
部署Docker、Kubernetes
扩展Browser Extension（CORS）
协作Hoppscotch Teams
互补MSW、json-server、Apifox

十、 生态集成

方向说明
Postman导入 Collection 迁移。
OpenAPI导入 API 规范生成请求。
Docker企业自托管部署。
Git导出 Collection JSON 纳入版本控制。
CI不适合；CI 用 Newman/Apifox CLI。

十一、 开发与工程化

1. Collection 版本化

定期导出 Collection JSON 到 Git 仓库。

2. 团队自托管

内网 Docker 部署，统一访问入口与备份策略。

3. 与 Apifox/Postman 分工

Hoppscotch 个人快速调试，Apifox/Postman 团队规范与 CI。

4. CORS 处理

开发环境优先配置 API CORS；临时用 Hoppscotch 代理。

十二、 性能与安全

  • 轻量 Web 应用，启动快。
  • 本地存储模式数据不出本机。
  • 自托管需配置 HTTPS 与访问控制。
  • 公共电脑使用后清除本地数据。
  • 勿在共享环境保存生产密钥。

十三、 技术对比

工具优势局限适合
Hoppscotch零安装、开源、轻量CORS、脚本弱快速调试
Postman功能最全需安装、较重团队治理
Insomnia桌面、GraphQL 强需安装日常桌面调试
Apifox一体化平台绑定国内团队

十四、 最佳实践

  1. 定期导出 Collection 备份。
  2. 生产密钥使用环境变量，不硬编码。
  3. 团队规范 API 用 Apifox/Postman，个人快速验证用 Hoppscotch。
  4. 自托管部署配置 HTTPS 与认证。
  5. 跨域问题优先修 API CORS，而非长期依赖代理。
  6. 导入 Postman Collection 后检查变量语法差异。
  7. 教学场景推荐 Hoppscotch 降低环境门槛。

十五、 学习与社区资源