企业官网建设流程全解析

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 开发工具，一个界面里发 REST、GraphQL、WebSocket、SSE 请求，可平替 Postman 与 Insomnia。本文带你走完「打开即用 → 组织管理 → 三种部署形态 → 提效避坑」全流程，读完即可独立跑通。

零账号零配置，三步发出第一个请求

打开在线版或桌面端后无需任何初始化。中间就是请求编辑区，三步完成一次调用：

1. 在方法下拉框选GET（或输入POST、PUT等自定义方法）；
2. URL 栏填接口地址，按需补 Query、Header、Body；
3. 点Send（快捷键Ctrl/Cmd + Enter），下方立刻返回状态码、耗时、响应头与格式化响应体。

全程不要求注册，发送记录自动进入历史，可回看重发。

核心能力：按你要做的事拆

发 REST 请求、看响应

• Body 按 Content Type 切换 JSON、FormData、x-www-form-urlencoded，支持键值对与 RAW 两种输入。
• 响应区可复制、下载，JSON/XML/HTML/图片均有预览。
• 左侧集合按文件夹组织，单个请求可导出多种语言的代码片段，也支持粘贴 cURL 命令直接导入。

变量、集合、认证怎么管

• 环境变量：把 base URL、token 存进环境，请求里用{{变量名}}引用，切环境不用逐条改。
• 集合：请求与文件夹可存进集合，支持嵌套、批量导入导出，便于交接。
• 认证：Authorization 页签提供 None、Basic、Digest、Bearer、OAuth 2.0、API Key、AWS Signature、HAWK、JWT 等选项，凭证放进环境避免写死。

多协议怎么切

• GraphQL：填 endpoint 后自动拉取 schema，带文档面板，可写查询并查看结果。
• Realtime：WebSocket、SSE、Socket.IO、MQTT 各占一个入口，分别对应长连接、事件流、Socket.IO 与主题订阅发布。
• 测试 SSE 时连接建立后消息按到达顺序展示在面板里，无需自己写轮询。

三种使用形态：在线、自托管、桌面端

• 在线版：适合临时调接口、不想装东西的人。浏览器内可装为 PWA，支持离线，零操作直接用。
• 自托管：适合数据必须留在机房、要团队同步的场景。克隆后一条命令拉起完整后端（含数据库自动迁移）：

docker compose --profile default up

• 桌面端：支持 Windows、macOS、Linux，本质是壳了本地资源的 Web 应用，加载快、适合内网离线。左上角实例菜单可切 Cloud / On-prem / 自定义地址。

提效技巧

• 预请求脚本 + 后置测试：发送前跑 JS 生成时间戳、随机参数、写环境变量；响应回来后跑断言校验状态码或字段，脚本跑在沙箱内碰不到浏览器对象。
• 命令菜单与快捷键：Ctrl/Cmd + K调出搜索与命令菜单，配合高密度快捷键纯键盘发请求，效率接近命令行。
• 团队协作：登录后建团队与工作区，共享集合与环境，带基于角色的成员权限，数据多端同步。
• cURL 导入：把现成的 curl 命令直接贴进来，省去手填 URL、Header、Body 的麻烦。

避坑清单

• 现象：浏览器发请求报 CORS 错误。原因：浏览器同源策略拦截跨域接口。解决：在设置里开启代理模式，填官方代理或自己的代理地址，顺带解决非 HTTPS 接口被拦的问题。
• 现象：换设备或清缓存后请求、历史全没了。原因：未登录时数据只存在当前浏览器会话存储里。解决：登录账号即可跨端同步，个人与团队数据用工作区隔离。
• 现象：自托管起来后只有前端页面，没有团队、同步能力。原因：自托管走的是仓库内完整后端（Prisma + NestJS），需带数据库配套，不是单纯静态页。解决：按上面--profile default命令拉起，确保数据库服务一并启动并自动迁移。

写在最后

Hoppscotch 把「发请求、管变量、换环境、交给同事」收进同一个轻量界面，且完全免费开源，改源码与私有化部署都没有门槛。

相关资源：

• 项目说明与完整功能列表：README
• REST 请求主界面源码：packages/hoppscotch-common/src/components/http/
• 桌面端实现：packages/hoppscotch-desktop/
• 本地开发指南：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