Hoppscotch 本地部署教程：免费开源 API 测试平台从零跑通

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/hoppscotch需要一款不花钱、数据可自管的 API 调试工具Hoppscotch 是开源的 API 开发平台覆盖 REST、GraphQL、WebSocket、MQTT 等协议支持 Web、桌面端与 CLI 多种形态。这篇 Hoppscotch 本地部署教程帮你把开发环境跑起来并验证结果。动手前先备齐什么工具版本要求说明Node.js22子包 engines 字段声明了 node 22pnpm10.x根 package.json 指定 packageManager 为 pnpm10.33.4Git较新版本拉取代码Docker可选自托管生产部署用注意项目根目录有 preinstall 钩子强制使用 pnpm用 npm 或 yarn 安装会被直接拒绝。桌面端构建还涉及 Rust/Tauri 环境具体依赖以官方文档为准。最短路径跑起来把代码取到本地monorepo 的依赖安装必须从根目录发起git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch cd hoppscotch前端启动时需要从 .env 读取后端地址并执行 GraphQL codegen先把模板配置复制出来cp .env.example .env预期无输出根目录多出 .env 文件里面含数据库地址、端口、前端基础 URL 等默认值。装好依赖一条命令覆盖所有子包pnpm install预期是安装顺利完成web 子包的 postinstall 会自动跑 GraphQL 代码生成。启动开发服务器pnpm dev根脚本会并行拉起各前端包的 Vite。预期终端提示 Vite ready端口 3000。确认它真的跑通了浏览器打开 http://localhost:3000看到主界面就算通了顶部是请求方法与 URL 输入框中部是 Parameters、Body、Headers、Authorization、Pre-request Script、Tests 等页签底部是响应区。在地址栏填一个公开测试接口选择 GET 并点 Send下方应出现 200 状态码与 JSON 响应体。不接后端时应用走本地模式请求记录与集合存在浏览器本地左侧标签还能切到 GraphQL、WebSocket、MQTT、Socket.IO、SSE 等协议页——它不只做 HTTP 请求测试。挑一种用法Web 形态主路径上面的pnpm dev就是 Web 开发形态本地数据足够日常调试。需要账号体系、团队协作时用下面的 Docker 方式把后端一并拉起来。自托管生产部署 仓库自带 compose 编排default 画像一次启动 all-in-one 服务、PostgreSQL 与自动迁移docker compose --profile default up预期应用跑在 3000管理后台 3100后端 3170数据库 5432。上线前记得改 .env 里的数据库密码与 DATA_ENCRYPTION_KEY默认值是占位示例。桌面端源码在packages/hoppscotch-desktop/依赖装好后执行pnpm tauri dev进入开发模式pnpm tauri build产出安装包。桌面端左上角菜单可添加自托管实例直接连上刚部署的后端。CLI 与其余形态仓库还包含 hoppscotch-cli可在命令行批量执行集合请求要求 Node 22另有浏览器扩展用于缓解 CORS。用不到可跳过。踩坑指南npm install 报 only-allow pnpmpreinstall 钩子强制 pnpm改用pnpm install即可。3000 端口被占用Vite 会自动换可用端口以终端实际打印的地址为准。启动即提示缺环境变量检查根目录 .env 是否已从 .env.example 复制生成。prisma、argon2 等原生依赖安装失败配置国内 npm 镜像并确保能访问 Prisma 引擎下载地址。桌面端编译报错多为 Rust/Tauri 构建环境不完整按官方桌面端文档补齐依赖。再往前一点界面 Settings 里可切换主题、强调色与语言开启 Proxy 模式能缓解跨域问题。根目录提供了aio-multiport-setup.Caddyfile与aio-subpath-access.Caddyfile两份 Caddy 反代配置做多端口或子路径部署可直接参考。前端入口在packages/hoppscotch-selfhost-web/后端逻辑在packages/hoppscotch-backend/改代码前先看这两个目录的结构。到这里Hoppscotch 已在本地跑通开发用pnpm dev生产用docker compose --profile default up。团队权限、云同步等进阶能力建议接着读仓库内 CONTRIBUTING 与官方文档继续了解。【免费下载链接】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），仅供参考