完整指南几分钟内从源码跑通 Hoppscotch 开源 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 的免费替代发 HTTP 请求、调 WebSocket、写 GraphQL 查询、管环境变量Web、桌面、CLI 三种形态都有。这篇文章不讲功能清单只回答一件事——怎么把它在你自己的机器上跑起来三条命令起 Web 版、一条命令出生产构建、桌面版和 CI 集成各走哪条路。先选路线再动手同一个仓库里有好几个子项目先想清楚你要哪种形态能省掉一半时间Web 版最常用浏览器里调试 API日常开发首选路径在packages/hoppscotch-common和packages/hoppscotch-selfhost-web自托管生产版给团队建一个私有实例带登录和同步涉及packages/hoppscotch-backend桌面版基于 Tauri 的原生应用在packages/hoppscotch-desktopCI 集成用packages/hoppscotch-cli提供的hopp test命令跑自动化测试环境自检先确认三样东西跑之前检查环境避免装到一半报错pnpm仓库强制只用 pnpm根package.json里有preinstall钩子用 npm 或 yarn 安装会直接报错项目锁定的版本是 pnpm 10Node.js 22CLI 子项目明确要求 Node 22建议直接上 22约 1GB 磁盘 4GB 内存monorepo 依赖较多安装和首次启动都偏吃资源桌面版额外需要 Rust 工具链Linux 用户还建议 Ubuntu 22.04 以上依赖 libwebkit2gtk-4.1官方推荐 24.04。三步跑起 Web 版git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch cd hoppscotch pnpm install安装过程会触发工作区里每个子包的后置脚本比如 GraphQL 代码生成耗时会比一般项目长属正常现象。装完启动开发服务器pnpm dev这一条命令会通过pnpm -r do-dev同时拉起前端hoppscotch-common和自托管 Web 端hoppscotch-selfhost-web的 Vite 服务带热重载。等终端输出ready后打开它打印的本地地址即可具体端口以终端为准Vite 默认一般落在 5173 一带。发第一个请求顶部选 HTTP 方法 → URL 栏填接口地址 → 点 Send响应、头部、状态码都会显示在下方面板里。后续把常用请求存进 Collections用 Environments 管理不同环境的变量即可。打成生产版并自托管开发验证没问题后构建静态产物pnpm generate再在根目录用pnpm start起一个静态服务基于 http-server默认 3000 端口做快速预览。要真正给团队用推荐走 Docker仓库根目录有docker-compose.yml一键拉起前端、后端packages/hoppscotch-backendNestJS Prisma PostgreSQL整套服务。一个容易踩的点桌面版要连接自托管实例时需要在.env的WHITELISTED_ORIGINS里加上app://形式的前端来源细节见packages/hoppscotch-desktop/README.md。桌面版Tauri 构建原生应用桌面版是跨平台的 Tauri 应用除了 Rust 工具链外无特殊依赖。启动开发模式cd packages/hoppscotch-desktop pnpm tauri dev正式版打包用pnpm tauri build即build:full脚本。它可以直接连官方云也可以通过添加实例连你自己的自托管地址。最低系统要求Windows 10 1803 / Windows 11 x64、macOS 10.15Intel 或 Apple Silicon、Linux x64 且 GLIBC 2.38。把测试搬进 CIhopp test不想只靠人点CLI 子包hoppscotch/cli入口命令hopp能把你在界面里写好的测试脚本直接跑在流水线里npm install -g hoppscotch/cli hopp test collection.json -e env.jsoncollection.json是从 Hoppscotch 导出的集合文件env.json提供环境变量。常用选项还有--server指向自托管实例、--reporter-junit输出 JUnit 报告方便接 CI 看板、--delay请求间隔。踩坑速查npm/yarn 装不上报错来自only-allow pnpm换 pnpm 重来依赖装坏删掉node_modules后重新pnpm install锁文件pnpm-lock.yaml别删它是可复现构建的保证端口被占开发服务器被别的进程占着时终端会换端口或报错按终端输出的实际地址访问Linux 桌面版白屏/渲染异常Wayland 下 WebKit 与显卡驱动的已知问题用WEBKIT_DISABLE_COMPOSITING_MODE1前缀启动可绕过老系统报 GLIBC_2.32 not found桌面版 AppImage 要求 GLIBC 2.38升级系统或换新版发行版往哪走跑通之后代码都摆在仓库里界面逻辑看packages/hoppscotch-common/src/components后端 GraphQL 接口在packages/hoppscotch-backend/srcCLI 的测试执行逻辑在packages/hoppscotch-cli/src/utils。想改主题、加功能或 fork 一份私有部署从这几个目录入手最快。【免费下载链接】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），仅供参考
