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/hoppscotchHoppscotch 是一套开源的 API 调试与测试工具定位就是 Postman、Insomnia 的免费替代品REST、GraphQL、WebSocket、MQTT 请求全都能发还自带 CLI 和多端形态。这篇指南不绕弯子先把从零到看到界面的路径讲清楚再补齐桌面版、生产构建和常见报错的处理办法。它到底能干哪些活装之前先确认它是不是你需要的东西免得白折腾。Hoppscotch 能覆盖的协议面比较宽RESTGET / POST / PUT / PATCH / DELETE 等全部方法支持自定义方法、Header、参数、环境变量还能把 curl 命令直接粘贴进来转成请求GraphQL输入端点后自动拉取 schema左侧浏览类型定义右侧写查询并拿到响应实时通信WebSocket、Server-Sent Events、Socket.IO 和 MQTT 都有独立的连接界面认证Basic、Bearer Token、OAuth 2.0、OIDC 等常见方案内置不用自己拼 Header多端同一个代码库里有 Web、桌面端和 CLI 三种形态团队协作时支持自建后端做数据同步如果你只是偶尔手动点几个接口Web 版就够了要把接口测试跑进 CI或者想在离线环境用后面会讲对应的路径。动手前的两个准备整个项目跑在 Node.js 上官方 Docker 镜像基于 Node 20 LTS所以本机装一个Node 18推荐 20 LTS 或更新的 LTS 版本基本不会踩坑。第二个准备是包管理器项目用 pnpm 管理 workspace而且根目录的preinstall钩子会直接拒绝 npm / yarn只有 pnpm 能装。Node 16 以上自带 corepack执行下面这条命令就能启用与项目锁定的 pnpm 版本不用手动全局安装corepack enable如果你的 Node 版本较旧没有 corepack可以用npm i -g pnpm兜底。准备工作就这么多。项目本身是 pnpm workspace 结构packages/下按职责分了十几个包——web 前端、NestJS 后端、桌面壳、CLI 都在里面后面所有命令都基于这个结构展开。从克隆到打开界面4 条命令前置条件齐了跑通 Web 开发环境只要 4 条命令git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch cd hoppscotch pnpm install pnpm devpnpm dev会在后台拉起各子包的 Vite 开发服务浏览器打开http://localhost:3000就是完整的应用界面左侧是请求和集合右侧填 URL、配参数、点发送、看响应。开发模式下改动前端代码会热更新不用重启。跑完这一节你已经有了一个能发请求的 API 测试环境。下面两种场景按需取用。想要桌面客户端换个目录接着装桌面版是基于 Tauri 的独立应用代码在packages/hoppscotch-desktop/适合离线使用或者需要系统级通知、全局快捷键的场景。它不在根目录的pnpm dev范围内要单独进入目录操作cd packages/hoppscotch-desktop pnpm install pnpm tauri dev注意桌面版开发需要系统装好 Tauri 要求的 Rust 工具链和对应平台的 GUI 依赖Linux 上一般是 webkit2gtk、libayatana-appindicator 这类系统库首次编译 Rust 部分会比 Web 端慢不少属于正常现象。开发模式起来后可以在应用里配置它连接你自己部署的后端实例实现数据同步。构建生产版本开发验证完毕、要上线给团队用时构建产物就是纯静态文件pnpm buildVite 会把打包结果输出到对应包的dist目录扔到任何静态服务器Nginx、Caddy、对象存储都行就能访问。仓库根目录已经备好了prod.Dockerfile和 Caddy 配置配合docker-compose.yml可以直接把webapp NestJS 后端 Postgres整套自建栈拉起来——需要账号体系、团队共享和请求历史时走这条路端口约定大致是主站 3000、后端 3170、管理后台 3100。装不动三个高频报错的解法pnpm install阶段报 Only supported by pnpm这是根目录的only-allow钩子在拦截说明你用的是 npm 或 yarn。装 pnpm 后重新执行安装命令即可。依赖拉取慢、频繁 ETIMEDOUT给 pnpm 配一个离你近的镜像源或给npm_config_registry设置公司内网源必要时调高并发和超时参数再重试workspace 子包多中途断掉就重跑同一条命令已下载的会走缓存。localhost:3000打不开先确认终端里没有报错端口被占时 Vite 会自动顺延到下一个空闲端口实际地址看终端输出的 URL如果 3000 被长期占用改packages/hoppscotch-selfhost-web/vite.config.ts里server.port的值即可别用 3170、3200、3100那是自建后端栈预留的。接下来往哪走按使用深度排个序个人日常调试Web 版装完即用想把测试用例脚本化、跑进 CI去packages/hoppscotch-cli/看 CLI 的用法它可以直接执行集合文件并输出报告要搭团队共享环境从根目录的docker-compose.yml和 docker-compose 部署配置 入手再配合packages/hoppscotch-backend/的后端源码理解各服务职责想改界面主题或新增协议支持入口在packages/hoppscotch-common/这个主前端包里。【免费下载链接】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），仅供参考 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/hoppscotchHoppscotch 是一套开源的 API 调试与测试工具定位就是 Postman、Insomnia 的免费替代品REST、GraphQL、WebSocket、MQTT 请求全都能发还自带 CLI 和多端形态。这篇指南不绕弯子先把从零到看到界面的路径讲清楚再补齐桌面版、生产构建和常见报错的处理办法。它到底能干哪些活装之前先确认它是不是你需要的东西免得白折腾。Hoppscotch 能覆盖的协议面比较宽RESTGET / POST / PUT / PATCH / DELETE 等全部方法支持自定义方法、Header、参数、环境变量还能把 curl 命令直接粘贴进来转成请求GraphQL输入端点后自动拉取 schema左侧浏览类型定义右侧写查询并拿到响应实时通信WebSocket、Server-Sent Events、Socket.IO 和 MQTT 都有独立的连接界面认证Basic、Bearer Token、OAuth 2.0、OIDC 等常见方案内置不用自己拼 Header多端同一个代码库里有 Web、桌面端和 CLI 三种形态团队协作时支持自建后端做数据同步如果你只是偶尔手动点几个接口Web 版就够了要把接口测试跑进 CI或者想在离线环境用后面会讲对应的路径。动手前的两个准备整个项目跑在 Node.js 上官方 Docker 镜像基于 Node 20 LTS所以本机装一个Node 18推荐 20 LTS 或更新的 LTS 版本基本不会踩坑。第二个准备是包管理器项目用 pnpm 管理 workspace而且根目录的preinstall钩子会直接拒绝 npm / yarn只有 pnpm 能装。Node 16 以上自带 corepack执行下面这条命令就能启用与项目锁定的 pnpm 版本不用手动全局安装corepack enable如果你的 Node 版本较旧没有 corepack可以用npm i -g pnpm兜底。准备工作就这么多。项目本身是 pnpm workspace 结构packages/下按职责分了十几个包——web 前端、NestJS 后端、桌面壳、CLI 都在里面后面所有命令都基于这个结构展开。从克隆到打开界面4 条命令前置条件齐了跑通 Web 开发环境只要 4 条命令git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch cd hoppscotch pnpm install pnpm devpnpm dev会在后台拉起各子包的 Vite 开发服务浏览器打开http://localhost:3000就是完整的应用界面左侧是请求和集合右侧填 URL、配参数、点发送、看响应。开发模式下改动前端代码会热更新不用重启。跑完这一节你已经有了一个能发请求的 API 测试环境。下面两种场景按需取用。想要桌面客户端换个目录接着装桌面版是基于 Tauri 的独立应用代码在packages/hoppscotch-desktop/适合离线使用或者需要系统级通知、全局快捷键的场景。它不在根目录的pnpm dev范围内要单独进入目录操作cd packages/hoppscotch-desktop pnpm install pnpm tauri dev注意桌面版开发需要系统装好 Tauri 要求的 Rust 工具链和对应平台的 GUI 依赖Linux 上一般是 webkit2gtk、libayatana-appindicator 这类系统库首次编译 Rust 部分会比 Web 端慢不少属于正常现象。开发模式起来后可以在应用里配置它连接你自己部署的后端实例实现数据同步。构建生产版本开发验证完毕、要上线给团队用时构建产物就是纯静态文件pnpm buildVite 会把打包结果输出到对应包的dist目录扔到任何静态服务器Nginx、Caddy、对象存储都行就能访问。仓库根目录已经备好了prod.Dockerfile和 Caddy 配置配合docker-compose.yml可以直接把webapp NestJS 后端 Postgres整套自建栈拉起来——需要账号体系、团队共享和请求历史时走这条路端口约定大致是主站 3000、后端 3170、管理后台 3100。装不动三个高频报错的解法pnpm install阶段报 Only supported by pnpm这是根目录的only-allow钩子在拦截说明你用的是 npm 或 yarn。装 pnpm 后重新执行安装命令即可。依赖拉取慢、频繁 ETIMEDOUT给 pnpm 配一个离你近的镜像源或给npm_config_registry设置公司内网源必要时调高并发和超时参数再重试workspace 子包多中途断掉就重跑同一条命令已下载的会走缓存。localhost:3000打不开先确认终端里没有报错端口被占时 Vite 会自动顺延到下一个空闲端口实际地址看终端输出的 URL如果 3000 被长期占用改packages/hoppscotch-selfhost-web/vite.config.ts里server.port的值即可别用 3170、3200、3100那是自建后端栈预留的。接下来往哪走按使用深度排个序个人日常调试Web 版装完即用想把测试用例脚本化、跑进 CI去packages/hoppscotch-cli/看 CLI 的用法它可以直接执行集合文件并输出报告要搭团队共享环境从根目录的docker-compose.yml和 docker-compose 部署配置 入手再配合packages/hoppscotch-backend/的后端源码理解各服务职责想改界面主题或新增协议支持入口在packages/hoppscotch-common/这个主前端包里。【免费下载链接】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），仅供参考