Hoppscotch 上手指南：5 分钟跑起自托管 API 调试工具

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/hoppscotch发接口、存集合、写前置脚本Postman 能干的它基本都能干但 Hoppscotch 是开源的 API 调试工具整套 Web 加后端能塞进你自己内网请求数据不出域。5 分钟把自托管版本跑起来代码怎么组织的、部署常踩的坑一并交代。先跑起来5 分钟想最快看到界面走 Docker 这条最短路径三条命令git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch cd hoppscotch cp .env.example .env docker compose --profile default up--profile default一次拉起 All-in-One 容器、PostgreSQL 和自动迁移。打开浏览器访问 http://localhost:3000进 REST 标签页URL 填 https://echo.hoppscotch.io 点 Send看到 Status: 200 和 JSON 响应就对了http://localhost:3100 是自托管管理面板。想改代码的话另一条路是 pnpm install 接 pnpm dev会在各子包并行起 Vite 开发服务器这里不展开。它能帮你干什么按场景不按功能模块日常大概率逃不出这几件事联调时临时改个请求头接口加了新 Header你在 Headers 标签页加一行、改一下环境变量的值点 Send 立刻看响应还能把请求导出成 cURL 或十几种语言的代码片段丢给对方复现。把 Postman 的集合整体搬过来导入 Postman 导出的 JSON目录结构、请求、鉴权配置原样进来不用手工重录环境也一起带过去。在 CI 里批量跑接口回归仓库里的 hoppscotch-cli 把集合当测试用例跑每个请求挂上检查和断言跑完出报告失败直接拦在合并前。敏感数据的团队内网自建后端、PostgreSQL、管理面板全在自家机器上团队集合和成员在内网同步桌面端还能一键在云端和你自己的实例之间切换。同类里 Postman 的数据默认过它的 SaaSInsomnia 是桌面单机Hoppscotch 是 Web、桌面、CLI 三端同一套开源代码私有化是它的主场。代码长什么样架构速览想读懂代码先知道包是怎么拆的pnpm monorepopackages/ 下每个包职责单一挑最相关的四个。hoppscotch-common所有 UI 组件、请求发送、脚本执行都在这层Web 和桌面端共用拆出来就是不写两遍界面。hoppscotch-selfhost-webWeb 端薄入口只管打包 common 和决定连哪个后端地址改 Web 行为只动这里。hoppscotch-backendNestJS Prisma PostgreSQL 的服务端GraphQL 接口管用户、团队和集合同步。hoppscotch-js-sandbox用 isolated-vm 把 Pre-request 脚本关进隔离环境执行用户代码碰不到宿主安全边界就在这。想读源码从 packages/hoppscotch-common/src/helpers/RequestRunner.ts 进看请求怎么拼装和发出再顺 helpers/backend/ 里的 GraphQL 文件看它怎么调后端。部署时别踩的坑翻车基本就这三件按出现频率排npm install 直接报 Only pnpm is allowed根目录 package.json 的preinstall钩子写了only-allow pnpmpnpm 版本也被锁死。修复先 corepack enable 切到 pnpm别拿 npm 或 yarn 硬闯。页面能打开但登录、同步全是 500.env 是从 .env.example 原样拷的DATA_ENCRYPTION_KEY还停在示例值。修复.env 里 DATA_ENCRYPTION_KEY 改成你自己的恰好 32 位字符串docker-compose.yml 里POSTGRES_PASSWORD的testpass也顺手换掉。3000、5432 端口被占容器起不来default 档默认要 3000应用、3100管理面板、3170后端、3200 和 5432PostgreSQL五个端口。修复改 docker-compose.yml 里对应的端口映射别混用 default 和其他 profile会撞端口。接下来往哪走跑起来之后往哪深入看你想走多远把 hoppscotch-cli 接进 CI让请求集合变成每次构建必跑的接口回归读 hoppscotch-js-sandbox 包看 isolated-vm 怎么把用户脚本关进隔离环境想给后端加自定义 GraphQL 接口从 packages/hoppscotch-backend/src 的 resolver 入手改完 schema 记得重跑 gql-codegen卡住了先去官方 self-host 文档和 Discord 社区搜一圈部署坑基本都有人踩过【免费下载链接】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），仅供参考