Hoppscotch 实战指南：免费开源 API 测试工具，发请求、管环境、团队协作一步到位

【免费下载链接】hoppscotchOpen-Source API Development Ecosystem • https://hoppscotch.io • Offline, On-Prem & Cloud • Web, Desktop & CLI • Open-Source Alternative to Postman, Insomnia项目地址: https://gitcode.com/GitHub_Trending/ho/hoppscotch

Hoppscotch 是一个免费开源（MIT 协议）的 API 测试工具，把发请求、管变量、整理集合、团队协作放在同一个界面里，常用来替代 Postman、Insomnia。它覆盖 REST、GraphQL、WebSocket、SSE、Socket.IO、MQTT 六类协议，提供 Web（可装 PWA）、桌面端、CLI 和自托管四种形态。适合需要联调接口、做接口交接，或想把 API 数据留在自己机房的前端、后端和测试同学。

先花 10 秒判断

• REST 请求：全量 HTTP 方法，支持导入 cURL，单条请求可导出 10 多种语言的代码片段
• 非 HTTP 协议：GraphQL（填 endpoint 自动拉 schema）、WebSocket、SSE、Socket.IO、MQTT 各有独立标签页
• 环境与变量：base URL、token 存进环境，请求里用{{变量名}}引用
• 集合：请求存进集合和嵌套文件夹，批量导入导出，交接给同事直接给文件
• 认证：None、Basic、Bearer Token、OAuth 2.0、OIDC（含 PKCE）五种方式

边界说明：它不是 API Mock 服务，也不是 Postman 那种本地调试全家桶。如果你的需求是大规模接口自动化流水线，它只能算起点，测试执行要靠官方 CLI（packages/hoppscotch-cli/）或 CI 自己接。

跑起来

最短路径是仓库自带的 docker-compose，一条命令拉起 PostgreSQL 加自动迁移加 all-in-one 服务：

git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch && cd hoppscotch docker compose --profile default up

浏览器访问 http://localhost:3000 即可进入界面，中间就是请求编辑区，不需要账号，打开就能发请求。

场景演练：从建环境到发出带变量的第一条请求

任务：给一个需要 Bearer Token 的接口建立可复用的请求，并验证响应。

1. 建环境。在设置里新建一个 development 环境，把base_url和api_token两个变量存进去。
2. 发请求。选 REST 标签页，URL 填{{base_url}}/v1/users，切到 Authorization 页签选 Bearer Token，token 填{{api_token}}，按 Ctrl/Cmd + Enter 发送。
3. 看响应。下方立刻出现状态码、耗时、响应头和格式化后的 JSON 响应体，可以一键复制或下载。
4. 交接给同事。每条请求都会自动进历史记录；单条请求还能导出 10 多种语言的代码片段，直接贴给对方。

顶部的标签页就是协议切换入口：🔌 WebSocket、SSE、Socket.IO、MQTT 各占一个，连接建立后消息按到达顺序展示，测 SSE 不用自己写轮询代码。

进阶玩法

预请求脚本与后置测试。发送前挂一段 JavaScript，可以生成时间戳、随机参数、写入环境变量；响应回来后再跑断言，校验状态码、解析响应字段。脚本环境是沙箱化的，碰不到浏览器对象。

变量环境。值存进环境后，请求和脚本里都用{{变量名}}引用。开发和生产各建一个环境，切换时不用逐条改请求，改一处值就够了。

团队协作与工作区。登录后可建无限团队、共享集合和环境，成员权限按角色划分（RBAC），数据多端同步。个人项目和团队项目用工作区隔离，互不干扰。

常见问题

浏览器里发请求报 CORS 错误怎么办

在 Settings 里打开 Proxy Mode 即可，官方代理可用，也可以填自己的代理地址。访问非 HTTPS 接口被浏览器拦截的问题也能顺手解决。

不登录时数据存在哪里

默认存在当前浏览器的会话存储里，不会丢，但换设备或清缓存后就取不回了。要跨端同步就登录账号，支持 GitHub、Google、Microsoft 和邮箱登录。

桌面端怎么连自建的实例

点左上角的 Hoppscotch logo 菜单，选 Add an instance，填实例地址后 Connect。docker 部署时 webapp server 在 3200 端口，本地开发、内网环境可以用同一套集合。

六种协议在界面哪里切换

界面顶部标签页按协议分组：REST、GraphQL 是独立入口，WebSocket、SSE、Socket.IO、MQTT 归在 Realtime 组。GraphQL 填好 endpoint 会自动拉取 schema，文档面板直接可用。

资源与相关链接

• README.md：完整功能列表与使用入口
• packages/hoppscotch-common/src/components/http/：REST 请求主界面源码，Request.vue、Body.vue、Response.vue 都在这个目录
• packages/hoppscotch-desktop/：桌面端实现与自托管实例连接说明
• CONTRIBUTING.md：贡献指南与本地开发说明

Hoppscotch 把发请求、管变量、换环境、交接这几件事做成了一个轻量界面，免费、可自托管、代码全公开，适合直接拉进团队的日常联调流程。

【免费下载链接】hoppscotchOpen-Source API Development Ecosystem • https://hoppscotch.io • Offline, On-Prem & Cloud • Web, Desktop & CLI • Open-Source Alternative to Postman, Insomnia项目地址: https://gitcode.com/GitHub_Trending/ho/hoppscotch