Hoppscotch API 测试工具快速上手：从在线版到自建部署

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 开发生态网页版打开后选方法、填 URL、点 Send就能看到响应状态和响应体。无需安装就能开始团队也可以把整套数据自建在本地。项目速览Hoppscotch 是什么Hoppscotch 是一个 MIT 协议开源项目自我定位是 Postman、Insomnia 的开源替代品覆盖 Web、桌面、CLI 三种形态。代码是 pnpm monorepoWeb 前端在 hoppscotch-common基于 Vue 3自建后端 hoppscotch-backend 用 NestJS Prisma配 PostgreSQL桌面版用 Tauri V2 构建支持 Windows、macOS、Linux。个人用在线版即可团队想完全掌控数据就走自建部署。 快速上手三种方式使用在线版打开即用浏览器打开官网 Web 版 hoppscotch.io输入 URL 点 Send响应状态码、耗时、大小实时显示在响应区上方。还可以把它作为 PWA 安装到设备支持离线使用和即时启动。本地部署Docker 一条命令跑起来不想把数据放在公有云就克隆仓库git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch然后在仓库目录执行docker compose --profile default up。这个 profile 自带 all-in-one 服务和 Postgres 实例并自动迁移数据库启动后浏览器访问本地 3000 端口即可使用。桌面版Mac、Linux 一条命令安装macOS 或 Linux 执行brew install --cask hoppscotchWindows 到官网下载即可。桌面版首次启动可登录云账号也可以点 “Add an instance” 连接自己自建的实例。 核心能力拆解多协议请求6 种协议一个入口场景同一个项目里既有 REST 接口又有 GraphQL 网关和 WebSocket 长连接。操作左侧边栏点图标就能在 REST、GraphQL、WebSocket、SSE、Socket.IO、MQTT 之间切换请求面板自动适配。价值联调时不用在三个工具间来回切所有请求都落在同一套集合和历史里。认证5 种方式覆盖常见场景场景接口要带 token或者需要账号登录。操作请求页切到 Authorization 标签从 None、Basic、Bearer Token、OAuth 2.0、OIDC Access Token/PKCE 里选一种填好凭证即可。价值OAuth 2.0 的令牌获取流程由工具处理你不用手动拼 token 请求。集合、历史与代码生成场景接口要反复用或者要转给同事复现。操作请求可存进不限数量的集合和嵌套文件夹每次发送的请求都会进历史并与云端或本地会话同步。还能一键生成 10 多种语言的请求代码片段、复制公开 Share URL或直接导入 cURL。价值把一个接口从“截图”变成“一条命令”只需要一次点击。响应预览JSON、图片、XML 直接看场景响应是大 JSON或者接口直接返回图片。操作响应区提供 JSON、Raw、Headers、Test Results 四个视图支持 HTML、图片、JSON、XML 预览可复制到剪贴板也能把响应下载成文件。价值不用再开别的工具格式化一遍。 进阶场景环境变量 × 预请求脚本切换环境在 Environments 里建“开发”“生产”两个环境存放 base URL 这类变量。请求的 Pre-Request Script 标签写一段小脚本给环境写变量、在 header 里塞时间戳、往 URL 参数里放随机串都可以。URL 和 header 里引用变量切环境只改变量的值请求本身不用动。自建实例 × 桌面版用 Docker 部署实例见上文本地部署。桌面版点左上角 logo选 “Add an instance”输入实例 URL 后 Connect。连接前记得配置实例 .env 的 WHITELISTED_ORIGINS常见报错见下面避坑指南。⚠️ 避坑指南浏览器里发请求报 CORS 错误现象请求跨域报错尤其是对不开放跨域的接口。原因浏览器同源策略拦截。解法Settings 里开启 Proxy Mode它同时能访问 http:// 的非 HTTPS 接口可用团队官方维护的代理服务也可以填自己的代理地址。桌面版连不上自建实例现象桌面版输入自建地址后连不上。原因实例 .env 的 WHITELISTED_ORIGINS 没包含桌面应用的来源。解法往里追加app://hoppscotch_mydomain_commacOS、Linux和http://app.hoppscotch_mydomain_comWindowsmydomain_com 换成你的实例域名。本地开发安装报错现象在根目录用 npm install 直接失败。原因项目 preinstall 脚本强制只允许 pnpm。解法改用 pnpm install项目声明了 pnpm 10.33.4建议对齐版本避免依赖漂移。写在最后Hoppscotch 的思路很简单快、轻、免费。在线版适合个人随手调试Docker 自建适合团队掌握数据同仓库里的 hoppscotch-cli 也给命令行党留了位置。下次联调接口时可以把它放进你的常用工具箱试试。相关资源READMEWeb 前端源码桌面版说明文档docker-compose.yml 部署配置【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考