Hoppscotch - 开源 API 开发生态系统

解决什么

Hoppscotch 针对开发者在 API 调试过程中遇到的工具臃肿、数据隐私担忧和跨平台需求问题提供解决方案。传统商业工具如 Postman 近年来功能膨胀、强制登录且数据存储在云端,Insomnia 被 Kong 收购后也走向企业化路线。Hoppscotch 提供轻量级的纯 Web 体验,支持完全离线使用或私有部署,让开发者掌控自己的 API 测试数据。同时支持 REST、GraphQL、WebSocket、Server-Sent Events、Socket.IO 和 MQTT 等多种协议,覆盖现代 API 开发的全场景需求。

为何火

项目在 GitHub 获得近 8 万星,主要因为踩中了开发者对商业工具"反噬"的痛点。Postman 从轻量工具演变为重度企业产品,Insomnia 被收购后社区版维护停滞,开发者急需可控的替代方案。Hoppscotch 的 PWA 架构让它可以直接在浏览器运行无需安装,同时提供桌面版和 CLI 满足不同场景。MIT 协议允许企业自由修改和私有部署,加上活跃的社区维护(350位贡献者、2天前还在更新),使其成为当前最受关注的开源 API 客户端之一。

核心功能

支持完整的 HTTP 方法集(GET/POST/PUT/PATCH/DELETE 及自定义方法),内置代码生成器可导出 10+ 种语言的请求代码。GraphQL 功能包含 schema 自动获取和多列文档展示。实时协议方面覆盖 WebSocket、SSE、Socket.IO 和 MQTT。认证支持 Basic、Bearer、OAuth 2.0 和 OIDC PKCE。请求历史和集合管理支持云同步或本地存储,集合可导出为文件或 GitHub Gist。Pre-Request Scripts 允许执行 JavaScript 代码动态修改请求。团队功能提供基于角色的权限控制和共享集合,工作区机制支持多项目管理。内置代理模式解决 CORS 问题和访问 HTTP 端点。

安装

推荐使用 Docker Compose 部署。克隆仓库后复制 .env.example 为 .env,修改 DATABASE_URL 和 DATA_ENCRYPTION_KEY(必须 32 字符)。运行 docker compose --profile default up 启动完整服务(含 PostgreSQL)。前端访问 http://localhost:3000,后端 API 在 http://localhost:3170,管理面板在 http://localhost:3100。若已有外部数据库可用 --profile default-no-db。开发者可用 --profile just-backend 仅启动后端服务。也可访问官方托管版 hoppscotch.io 直接使用,但数据存储在其服务器。桌面版和 CLI 工具需单独下载安装包。

适合谁

个人开发者可用 PWA 版本快速调试 API 无需安装,离线可用且资源占用低。需要数据隐私的团队适合私有部署,所有请求记录和集合留在内网。前端开发者受益于 CORS 代理功能,后端开发者可用 Pre-Request Scripts 自动化测试流程。小型团队可利用免费的协作功能共享集合,大型企业可基于 MIT 协议定制开发。不适合需要复杂 API 监控和性能分析的场景,Hoppscotch 聚焦在请求构建和调试环节,缺少 Postman 的高级监控功能。

社区评价

HN 讨论(177 点赞 126 评论)显示开发者对开源 API 客户端的强烈需求。有用户从 Insomnia 开源分支 Insomnium 迁移而来,因后者已停止维护。争议点在于行业工具的频繁变动:Insomnia 创始人卖给 Kong 后又推出新项目 Yaak,引发关于竞业协议的讨论,有评论认为 Kong 当初收购是为了控制叙事并将开发者导向其企业产品。部分用户提到"行业已转向 Bruno",但 Bruno 最近取消终身版改为订阅制($6-11/月)引发不满。正面观点认为 Hoppscotch 的 PWA 架构和自托管能力是核心优势,负面声音指出 744 个未解决 issue 显示项目维护压力大。有开发者表示仍在用 HTTPie CLI 或 curl,质疑 GUI 工具过度商业化的必要性。

选型对比

对比 Postman:Hoppscotch 更轻量(PWA 架构 vs Electron 桌面应用),完全开源可私有部署,但缺少 Postman 的 API 监控、Mock Server 和自动化测试套件。Postman 团队协作功能更成熟,Hoppscotch 的团队功能仍在完善。对比 Insomnia:两者都支持 GraphQL 和多协议,但 Insomnia 社区版已停滞,Hoppscotch 维护更活跃。对比 Bruno:Bruno 主打本地优先(Git 同步集合),Hoppscotch 提供云同步和自托管两种模式。Bruno 最近商业化引争议,Hoppscotch 的 MIT 协议更宽松。技术栈上 Hoppscotch 用 Vue 生态,Bruno 基于 Electron,前者 PWA 版本更省资源。

已知坑

官方代理服务器 proxy.hoppscotch.io 在中国大陆可能需要梯子,建议参考 Proxyscotch 项目自建代理。Docker 部署时 DATA_ENCRYPTION_KEY 必须严格 32 字符否则启动失败。团队功能需要配置身份认证提供商(如 Google/GitHub OAuth),文档中配置项较多容易遗漏。744 个 open issues 表明部分边缘功能可能有 bug,生产环境使用前建议充分测试。集合导入导出与 Postman 格式不完全兼容,复杂集合迁移可能需要手动调整。WebSocket 和 MQTT 功能相对 REST API 测试较少,稳定性需验证。PWA 版本在某些浏览器(如旧版 Safari)可能功能受限,建议用 Chrome/Edge 或桌面版。