
Hoppscotch 完整上手指南3 步免费拥有 Postman 同款 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/hoppscotchHoppscotch 是一款开源免费的 API 开发生态一个界面里同时调试 REST、GraphQL、WebSocket、MQTT覆盖 Web、桌面和 CLI 三种形态还能自托管给团队用是被广泛拿来替代 Postman、Insomnia 的开源方案。亮点速览 完全开源免费不限请求量没有订阅档位 REST、GraphQL、WebSocket、MQTT 四大协议开箱即用 团队协作 角色权限 跨设备实时同步 Web / 桌面 / CLI 三种形态可纯离线自托管 支持 PWA 安装到手机现场调试不依赖电脑它适合谁、解决什么问题你如果只是想快速调一个接口装个笨重的客户端太麻烦——Hoppscotch 打开浏览器就能发请求轻量且快。如果你所在团队要共享 API 集合、统一管理多套环境它内置的集合 环境变量 团队功能正好覆盖这个场景。如果公司对数据出内网有顾虑你可以用 Docker 把它整套部署在自己的服务器上所有请求数据留在本地桌面端还能直连你的私有实例。如果你的 CI 流水线需要无人值守地跑接口测试脚本它的 CLI 可以拉集合、跑断言、出报告。最快上手方式项目强制使用 pnpm锁定了 10.33.4 版本所以第一步就是装好它然后克隆并安装依赖git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch cd hoppscotch pnpm install装好后然后呢启动开发服务器pnpm dev浏览器打开终端里提示的地址你看到的就是完整界面左侧集合树、中间请求编辑器、下方响应结果发个 GET 请求试试手感。想跑生产级自托管用仓库里预设的 Docker Compose一条命令拉起全部服务主应用 管理面板 后端 PostgreSQL 自动迁移docker compose --profile default up起来之后访问 3000 端口就是主应用3100 是管理面板3170 是后端 API。配置细节可以直接看 docker-compose.yml。核心能力拆解REST、GraphQL 与实时协议一套工具全搞定能做什么HTTP 方法、参数、Headers、BodyJSON/FormData 等全支持还能导入 cURL、生成 10 多种语言的请求代码片段。GraphQL 能拉 schema、带补全地写查询。WebSocket、SSE、Socket.IO、MQTT 在左侧边栏一键切换。怎么触发点左侧边栏切换协议类型填地址点 Send。适合什么场景日常接口调试、GraphQL 联调、IoT 设备消息收发验证。集合 环境变量 脚本把调试变成工程能做什么请求存进集合和嵌套文件夹复用环境里存变量请求和脚本里用{{变量}}引用切环境只改一处值前置脚本可以在发请求前算时间戳、生成随机串后置测试能断言状态码、解析响应体。怎么触发左上角 New 建集合右上角环境下拉框切换环境请求面板里的 Pre-request Script 和 Tests 标签页写脚本。适合什么场景开发/测试/生产三套环境来回切回归测试时批量校验响应。团队协作与自托管部署能做什么建团队、共享集合、按角色分配权限登录 GitHub/Google/邮箱后多设备实时同步自托管时桌面端可在左上角添加实例直连你自己的服务和官方云端无缝切换。怎么触发Web 端登录后进 Teams 页面桌面端见 packages/hoppscotch-desktop/源码里也内置了连接私有实例的逻辑。适合什么场景多人共用的 API 资产库、内网环境下的私有部署。CLI让测试脚本进 CI能做什么hopp test collection.json会逐个执行集合里的请求跑前置脚本和测试断言支持从env.json注入环境变量、输出 JUnit 报告、按 CSV 做数据驱动迭代。怎么触发装好 packages/hoppscotch-cli/ 后在流水线里调用hopp test配合--server指向你的自托管实例。适合什么场景每次提交自动回归核心接口测试失败直接阻断合并。常见报错排查现象install 时提示 Only pnpm is allowed to install this project原因仓库的 preinstall 钩子用了 only-allow pnpm用 npm 或 yarn 会被直接拦下。 解决先全局装 pnpm比如corepack enable再重新安装依赖别混用包管理器。现象浏览器里请求报 CORS 错误或 http:// 的接口直接失败原因浏览器的跨域策略拦截非 HTTPS 端点也经常被阻。 解决在 Settings 里开启 Proxy 模式并填上代理地址官方有配套代理服务CORS 和 IP 暴露问题会一并绕过。现象自托管起不来日志显示 3000 端口被占用原因主应用默认占 3000 端口你机器上可能已有服务在用。 解决编辑 docker-compose.yml 里对应服务的端口映射把3000:3000改成3001:3000重新 up 即可。Hoppscotch 的核心卖点就一句话免费、多协议、能自托管。三条命令跑通本地一条 Docker 命令跑通私有部署从个人调试到团队 CI 测试都能接住。别收藏了现在就把仓库克隆下来亲手发一个 GET 请求。【免费下载链接】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创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考