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 开发生态用来构建、测试和管理 REST、GraphQL、WebSocket 等请求。适合后端开发者和需要私有化部署的团队。本文讲如何用 Docker 把它跑起来、代码怎么组织、配置改哪里。定位Hoppscotch 和同类工具有什么区别它是 Postman 和 Insomnia 的开源替代支持 Web、桌面、CLI 三种形态可完全离线运行。和同类工具的差别在于整套系统含后端、数据库、管理面板都能部署在你自己的服务器上。多端如果你是开发想在浏览器发请求、在桌面端同步数据、在 CLI 里批量执行一套集合三端通用。私有如果你有数据不出内网的要求请求集合、环境、历史记录都存在自己的服务器上。脚本如果你是测试工程师可以在隔离沙箱里写 Pre-request 和 Post-response 脚本。最小部署命令一条 Docker 命令启动 Hoppscotch主推路径是 Docker 自托管。docker-compose.yml 里的defaultprofile 一次拉起 All-in-One 服务、PostgreSQL 数据库和自动迁移。三条命令git clone把代码克隆到本地目录cd hoppscotch cp .env.example .env进入目录把配置模板复制成正式配置文件docker compose --profile default up启动应用、后端、数据库和管理面板git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch cd hoppscotch cp .env.example .env docker compose --profile default up备选路径是本地开发在仓库根目录执行pnpm install和pnpm dev各子包并行启动 Vite 开发服务器用于读改代码。桌面端也可以在左上角切换实例连接到你的自托管服务。如何确认成功访问http://localhost:3000应看到请求编辑页在 REST 标签页输入GET https://echo.hoppscotch.io点 Send响应区出现Status: 200即部署正常。管理面板在http://localhost:3100。项目地图按入口、核心、服务、数据四层读源码入口packages/hoppscotch-selfhost-web 是 Web 端 Vite 入口负责打包 common 包并对接后端地址。核心逻辑packages/hoppscotch-common 放所有 UI 组件、请求发送逻辑和脚本执行Web 与桌面共用。服务packages/hoppscotch-backend 是 NestJS Prisma PostgreSQL 写的后端提供 GraphQL 接口管用户、团队和集合同步。数据packages/hoppscotch-data 定义请求、集合、环境等数据模型packages/hoppscotch-js-sandbox 在隔离沙箱里执行前后置脚本。读源码的建议路线从 selfhost-web 入口进 common 的请求发送逻辑再顺helpers/backend/里的 GraphQL 文件看它怎么调后端。部署前必改配置.env 与 Docker Compose.env.example复制为.envDATA_ENCRYPTION_KEY是敏感数据落库的 32 位加密密钥示例值必须改DATABASE_URL指向 PostgreSQLVITE_BACKEND_GQL_URL等一组变量决定前端连哪个后端。每次部署、换端口都要改它。docker-compose.yml用 profile 控制启动范围default全起已有外部数据库用default-no-dbbackend/app/admin可单独起3000 / 3100 / 3170 的端口映射也改在这里。gql-codegen.ymlGraphQL 代码生成配置装依赖时自动生成类型手动改过后端 schema 遇到类型报错先重跑生成。跑起来之后的下一步导入一个现有 Postman 集合熟悉集合、文件夹和环境变量。修改.env里的DATA_ENCRYPTION_KEY和数据库密码别用示例值。执行pnpm dev起本地开发环境重点读 hoppscotch-common。用 packages/hoppscotch-cli 把请求集合当测试用例批量跑接进 CI。读 hoppscotch-js-sandbox 的源码弄清脚本隔离是怎么实现的这是进阶方向。目录结构、端口与配置项以仓库最新版本为准。【免费下载链接】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），仅供参考