调接口还在装 Postman？Hoppscotch 这个开源替代品支持 WebSocket 还能自托管

调试接口这件事，很多人默认用 Postman。但最近几年 Postman 越来越重：强制登录、数据默认同步云端、团队功能要付费、客户端启动还慢。对只想"发个请求看看返回什么"的需求来说，这些负担有点没必要。

Hoppscotch 是这个问题最主流的开源答案。它在 GitHub 上有 8 万 star，MIT 协议，商用没问题。官方定位是"开源 API 开发生态系统"。

它到底是什么

Hoppscotch 是一个 API 请求调试工具，最开始是 Postman 的轻量化替代品，功能上已经覆盖得相当完整：

• HTTP 请求的完整支持（各种方法、Header、Body、认证方式）
• WebSocket、SSE、Socket.IO、MQTT 的实时通信调试
• 环境变量与多环境切换
• 集合（Collection）管理与分享
• 请求历史

最后那条实时通信支持，是它明显强于 Postman 的地方。调试 WebSocket 或 SSE 接口时，你不用再另外找工具。

使用方式上它有个很讨巧的设计：直接用网页版。打开 hoppscotch.io 就能用，数据存本地浏览器。如果你想自托管，它也提供了完整的 Docker 部署方案，把整套东西装在自己内网。

三种用法，按你的需要选

网页版（最省事）。 打开就用，零安装。数据默认存浏览器本地，不会上传到它的服务器。对绝大多数个人使用场景，这一档就够了。

桌面客户端。 官方提供了桌面版，适合需要离线使用、或者要访问 localhost 的场景（浏览器的跨域限制会让网页版调本地服务有点麻烦）。

自托管（数据敏感场景）。 Docker 一条命令起一个实例，公司内部用。API 地址、请求参数、甚至 Authorization 头里的令牌全留在内网。对金融、医疗这类有合规要求的团队，这是唯一能接受的用法。

自托管怎么做

官方给了 Docker Compose 方案，几分钟能起来。要注意的几点：

• 需要配一个 Postgres 数据库做持久化
• 默认没有鉴权，放公网前必须配好反向代理和登录限制
• 如果要多人协作，需要配置 OAuth 或邮箱登录

自托管最大的价值是：内部接口的调试请求、示例、文档可以沉淀在公司自己的实例里，变成团队共享的资产，而不是散落在每个人的 Postman 本地。

和 Postman、Bruno 怎么选

这三个是同一赛道的常见选项，判断标准：

Hoppscotch——功能最全、实时协议支持最好、有网页版和自托管两条路。适合既要轻快、又偶尔需要调试 WebSocket/SSE 的人。

Postman——生态最成熟、团队协作和企业功能最完善。如果你的公司已经深度依赖它的协作流程，替换成本可能不值得。

Bruno——最极端的"纯文本"路线，请求以文件形式存在你自己的项目里，完全离线、天然进 Git。适合把 API 请求当代码管理的开发者。

如果你只是想要一个"轻、快、能调试实时接口、能自托管"的工具，Hoppscotch 是这三者里平衡得最好的。

上手要留意的地方

自托管别忘了鉴权。 官方的默认部署开放度很高，直接暴露在公网会有风险。至少加一层反向代理的 basic auth，或者配好官方的登录体系。

环境变量别存敏感信息明文。 如果你的 collection 会分享出去，Token 这类东西走环境变量，别写死在请求里。分享的时候只分享结构，不分享密钥。

历史记录是本地的。 网页版的数据在浏览器里，换浏览器或者清缓存就没了。重要请求记得存成 collection 并导出备份。

提升效率的四个用法

善用环境变量。 把 baseUrl、token 抽成环境变量，切换开发/测试/生产环境只点一下。比每次手动改 URL 快得多，也不容易把测试请求发到生产去。

请求前后脚本做自动化。 登录后拿到的 token 可以自动存进环境变量，后续请求自动带上。这种"登录一次、后面全自动"的配置，能省掉大量手动复制 token 的时间。

导出分享用链接而非截图。 需要把某个请求发给同事时，用分享功能生成链接（或用自托管实例），对方能直接导入跑。截图里的信息是死的，链接里的请求是活的。

善用快捷键。 Hoppscotch 的快捷键体系很完整，用熟了之后调接口的速度不比命令行慢。它有个命令面板，值得一试。

自托管的现实考量

自托管 Hoppscotch 的组件比想象的稍多一点：主应用、数据库，如果要完整功能还需要配邮件服务（用于登录）和 OAuth 应用。

对只需要"内部团队用"的场景，其实可以跑精简配置：不要注册功能，用管理员手动开账号。这样部署复杂度直线下降，也不暴露公网注册入口。

数据备份的核心是数据库，定时备份即可。请求历史存在数据库里，丢了影响不大，但如果团队把它当接口文档用，那备份就值得认真做。

一个容易被忽略的能力：分享

调试出一个能复现 bug 的请求之后，你怎么把它给同事？截图？贴 curl？还是口头描述？

Hoppscotch 可以生成一个分享链接，对方打开就是完整还原的请求——方法、Header、Body、参数全在。对方点一下就能自己跑一遍，确认问题。

这个能力在跨团队协作时特别有用：后端给前端一个能直接跑的请求示例，或者你给第三方技术支持发一个能复现问题的请求。比起"你在 Body 里加个 X-Header 试试"这种文字描述，一个能直接跑的链接效率高出一个量级。

注意：分享链接会把请求内容（包括 Header 里的 token）发出去。分享前记得清掉敏感信息，或者用自托管实例控制分享范围。

我的判断

Hoppscotch 最值得称道的一点，是它没有在"轻"和"强"之间二选一——网页版足够轻，自托管足够强，实时协议支持还是加分项。

对每天要调接口、又受够了重量级客户端的开发者，它值得一试。哪怕你最后还是回到 Postman，花十分钟体验一下"打开网页就能发请求"这件事，也会让你重新认识工具该有多快。

官方仓库在 github.com/hoppscotch/hoppscotch。