企业官网建设流程全解析

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

每个开发过的人都遇到过这种场景：后端刚提测一个接口，你要快速验证参数和响应，但又不想打开一个笨重的商业工具，临时写脚本又太麻烦。Hoppscotch 是一个开源的 API 开发生态系统，可以免费替代 Postman 和 Insomnia，REST、GraphQL、WebSocket、MQTT、Socket.IO 一网打尽，Web、桌面、命令行三种形态都有，MIT 协议，完全免费。

更关键的一点是它支持自托管：把整套服务部署到你自己的电脑或公司内网，请求内容、集合、历史数据都不用经过第三方。下面带你把它跑起来，并发出第一个真实的 API 请求。

🚀 三步在本地部署 Hoppscotch：克隆、安装、启动

准备工作很简单：Node.js 18+ 和 pnpm。然后只需要三步：

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

依赖装完后执行pnpm dev，本地开发服务就会启动，浏览器打开控制台给出的地址就进入 Hoppscotch 界面了。首次安装下载依赖要几分钟，属于正常现象，别急着关终端。

📮 在 Hoppscotch 里发出你的第一个请求

进入界面后，核心操作只有三件事：选请求方法、填 URL、点 Send。第一个目标可以直接用官方的回显服务https://echo.hoppscotch.io，它会把你的请求原样返回，特别适合试手。

请求区上方是 Parameters、Body、Headers、Authorization、Pre-request Script、Tests 这些标签页：Parameters 里加查询参数，Body 里切换 JSON 或 form-data 等格式，支持键值对和原始文本两种输入方式。发送后下方会展示状态码、耗时、响应大小，JSON 响应会自动格式化，不用你再手动美化。

想深入看数据结构的话，REST 请求相关的源码模型都集中在 packages/hoppscotch-data/src/rest/，调试出问题时可以顺着这里翻。

📥 从 Postman 导入集合并管理多环境

如果你之前用 Postman 或 Insomnia，收藏的集合不用重建。在界面里用导入功能，直接选 Postman 或 Insomnia 导出的文件，集合结构、请求、文件夹会原样搬过来，各格式的解析实现可以看 packages/hoppscotch-common/src/helpers/import-export/ 目录。

环境（Environment）用来存放开发、测试、生产三套域名和 token：请求里写{{baseUrl}}，然后在右上角切换环境即可。集合和环境都能导出成文件，方便备份和交接。想批量跑用例的话，仓库里的 packages/hoppscotch-cli/ 提供了命令行工具，把接口测试写进 CI 也能跑。

🖥️ 自托管 Hoppscotch，让桌面应用连上内网实例

团队场景推荐用仓库根目录的 docker-compose.yml 在内网服务器上一键部署，起来之后同事开浏览器就能用，数据全部留在公司网络里。

桌面端应用（代码在 packages/hoppscotch-desktop/ 下）基于 Tauri 构建，下载安装后左上角可以选云版本，也可以点 "Add an instance" 填上你自己部署的地址接入，效果见下图。这样请求、集合、环境变量全部走内网，安全性比纯 Web 版更让人放心。🔒

👥 团队协作：共享集合、环境与角色权限

自托管起来后，团队功能才完整可用：创建团队、共享集合、按角色控制成员权限，后端实现可以看 packages/hoppscotch-backend/src/team/。个人和团队的集合可以分别放进不同工作区（Workspace），一键切换，多项目不串味。

另外别忘了 Tests 标签页：每个请求都能写发请求后的断言脚本，自动检查状态码、响应字段，配合环境变量能把接口调试顺带变成轻量级的契约校验。🧪

装好之后建议先用 echo 服务发一个请求热身，再把旧集合导进来找找手感。快捷键、代理模式、主题定制这些进阶玩法，可以去官方文档站 docs.hoppscotch.io 查；想跟进新功能，仓库根目录的 CHANGELOG.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