企业官网建设流程全解析

Hoppscotch 开源 API 测试工具上手指南：5分钟跑通第一个请求

【免费下载链接】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 是一款免费开源的 API 测试工具，可以理解为不用付费订阅的 Postman 替代品。你用它发 REST、GraphQL、WebSocket 请求，管理接口集合和环境变量，整套流程都能在本地跑起来。下面带你在 5 分钟内把第一个请求发出去。

它是什么：一款开源 API 测试工具

Hoppscotch 给接口开发和测试人员用，解决"发请求、存请求、换环境"这三件高频小事。它不绑定云账号，数据可以全留在本地。

几个最值钱的点：

• 一个界面里切 REST、GraphQL、WebSocket、MQTT，不用换工具
• 接口集合、环境变量、历史记录可导出导入，迁移成本低
• 有网页版、桌面版和 CLI，CI 里也能跑

5分钟跑起来：本地启动 Hoppscotch

前提：装好 Node.js 18+ 和 pnpm。然后三条命令：

git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch cd hoppscotch && pnpm install pnpm dev

pnpm dev会把前端、后端、CLI 一起拉起来，终端会打印本地访问地址，浏览器打开就是可发请求的界面。

3个最常用场景实操

场景1：发一个 REST 请求

进入任意 REST 标签，选方法、填 URL，点 Send。

你会看到状态码、耗时、大小，下方是格式化好的 JSON 响应，右上角还能一键生成各语言代码。

场景2：测一个 GraphQL 接口

左侧切到 GraphQL，填 endpoint，它会拉取 schema，再写 query 执行。

好处是右侧文档面板能按字段补全，不用手动猜字段名，返回的数据同样在下方预览。

场景3：用 CLI 在 CI 里跑集合

先把集合导出成 JSON 文件，再用 CLI 直接执行：

hopp test ./collection.json

CI 里看到通过或失败的退出码，红绿一目了然，适合做接口回归。

定制与扩展：自托管与换实例

如果团队要内网部署，用 Docker 一条命令起完整自托管环境（含数据库和自动迁移）：

docker compose --profile default up

桌面端左上角可以切实例，在云和本地自建之间切换，集合跟着走。后端代码在 packages/hoppscotch-backend/，自托管相关配置在 packages/hoppscotch-desktop/，点到为止。

避坑速查

依赖装不上？多半是缓存或网络问题，先清缓存再装：pnpm store prune && pnpm install。

端口被占用？默认端口冲突时，改 compose 里的端口映射或环境变量PORT再启动。

请求报 CORS 错误？设置里打开代理模式，走官方代理即可绕过跨域。

想离线用？用桌面版或把 PWA 装到主屏，不依赖云账号也能存本地数据。

一段收尾

如果你想要一个免费、能自托管、CI 也能跑的接口工具，又不想被云账号绑死，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