
Hoppscotch 5分钟从零跑通免费开源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 测试工具定位和 Postman、Insomnia 类似你在浏览器里填好 URL、选个方法、点发送就能看到请求的响应。除了 HTTP它还能直接测 GraphQL、WebSocket、MQTT 这些协议并且可以完全离线本地部署。适合不想把接口数据放到别人云端的开发者和测试人员装完当天就能拿它调试真实接口。环境速查Node.js最低 18推荐 22CLI 组件要求 22 以上包管理器必须用 pnpm项目锁定了 pnpm 10.x根目录 package.json 里有 preinstall 拦截用 npm/yarn 装会被直接拒绝Git任意现代版本内存4GB 起步磁盘留 1GB操作系统Windows 10/11、macOS 10.15、主流 Linux 发行版都行不满足会怎样Node 版本不够会在装 isolated-vm 这类原生依赖时报错pnpm 缺失会卡在第一道 preinstall 就退出都不会进入真正编译阶段好查。从零到跑起来先把仓库拉到本地这条命令只负责下载代码不装任何东西git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch cd hoppscotch成功标志是目录下出现packages和pnpm-workspace.yaml。自托管部署需要一份环境变量配置仓库里已经放好了模板直接复制成正式文件再按需改cp .env.example .env不跑这步的话后面启动时部分功能比如后端连接会读不到配置。接下来安装依赖。这一步会同时编译若干原生模块第一次跑通常要几分钟别当它挂了pnpm install终端滚完输出、最后一行没有红色报错就是成功了中途出现某个包的 build 失败基本是 Node 版本不对回头查环境速查那条。最后起开发服务pnpm dev这条命令会启动 Vite 开发服务器。判断标准看终端出现Local: http://localhost:3000这类字样后浏览器访问该地址能看到请求输入框和 URL 栏的页面就算跑通了。选一种方式跑你打算怎么用决定走哪条路。只在本地调试接口继续用上面的pnpm dev热重载开着改代码立刻生效最省心。要部署到服务器上给团队用直接走 Docker仓库根目录的 docker-compose.yml 把应用、后端、Postgres 都编排好了一条命令起来docker compose --profile default up -d容器全部变成 running 后访问 http://localhost:3000 验证。想要桌面应用项目用 Tauri 打包在桌面端目录里跑pnpm tauri dev即可前提是本机装好了 Rust 工具链构建会明显比 Web 端慢。装完先做这三件事先发一个真实请求在 URL 栏填一个能访问的地址比如 https://jsonplaceholder.typicode.com/posts/1方法选 GET点发送右侧能看到状态码和响应体说明请求链路是通的。建一个集合侧边栏新建 collection 和文件夹把刚发的那个请求存进去之后调试同类接口直接从这里复用不用重新敲 URL。导入一份环境把不同环境的 base URL、token 存进 Environment 变量里请求里用变量引用切换测试/生产环境只改一处。踩坑备忘3000 端口被占用终端报 EADDRINUSE看 Vite 输出的实际端口号或者临时 kill 掉占用进程再启动。pnpm install 反复失败、日志里大量网络超时删掉 node_modules 和 pnpm-lock.yaml 后重装网络差就切国内镜像源再试。页面能打开但登录、同步等功能报错九成是 .env 没配或 VITE_BASE_URL 指错了地址对照 .env.example 逐项检查后再重启。再往深了走想改后端逻辑团队、权限、mock server看 packages/hoppscotch-backend/src/ 这个 NestJS 工程。想搞懂请求是怎么发出去、变量怎么解析的看 packages/hoppscotch-common/src/helpers/rest/。完整的自托管配置域名、TLS、多端口参考仓库根目录的 docker-compose.yml 和 .env.example 里的注释。装好后下一步打开设置页把默认代理地址改成你自己的然后拿一个真实项目接口试一遍完整流程。【免费下载链接】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),仅供参考