企业官网建设流程全解析

Hoppscotch开源API测试工具：5分钟搭建本地可用的请求测试环境

【免费下载链接】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 开发与测试工具，覆盖 REST 请求调试、GraphQL 查询、WebSocket、MQTT 等通信协议，支持 Web、桌面与命令行三种形态。本文带你走完从克隆源码、启动开发环境，到构建部署一个可用实例的完整流程。即使没接触过自托管工具，读完也能在自己的机器上跑起一套属于自己的 API 测试环境。

适合场景与核心能力

• 个人日常调试：选方法、填 URL、点发送，实时查看响应状态码、请求头与正文，支持导入 cURL、一键生成 10 多种语言的请求代码片段。
• 团队与离线场景：通过 docker-compose.yml 可自托管整套服务（应用 + 后端 + 数据库），支持团队协作、环境变量管理与请求历史同步，数据留在自己服务器里。
• 多种通信协议：除了常规 HTTP，还能测试 GraphQL、WebSocket、Socket.IO、MQTT 与 SSE，一套工具替代多个单点工具。

最快上手路径

先准备好环境：仓库使用 pnpm 10 系列管理依赖（根目录 package.json 中有版本锁定），建议安装 Node.js 18 及以上与 pnpm。

然后执行三条核心命令：

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

pnpm dev会并行启动前端开发服务器，默认监听 3000 端口。看到终端提示就绪后，浏览器打开http://localhost:3000，输入任意接口地址（例如一个公开的 REST 端点）并点击 Send，能拿到响应就算环境可用。

从开发环境到可用环境

本地启动与体验

开发模式适合体验和改代码：pnpm dev基于 Vite 热更新，端口固定在 3000（配置见 vite.config.ts）。体验阶段建议先只用 Web 版，桌面与 CLI 属于扩展项，不要一开始就全装。

生产构建

确认功能正常后，构建静态产物：

pnpm build

前端产物输出到packages/hoppscotch-selfhost-web/dist，根目录的pnpm start会用静态服务器在 3000 端口托管该目录，方便快速预览生产效果。dist 目录可交给任意 Web 服务器（Nginx 等）对外服务。

Docker 部署（推荐用于团队）

需要登录后端、团队同步、管理面板时，直接走容器化：

docker compose --profile default up

该 profile 会拉起应用（3000 端口）、后端（3170/3180 端口）以及 PostgreSQL 数据库，并自动执行迁移。各组件组合方式见 compose 文件头部的 PROFILES 说明。

访问验证与端口检查

• 浏览器访问http://localhost:3000，应能看到完整的请求编辑界面而非报错页。
• 用一个真实端点发 GET 请求，确认状态码、响应体正常渲染。
• 若用 Docker，额外确认 3170 端口可访问；对外暴露时记得在防火墙放行对应端口。
• 检查应用目录有读写权限，构建失败大多与依赖未装全有关，先回看pnpm install的输出。

常见卡点与处理方式

• npm install直接报错退出：根目录 package.json 的 preinstall 强制只允许 pnpm，改用pnpm install即可。
• 依赖下载很慢：给 pnpm 配置国内镜像源（pnpm config set registry指向镜像地址）后重新安装。
• 3000 端口被占用：Vite 会自动换到相邻端口，以终端实际输出的地址为准；或停掉占用端口的进程。
• 浏览器里测试某接口报 CORS：在设置中开启代理（Proxy）模式，或改用桌面端发起请求。
• 想编桌面版却报工具链错误：桌面端在 packages/hoppscotch-desktop/，依赖 Rust/Tauri 环境，建议先用 Web 版，桌面版按需再补环境。

接下来可以做什么

• 需要自动化跑测试，看 packages/hoppscotch-cli/，它支持按集合批量执行请求与断言，适合接入 CI。
• 想要离线与系统集成，阅读 packages/hoppscotch-desktop/ 下的 README，了解 Tauri 打包方式。
• 关注多语言支持可以看 TRANSLATIONS.md，改动记录见 CHANGELOG.md，许可证为 MIT（见 LICENSE）。
• 需要补充：官方自托管文档的详细环境变量清单，建议以仓库内 backend 包的.env相关说明为准逐项核对。

适合个人开发者快速替代商业 API 调试工具，也适合团队做内网自托管。下一步建议：先用pnpm dev跑通本地体验，再评估是否要上 Docker 部署与 CLI 集成。

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