Hoppscotch 完整自托管指南：1 条命令跑通开源 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/hoppscotch
团队联调时总有人卡在"验一个接口"上：前端要复现后端返回，后端想快速打一发请求，运维最担心数据出不出内网。Hoppscotch 就是干这事的开源 API 调试工具，一个界面发 REST、GraphQL、WebSocket，还能整套自托管到你自己的机器。它和 Postman 最大的差别：可免费私有化部署，集合、环境、历史数据全程不出你的网络。
一条命令拉起自托管实例 🐳
只想用起来、不想改代码，就走这条最短路径。先 clone，再按下面"部署要点"备好.env，然后：
git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch cd hoppscotch && docker compose --profile default updefault这个 profile 会一次拉起 All-in-One 服务 + PostgreSQL + 自动迁移（见 docker-compose.yml 顶部注释）。起来后http://localhost:3000是应用本体，:3100是自托管管理面板。怎么算跑通了：登录后进 REST 标签页，输入GET https://echo.hoppscotch.io点 Send，返回 200 就成功。
本地改代码再跑
要动源码就切 pnpm 路线（package.json 锁了 pnpm 版本）：pnpm install && pnpm dev，实际执行pnpm -r do-dev，并行起各子包的 Vite 开发服务，浏览器开本地端口即可。
三个能力，对应三类干活场景
发请求 + 存请求，联调不丢步把常用接口存进 Collection，后端一改版，前端直接重放集合里那条请求验证，不用再手敲一遍。请求编辑、响应展示、脚本都在这层：packages/hoppscotch-common/。
实时协议也在一个界面调 WebSocket、SSE、MQTT、Socket.IO 推送接口不用另开工具，Realtime标签页直接连，协议页面在 packages/hoppscotch-common/src/pages/realtime/。
脚本跑在隔离沙箱里Pre-request / Post-response 脚本（比如发请求前自动算签名）跑在 isolated-vm 沙箱中，拿不到宿主环境：packages/hoppscotch-js-sandbox/。
改这三个变量再上线
自托管前务必过一遍 .env.example，复制成.env后改这三处：
DATA_ENCRYPTION_KEY：32 位，负责落库敏感数据（如 token）的加密。示例值直接上线等于把这些数据裸奔，必须换成你自己的。DATABASE_URL：指向 Postgres，示例里密码是testpass。生产不改成强密码，等于给数据库留了后门。VITE_BACKEND_GQL_URL：决定前端连哪个后端 GraphQL。你换了端口或域名时同步改它，否则前端连不上后端、整片空白。
下一步可以做什么 🔧
- 把集合接进 CI 批量跑：装
@hoppscotch/cli，hopp test ./collections把请求当测试用例跑，入口在 packages/hoppscotch-cli/。 - 看脚本隔离怎么做的：直接翻 packages/hoppscotch-js-sandbox/ 的 cage 模块，理解它如何圈住脚本。
- 桌面端切换实例：同一个客户端可连云端或你自己的自托管服务，切一下顶部实例菜单即可。
【免费下载链接】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），仅供参考
