App Hoppscotch 轻量离线可自建的开源API调试全家桶

做后端接口联调，绕不开一个 API 客户端。Postman 功能全但越来越重，启动慢、吃内存，团队协作和高级功能还要付费；很多轻量替代品又只在浏览器里跑，离线不可用、敏感接口不敢往第三方服务器发。Hoppscotch 是这条赛道上的开源异类：一个把「轻、快、离线、可自建」做到极致的 API 开发生态系统。它的卖点很直接——PWA 形态秒开、离线可用、低内存占用，同时覆盖 REST、WebSocket、Server-Sent Events、Socket.IO、MQTT、GraphQL 全套协议，桌面端、CLI、自建部署全都开放。

项目采用 MIT 协议，TypeScript 编写，当前版本 2026.9.0，最近更新 2026 年 10 月 23 日，GitHub 星数超过 8 万，是开源 API 工具里当之无愧的头部。对受够了重型客户件的开发者，它提供了一条体面的退路。

项目基本信息

一、项目介绍

Hoppscotch 的底色是「Web 优先」。作为 PWA，它装到桌面后拥有 Service Worker 带来的即时加载和离线能力，内存和 CPU 占用远低于 Electron 类应用。功能面上，HTTP 方法覆盖 GET 到 CONNECT 还支持自定义方法；请求可生成十多种语言和框架的代码片段、导入 cURL、生成可分享的公开链接；主题、强调色、Zen 模式一应俱全，配置随云或本地会话同步。

协议支持是它区别于普通 REST 客户端的核心：WebSocket 全双工通道、SSE 流式更新、Socket.IO、MQTT 订阅发布、GraphQL 都在同一界面内完成。官方还有文档站、Discord 社区和自建部署方案，企业可以把整套服务架在内网，接口请求不出内网，安全合规压力小得多。对只需要「发个请求看个响应」的日常，它的三步操作——选方法、填 URL、发送——几乎零学习成本。

二、核心优势

第一，轻是真的轻。PWA 架构、极简 UI，启动和请求响应都是秒级，老机器也能流畅跑，对比动辄几百兆内存的 Electron 客户端体验差异明显。

第二，离线与隐私。请求在本地发起，可完全离线使用；配合自建部署，接口地址、请求头、Token 全程不出自己的基础设施。

第三，协议全家桶。REST 之外把 WebSocket、SSE、Socket.IO、MQTT、GraphQL 都收进一个界面，调试实时类接口不用再装专门工具。

第四，形态灵活。网页版即开即用，PWA 可装桌面，还有 CLI 和自建方案，从临时调试到团队标准化全覆盖。

第五，MIT 协议加成熟的社区生态。文档、示例、多语言支持齐全，二次开发和定制没有法律障碍。

第六，分享与协作轻量。任何请求都能生成公开分享链接，对方打开即可复现你的调用；配合环境变量和历史记录，联调沟通从「截图加文字描述」变成「一个链接」。对分布式团队，这一个功能就省下大量低效往返。

三、适用场景

后端日常联调：快速发请求、看响应、生成代码片段，替代笨重的商业客户端。隐私敏感项目：金融、政企的内网接口调试，自建部署让数据不出境。前端开发：Mock 接口联调、调试 SSE 和 WebSocket 推送。物联网与消息队列开发：MQTT 订阅发布调试开箱即用。教学与分享：公共分享链接直接把请求发给同事，对方打开即用。离线场景：飞机上、内网环境继续干活。

四、安装教程

最轻的方式：浏览器打开 hoppscotch.io 直接用，点「安装到桌面」即可获得 PWA 版，离线可用。想自建，克隆仓库按官方文档部署：

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

生产构建与启动参考仓库内的部署文档，官方同时提供 Docker 等部署途径。CLI 版本可通过官方发布渠道安装，适合写进脚本做接口巡检。

常见报错：其一，PWA 离线打开白屏——首次使用需联网加载一次，让 Service Worker 完成缓存。其二，自建部署后 WebSocket 或 SSE 连不上——反向代理需显式放行 Upgrade 连接，检查 Nginx 的 WebSocket 配置。其三，跨域请求被浏览器拦截——网页版受同源策略约束，自建版确认服务端 CORS 配置或改用代理模式。

五、使用示例

调试一个带鉴权的 REST 接口：选 POST，填入 https://api.example.com/v1/orders，在 Headers 页加 Authorization: Bearer <token>，Body 选 JSON 写入请求体，点发送。右侧实时返回状态码、响应头和响应体，响应可直接切换 Raw 或 Preview 视图。请求配置完成后，点代码生成，选 JavaScript Fetch，得到一段可直接粘进项目的代码。

调试实时接口同样顺手：新建 WebSocket 连接填入 wss://example.com/socket，连接后在消息面板发送订阅指令，服务端推送的每一帧都带时间戳列出；调试 SSE 接口则新建 EventStream 类型的请求，推送事件逐条展示。整套流程不用切换工具，一个标签页搞定。

六、常见问题

问：和 Postman 怎么选？答：要轻量、离线、隐私、开源选 Hoppscotch；要企业级协作、复杂测试脚本、官方生态集成选 Postman，两者可并存。

问：数据存在哪？答：默认存本地或云端会话同步，自建版完全在你自己的服务器；敏感项目的请求头和 Token 建议用自建方案。

问：支持 GraphQL 吗？答：支持，界面内可切换，带查询编辑器和变量面板。

问：团队共享接口集合怎么做？答：用公开分享链接快速共享单个请求；团队级 workspace 与历史同步是官方云服务的能力，自建版可按文档接入。

七、总结

Hoppscotch 用 PWA 架构证明了一件事：API 工具不必是几百兆的桌面巨兽。轻、快、离线、可自建，加上 REST、WebSocket、SSE、Socket.IO、MQTT、GraphQL 的全协议覆盖和 MIT 协议，让它成为从个人联调到企业内网部署的通用选择。如果你每天要发几十个请求、又厌烦了客户端的臃肿，或者所在团队对接口数据出境敏感，它是目前最值得切换的开源方案。需要注意的是，自建部署时把 WebSocket 和 SSE 的代理配置一次到位，能省掉后续不少排查时间。