Hoppscotch 上手指南从克隆到跑通一篇讲透【免费下载链接】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 调试工具做 HTTP 客户端这件事常被当成替代 Postman 的开源方案。读完这篇你能分清它的 monorepo 结构、在本地或 Docker 里跑起来并知道配置该往哪改。1. 项目长什么样目录结构路径作用一句话备注packages/pnpm monorepo 的全部子包代码核心全在这见下几行packages/hoppscotch-common/核心前端Vue 3 写的请求界面、集合、环境变量、代理逻辑全在这packages/hoppscotch-selfhost-web/自托管 Web 前端复用 common 包的页面是部署出去的 Web 应用壳packages/hoppscotch-backend/GraphQL 后端NestJS Prisma Postgres管认证、团队、集合同步packages/hoppscotch-cli/命令行工具跑测试用例、导报告hoppscotch-desktop等其余包桌面端、JS 沙箱、数据层Tauri 壳和独立能力按需再看根目录零散文件工作区与部署配置pnpm-workspace.yaml、docker-compose.yml、.env.example、Caddyfile真正干活的东西在 packages/hoppscotch-common/src/REST 请求、GraphQL、WebSocket 的界面和逻辑都堆在那里。入口不用在根目录找每个包自己的package.jsonscripts 才是它的启动方式。2. 怎么把它跑起来启动方式本地开发要求 pnpm仓库锁定了 pnpm10.33.4克隆仓库git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch根目录执行pnpm install装依赖装完会自动生成 GraphQL 类型文件执行pnpm dev实际是pnpm -r do-dev把声明了开发脚本的子包并行拉起来看到 Vite 起服务、浏览器访问 3000 端口出现界面Docker 部署把.env.example复制为.env改掉DATABASE_URL和 32 位DATA_ENCRYPTION_KEY执行docker compose --profile default up起 all-in-one 容器 Postgres 自动跑 Prisma 迁移浏览器访问http://localhost:3000看到完整自托管版界面如果启动报错优先检查 Node 版本和依赖安装是否完整。3. ⚙️ 配置在哪、改什么你大概率要动的就是根目录的.env样例在.env.exampleDATABASE_URL控制后端连哪个 PostgresDATA_ENCRYPTION_KEY32 位用于库里敏感数据的加密WHITELISTED_ORIGINS控制哪些源能和后端跨域通信本地开发必须带上 3170、3000 等端口VITE_BACKEND_GQL_URL、VITE_BACKEND_API_URL等控制前端连后端的地址部署在别处域名下就要改它们构建脚本在根目录package.jsonpnpm dev起本地开发pnpm -r do-build-prod生成各包的生产产物pnpm test跑全仓测试pnpm lint检查代码风格。Docker 部署时 all-in-one 容器开放 3000应用、3100管理台、3170后端、3200bundle 服务几个端口反代和 TLS 规则在aio-multiport-setup.Caddyfile这类 Caddyfile 里改。4. 接下来干什么后续方向想深入从 packages/hoppscotch-common/src/ 的services/和helpers/入手最实际REST、GraphQL 的执行逻辑都在里面比从页面组件倒推快得多。想二次开发改完对应包后跑pnpm test和pnpm lintcommon 和 backend 各自带 jest/vitest 用例提交前先过这两关。想部署--profile default的 all-in-one 最省事用外网域名时改好.env里的VITE_*地址和WHITELISTED_ORIGINSCaddyfile 决定怎么反代。【免费下载链接】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），仅供参考