hoppscotch 使用教程：开源 API 调试工具 Postman 免费替代 Web/桌面/Docker 部署详解

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 自托管（开发者，数据完全自主）：

bash 复制代码

git clone https://github.com/hoppscotch/hoppscotch.git && cd hoppscotch
cp .env.example .env
docker compose --profile default 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 的登录和广告，强烈推荐试试。

命令速查

bash 复制代码

# 1. 在线版（零部署）
打开 https://hoppscotch.io
# 2. 桌面版
官网下载桌面应用（Windows/macOS/Linux）
# 3. Docker 自托管
git clone https://github.com/hoppscotch/hoppscotch.git && cd hoppscotch
cp .env.example .env
docker compose --profile default up -d
# 打开 http://localhost:3000

项目地址： $hoppscotch/hoppscotch$ (https://github.com/hoppscotch/hoppscotch)

标签：hoppscotch、API调试、Postman替代、开源工具、GraphQL、WebSocket、效率工具