GitHub 8万 Star：hoppscotch
从零部署完整教程 · 新手照着做就能跑起来 · 效率工具指南 · 原创教程
摘要：hoppscotch 是 GitHub 8 万 Star 的开源 API 调试工具，Postman 的免费替代。支持 REST/WebSocket/SSE/Socket.IO/MQTT/GraphQL 协议，集合、环境变量、前后置脚本齐全。本文介绍在线版、桌面版、Docker 自托管三种部署方式，以及发请求、实时调试、GraphQL 查询等使用场景，附真实请求验证。
调 API 时 Postman 要登录、限团队、广告越来越多？hoppscotch 是 8 万 Star 的开源 API 调试工具，Postman 的免费替代。最爽的是：打开网页就能用，零安装秒开。
本文要点
- 在线版零部署，浏览器打开即用（实测 GET/POST 请求 200 OK）；
- 支持 REST / WebSocket / GraphQL / MQTT 等协议；
- 集合管理、环境变量、前后置脚本、Postman/curl 导入；
- 桌面版下载即用，或 Docker 自托管（数据本地）。
一、GitHub 项目数据
| 项目 | 数据 |
|---|---|
| Star | 80,076（8 万） |
| 主要语言 | TypeScript |
| 许可证 | MIT |
| 形态 | Web / 桌面 / 自托管 / CLI |
| 官网 | hoppscotch.io |
二、它能解决什么问题
| 你的痛点 | hoppscotch 怎么解决 |
|---|---|
| Postman 要登录、限团队、广告多 | 开源免费，打开网页即用，可自托管 |
| 临时调个 API 还要装软件 | 在线版零安装，浏览器秒开 |
| 调 WebSocket/GraphQL 要开一堆工具 | 一个工具全支持（REST/WS/SSE/MQTT/GraphQL） |
| CORS 限制、接口没走 HTTPS | 代理模式解决 CORS、访问 http:// 接口 |
三、怎么用（重点）
场景 1：发 REST 请求（最常用）
打开 https://hoppscotch.io ，选方法（GET/POST…）→ 输 URL → 点 Send，立即看到状态码和响应体。
场景 2：WebSocket 实时调试
左侧切到 WebSocket，填 ws:// 地址连接，实时收发消息（聊天、推送调试）。
场景 3：GraphQL 查询
切到 GraphQL，设端点自动取 schema，写查询语句执行，多列文档对照。
场景 4：集合 + 环境变量
把请求存进集合（无限文件夹），用环境变量存 base URL / token，一处改处处生效。
场景 5：脚本测试
Pre-request（请求前设变量/时间戳）、Post-request（请求后校验状态码/断言），用 JavaScript。
场景 6：导入 Postman / curl
从 Postman 导出或直接贴 curl 命令，秒转成请求，迁移零成本。
四、部署（三条路）
① 在线版（零部署，实测可用）：打开 https://hoppscotch.io 直接用。数据存浏览器本地，登录后可云同步。
② 桌面版（Windows 下载即用）：官方提供 Windows/macOS/Linux 桌面应用（PWA），独立窗口 + 本地数据。
③ Docker 自托管（开发者，数据完全自主）：
gitclone https://github.com/hoppscotch/hoppscotch.git&&cdhoppscotchcp.env.example .envdockercompose--profiledefault up-d# 打开 http://localhost:3000五、功能验证（真实输出）
本机实测（在线版）：GET https://echo.hoppscotch.io →Status 200 OK，JSON 完整返回（method/headers 等）；POST 测试也成功。界面完整（URL/方法/Send/Parameters/Body/Headers/Auth/脚本标签齐全）。
六、常见问题
Q1：和 Postman 比有什么区别？
免费开源、零登录可用、在线版秒开；功能覆盖 Postman 常用（集合/环境/脚本），还多 WebSocket/MQTT 等实时协议。团队协作功能（Team）是付费版，个人用免费够。
Q2：在线版数据安全吗？
数据存浏览器本地（LocalStorage），不上传；登录后云同步到官方服务器。敏感数据可自托管（Docker）完全自主。
Q3：遇到 CORS 报错怎么办？
设置里开「代理模式」，通过官方/自建代理转发，解决 CORS 和 http:// 接口访问。
Q4：Postman 的集合能迁移吗？
能。Postman 导出 json 或直接贴 curl 命令，hoppscotch 都能导入。
七、总结
hoppscotch 是 Postman 的最优开源替代：免费、零登录、在线秒开，REST/WebSocket/GraphQL 全支持，集合/环境/脚本齐全。临时调接口打开网页就用，长期用可自托管。如果你受够了 Postman 的登录和广告，强烈推荐试试。
命令速查
# 1. 在线版（零部署）打开 https://hoppscotch.io# 2. 桌面版官网下载桌面应用（Windows/macOS/Linux）# 3. Docker 自托管gitclone https://github.com/hoppscotch/hoppscotch.git&&cdhoppscotchcp.env.example .envdockercompose--profiledefault up-d# 打开 http://localhost:3000项目地址：[hoppscotch/hoppscotch] (https://github.com/hoppscotch/hoppscotch)
标签：hoppscotch、API调试、Postman替代、开源工具、GraphQL、WebSocket、效率工具
