3 步跑起 Hoppscotch：本地部署 API 测试工具的指南

3 步跑起 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 测试工具主界面只有方法、URL、请求体三个输入区支持 HTTP、WebSocket、GraphQL、MQTT发请求不需要账号。下面 3 步从源码跑起它。三步把界面跑起来先把源码拉到本地git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch cd hoppscotch项目根部有个 preinstall 校验只接受 pnpm。没有 pnpm 就先装再装依赖npm i -g pnpm pnpm install最后启动开发服务pnpm dev等终端打印出 localhost:3000 的地址用浏览器打开。看到方法、URL、请求体的编辑界面说明这个 API 测试工具已经跑起来了。刚才那三步在做什么仓库是 pnpm workspace 单体仓库pnpm install一次把 packages/ 下的子包依赖全装完其中 hoppscotch-common 是 Web 应用主体hoppscotch-selfhost-web 是实际拉起服务的入口3000 端口就定义在它的 vite 配置里端口被占时 vite 会自动挪到 3001 并打印新地址。安装阶段还干了两件隐藏的事preinstall 里的 only-allow pnpm 强制包管理器postinstall 跑 graphql-codegen 生成 GraphQL 类型所以依赖必须装完再执行pnpm dev。环境上构建工具是 Vite 7要求 Node 20.19 或 22.12 以上node -v可查磁盘留 1GB 空闲就够。第一分钟发出第一个请求在 URL 输入框填入https://jsonplaceholder.typicode.com/todos/1方法保持默认的 GET回车。下方响应区出现状态码 200 和 JSON 正文就是成功的第一次请求。接下来把这套工具摸一遍把方法换成 POST在请求体标签页写一段 JSON 再发送会收到 201把这两个请求存进左侧集合它们就会按集合归档在环境面板里定义一个 baseURL 变量URL 里写{{baseURL}}/todos/1发送时自动替换测试和生产的不同地址就不用来回改URL 左侧的协议切换可以切到 GraphQL 或 WebSocket选 WebSocket 连一个 ws 地址会出现实时收发消息的面板以上数据默认写进浏览器本地存储历史请求在 History 标签页随时能翻出来。卡住时对照这张表现象原因一条命令解决npm install 被直接拒绝提示 only-allow pnpm根部 preinstall 只允许用 pnpm 安装npm i -g pnpm3000 端口被占用浏览器打不开页面别的进程占了 3000vite 自动挪到 3001lsof -i:3000找占用进程或直接开终端打印的地址依赖安装长时间卡住或包 404npm registry 访问不稳定pnpm config set registry https://registry.npmmirror.com构建桌面端时报 cargo 相关错误桌面端依赖 Rust 工具链默认没装rustc --version检查缺则按官方方式装 rustup再往深走一点值得尝试的两个方向。一是桌面客户端packages/hoppscotch-desktop/ 是基于 Tauri 2 的 API 测试工具桌面版能连接自托管实例本地启动需要 Rust 工具链。cd packages/hoppscotch-desktop pnpm dev:full二是构建与托管pnpm generate编译全部静态产物pnpm start用 http-server 把 selfhost-web 的构建产物挂在 3000 端口。想让内网其他人也能访问看根目录的 docker-compose.yml 和 Caddyfile那是完整的自托管部署方式。本地这份 API 测试工具既然已经能发请求下一步可以把自己的真实接口地址填进去跑一遍要部署给团队用直接从 docker-compose.yml 入手。【免费下载链接】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），仅供参考