企业官网建设流程全解析

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/hoppscotch

Postman 免费版逼你注册账号，请求多了还弹水印。Hoppscotch 是开源的 API 测试工具，MIT 协议，本地就能跑：REST 请求、GraphQL 查询、WebSocket 连接、MQTT 订阅，第一分钟全部可用，数据留在你自己的机器上。

从源码到可运行：最短路径

前提只有两个：Node.js（18 以上的 LTS 即可）和 pnpm。项目根目录的 package.json 里通过preinstall强制了 pnpm，直接用 npm 会报错，所以先装好 pnpm 再往下走。

# 拉取源码（仓库在 packages/ 下分模块组织） git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch cd hoppscotch # 安装全部工作区依赖，装完会自动跑 GraphQL 代码生成 pnpm install # 一键启动 web 端 pnpm dev

三条命令走完，Vite 开发服务器起在http://localhost:5173（被占用时自动顺延端口），终端打印的地址直接打开就行。npm 和 yarn 也能装，但速度会慢很多，不建议。

按场景选运行方式

同一个仓库里有 web、桌面端、CLI 三套入口，按需挑一个：

桌面端适合没有外网的内网环境，desktop-app.png 展示的就是打包后的效果：

想接入自己的自托管实例，参考 packages/hoppscotch-desktop/connection-to-self-hosted-instance.png 的配置方式即可。

启动成功的判断标准 + 第一个请求

浏览器打开后，确认三件事就算部署完成：

1. 左侧能看到 REST / GraphQL / WebSocket / MQTT 等入口；
2. 右上角的 "New REST" 按钮可点击创建请求；
3. 控制台没有红色报错，请求面板渲染正常。

来一发真实请求验证链路：方法选GET，地址填https://jsonplaceholder.typicode.com/users/1，点 Send。右侧应立刻返回状态码 200 和用户 JSON。

顺手试两个高频功能：

• cURL 导入：粘贴一段curl命令，Hoppscotch 会自动解析成请求；
• 环境变量：把 URL 里的 host 换成{{base_url}}，然后在 Environment 面板给base_url赋值，换环境只改一处。

卡住了查这里

Node 版本不够—— 报错信息里出现 ESBUILD 相关堆栈或依赖安装失败，先node -v，低于 18 就升级 LTS。

端口被占用—— 默认 5173（构建后用 3000），被占时终端会提示实际端口；也可以先杀掉旧进程再pnpm dev。

依赖下载慢—— 换 pnpm 镜像源：pnpm config set registry https://registry.npmmirror.com，重新pnpm install。

桌面端编译失败——pnpm tauri dev依赖 Rust 工具链，装 Rust 后再试；不折腾 Rust 的话直接用 web 版。

小结

三条命令，换来一个功能完整、可离线、免费开源的 API 测试环境，个人用够了。接下来可以看 packages/hoppscotch-cli 把请求跑进 CI，或从 packages/hoppscotch-backend 搭起自托管后端，把收藏和团队同步放到自己的服务器上。

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