Hoppscotch 快速上手：3 条命令跑起免费 API 测试平台

Hoppscotch 快速上手：3 条命令跑起免费 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

Hoppscotch 是一个免费开源的 API 开发平台，能发 HTTP、WebSocket、GraphQL 请求，支持本地、自托管与桌面端使用。适合想找一个可自部署的 Postman 替代品的你。

最短路径：本地跑起并验证

这一节只解决一件事：从空目录到看到请求返回结果。全程只需三条命令，前提是装好 Node.js（建议 18+）和 pnpm。

先克隆仓库并安装依赖：

git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch cd hoppscotch pnpm install

然后启动开发服务器，它会同时拉起前端与依赖模块：

pnpm dev

打开浏览器访问http://localhost:3000，看到主界面即启动成功。新建一个 HTTP 请求，输入https://httpbin.org/get并发送，收到200和 JSON 响应体，说明平台完全可用。

给团队或内网用：Docker 自托管

适用于需要多人共用、数据不出内网的场景。仓库自带 docker-compose 预设，一条命令即可拉起应用、后端与 PostgreSQL，并自动执行数据库迁移：

docker compose --profile default up

启动后访问http://localhost:3000是使用端，http://localhost:3100是管理后台（用于创建管理员账号），后端 API 在 3170 端口。首次构建镜像需要几分钟，之后重启即秒级。

装桌面版：离线或断网环境

适用于内网隔离、不能访问在线版的需求。桌面端基于 Tauri，需要本机有 Rust 工具链：

cd packages/hoppscotch-desktop pnpm install pnpm tauri dev

窗口弹出后即可离线使用，功能与 Web 版一致。

踩坑速查

• npm install被拒绝：项目 preinstall 强制只允许 pnpm，统一用pnpm install。
• pnpm 版本过低报错：执行corepack enable让 Node 按仓库锁定的 pnpm 版本运行。
• 依赖下载慢：给 pnpm 配置镜像源后再重装，例如pnpm config set registry。
• 3000 端口被占用：查看终端输出的实际端口，或用其他软件前先释放 3000。
• Docker 启动后页面 502：多为.env未初始化或数据库仍在迁移，等日志出现 migration 完成再刷新。

下一步

跑通后建议做两件事：把现有 Postman 集合通过界面上的 Import 功能导入，几分钟内即可整体迁移；再用 pre-request script 和 post-response script 给你的第一个接口加上参数化和断言。想深入看代码结构，可以从 packages/hoppscotch-common/ 的前端主包和 CONTRIBUTING.md 入手。

【免费下载链接】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