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还在对着浏览器地址栏手动改 URL、复制粘贴请求头吗Hoppscotch 是一个开源的 API 开发工具覆盖 HTTP 请求、GraphQL、WebSocket、MQTT 等协议的调试支持 Web、桌面端和 CLI数据可完全存在本地也可以自建后端做团队同步。本指南给出本地开发、Docker 自托管、桌面端三条上手路径照着命令执行即可跑起来。它能解决什么三个真实场景接口联调切到POST在 URL 填https://jsonplaceholder.typicode.com/postsBody 标签页选JSON填入一段 JSON 点发送状态码、响应头、响应体分栏展示还能一键复制成 10 多种语言的请求代码片段。实时协议调试顶部入口切到WEBSOCKET、MQTT或GRAPHQL分别用于压测长连接、订阅消息主题、拉取 GraphQL schema 后自动补全查询不用另装工具。团队协作把工作区、集合、环境变量{{var}}引用存进同一个 Hoppscotch 环境自托管后端后多设备同步Post-request 测试脚本可以在响应后自动断言状态码。动手前清单项目要求说明Node.js22 或更高仓库devenv.nix指定 nodejs_22pnpm10.33.4根package.json通过packageManager和preinstall强制使用 pnpmnpm/yarn 会被拒绝端口3000 / 3170 / 3100前端、后端、管理后台各自占用磁盘依赖约数 GB 构建产物monorepo 含 10 个 workspace 包Rust 工具链仅桌面端源码构建需要桌面端基于 Tauri 2系统库仅 Linux 桌面端需要libwebkit2gtk-4.1Ubuntu 24.04 自带执行以下命令安装 pnpmcorepack 随 Node 自带corepack enable corepack prepare pnpm10.33.4 --activate克隆仓库git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch cd hoppscotch三条路径互不依赖选一条执行即可不必全做。路径一本地开发前端跑在 3000 端口cp .env.example .env pnpm install pnpm devcp .env.example .env必须放在pnpm install之前packages/hoppscotch-selfhost-web/的 postinstall 会执行 gql-codegen它读取.env里的VITE_*变量缺文件会报错。pnpm install会安装全部 workspace 依赖并触发代码生成耗时较长请耐心等待。预期结果浏览器访问http://localhost:3000看到请求输入区和空响应面板即成功。此模式无后端集合与历史存在浏览器 localStorage。路径二Docker 自托管前端 后端 数据库cp .env.example .env docker compose --profile default up -ddefaultprofile 一键拉起三件事应用3000 端口、NestJS 后端3170 端口含 GraphQL、PostgreSQL自动建库迁移。访问http://localhost:3000即得带账号体系的自托管版可登录、建团队、同步工作区。两个检查点.env里DATA_ENCRYPTION_KEY必须改成恰好 32 个字符后端启动会校验。端口被占用时改docker-compose.yml中ports的宿主机侧映射如3100:3000容器侧不动。生产构建走同一条路docker-compose.yml基于根目录prod.Dockerfile构建镜像。纯静态部署也可以单独构建前端pnpm -F hoppscotch/selfhost-web build产物在packages/hoppscotch-selfhost-web/dist/任意静态服务器托管即可根目录pnpm start会用 http-server 在 3000 端口预览它。路径三桌面端Tauri 2 打包离线可用桌面端源码在packages/hoppscotch-desktop/。日常使用直接装官方安装包macOS/Linux 可用brew install --cask hoppscotch。需要源码构建时cd packages/hoppscotch-desktop pnpm install pnpm dev:full # 启动 Tauri 开发窗口 pnpm build:full # 生产构建安装包dev:full等价于pnpm tauri dev会先执行prepare-web构建 web 应用并打包进bundle.zip耗时比前端 dev 长。桌面端启动后可在左上角 Logo 菜单选择「HOPPSCOTCH CLOUD」登录或「Add an instance」连接自托管实例填[your-ip]:32003200 是 webapp bundle 服务端口。装完第一件事发出第一个请求打开应用后做这两步确认链路可用URL 填https://httpbin.org/get保持GET按Enter或点发送。看到状态码 200、响应头含Content-Type: application/json、响应体是你的出口 IP 即成功。拿到一段同事给的 cURL 命令点请求栏旁的导入按钮粘贴方法、URL、Headers、Body 会自动解析填充省去手动誊写。顺手点一下左上角 Logo 菜单确认当前处于个人工作区自托管版里这里还能切换团队工作区。避坑速查现象原因处理ERR_PNPM_RECURSIVE/Only pnpm is allowed用了 npm 或 yarn 安装仓库 preinstall 强制 pnpm改用corepack enable pnpm install安装中途 gql-codegen 报读不到.envselfhost-web 的 postinstall 依赖环境文件先cp .env.example .env再装依赖后端容器起不来或登录报错DATA_ENCRYPTION_KEY不足 32 位或DATABASE_URL指向的库连不上改成 32 字符密钥核对.env中DATABASE_URL与 compose 里的库地址一致3000 端口被占本机已有服务占用vite dev 会自动换端口看终端输出Docker 部署则改ports映射Linux 桌面端白屏WaylandWebKit2GTK 合成模式与显卡驱动冲突用WEBKIT_DISABLE_COMPOSITING_MODE1启动或换 Ubuntu 24.04旧系统报GLIBC_2.38 not found桌面端 AppImage 依赖较新 GLIBC升级到 Ubuntu 24.04 级别发行版依赖下载慢默认源在海外给 pnpm 配置国内镜像源pnpm config set registry指向可用镜像下一步Hoppscotch 的价值在于免费、开源、数据可自持本地模式零成本起步自托管模式把团队数据留在自己的服务器。按你的角色走一步即可个人开发者进入 Environments 页面建第一组变量在请求 URL 里用{{base_url}}引用再学 Pre-request 脚本。自托管运维把.env里的VITE_BASE_URL、WHITELISTED_ORIGINS换成真实域名桌面端要连自托管实例WHITELISTED_ORIGINS必须加入对应app://源详见packages/hoppscotch-desktop/README.md。想加命令行测试packages/hoppscotch-cli/提供独立 CLI可把集合导出后在 CI 里跑。【免费下载链接】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），仅供参考