hoppscotch 是一个开源的 API 开发生态（API development ecosystem），由 Hoppscotch 项目维护，提供官方 Web、桌面与命令行客户端，用于构建、测试与调试 API；也可在自有基础设施上部署社区版或企业版。

它面向需要快速调试接口、管理集合与环境，以及在个人、团队或内网场景下协作的开发者与组织。关键边界在于：部分企业能力（如基于 SAML 的单点登录）属于企业版；命令行工具仍处于 alpha 阶段；社区版与企业版的能力与支持方式并不相同。

核心能力可概括为：多协议请求（REST、GraphQL、WebSocket、SSE、Socket.IO、MQTT）、集合与环境管理、团队与工作区协作、代码片段生成、导入导出、代理与浏览器扩展、CLI 测试，以及面向 AI 代理的 MCP 服务器等客户端形态。

hoppscotch 官网首页整页，展示产品定位与入口

hoppscotch 是什么？谁开发的、是否官方？

hoppscotch 官方定位为「开源 API 开发生态」，提供 Web、桌面和 CLI 客户端，帮助开发者以极简、不打扰的界面构建、测试与调试 API。

它可在离线、本地（on-prem）与云端使用，并配套 Web、桌面与 CLI 应用。项目主页指向 hoppscotch.io，源代码托管在 GitHub 仓库 hoppscotch/hoppscotch。

hoppscotch GitHub 仓库页整页，可见星标、许可证与简介

按官方说明，发行形态包括：

Hoppscotch Cloud：托管的 API 开发与测试平台，便于与团队分享 API
Community Edition（自托管）：免费、开源，MIT 许可，可用于个人与商业项目
Enterprise Edition（自托管）：Hoppscotch Cloud 的自托管版本，带企业向功能
Enterprise Cloud：发布说明中的新层级，含身份与访问管理、单点登录、审计日志与专属支持等

客户端还包括 Web、Desktop、CLI，以及用于连接 AI 代理的 MCP 服务器。最新列出的发行版为 2026.9.0（2026-09-30）。

hoppscotch 开源许可证是什么？能否商用？

主项目采用 MIT License。官方许可证说明写明：在保留版权与许可声明的前提下，可免费使用、复制、修改、合并、发布、分发、再许可与销售。

软件按「按现状（AS IS）」提供，不附带明示或暗示担保。Community Edition 明确可写用于个人与商业项目，定价为 Free。

需要区分的是：

社区版：开源分发（open-source），可自托管
企业版：open-core，自托管云功能的企业向版本，含 SAML SSO、本地部署、审计日志等
SSO 登录：功能列表中标注为 EE（企业版）能力

因此，「协议允许商用」不等于「企业 dig 功能都可在社区版免费获得」。若需要 SSO、审计、优先支持等，应对照企业版与 Enterprise Cloud 的说明。

hoppscotch 能做什么？支持哪些 API 协议？

官方称 hoppscotch 是免费开源的 API 开发平台，用于更快地构建、测试与文档化 API。协议与通信方面，公开能力覆盖：

类型	说明（据官方描述）
REST	常规 HTTP 接口调试
GraphQL	GraphQL 请求与相关工作流
WebSocket	单 TCP 连接上的全双工通道
SSE	服务器推送事件
Socket.IO	Socket.IO 场景
MQTT	MQTT 场景

其他高频能力包括：

无限集合、文件夹与请求；无限环境与变量；无限工作区
创建无限团队、共享集合，并带基于角色的访问控制（RBAC）
授权类型：None、Basic、Bearer、OAuth 2.0、OIDC Access Token/PKCE
生成/复制 10+ 语言与框架的请求代码片段；支持导入 cURL
集合与环境可按文件或 GitHub gist 导入导出
代理模式：可隐藏 IP、处理 CORS、访问非 HTTPS 端点
浏览器扩展（Firefox、Chrome）用于修复 CORS 问题
官方附加组件：Hoppscotch CLI、Proxy（proxyscotch）、浏览器扩展
可安装为 PWA，支持离线使用
脚本默认在 QuickJS WebAssembly 沙箱中运行
密钥类环境变量保存在本地，不同步到服务器
企业向可观测性：OpenTelemetry 指南可对接 Jaeger、Prometheus、Grafana
AI 相关：隐私政策写明与 OpenAI（GPT-4o mini）合作以增强开发/测试；用户提示与 API 信息可能被用于生成内容。2026.9.0 为企业自托管增加 AI Assistant，可编辑/运行请求、管理集合与环境、发布文档、管理 mock，并含 AI skills 与可配置的提供商连接；另有 MCP 服务器客户端形态

hoppscotch 浅色主题主界面，展示请求编辑与响应区布局

hoppscotch 深色主题主界面，展示同一套 API 调试工作区

hoppscotch 怎么安装与部署？Web/桌面/CLI/自托管如何选？

可按场景选择客户端与部署方式：

方式	适用场景	要点
Web（hoppscotch.io）	立刻试用、个人快速调试	打开即可免费使用
PWA	希望安装到设备并离线	以渐进式 Web 应用安装
Desktop	macOS / Windows / Linux 本地应用	基于 Tauri 与 Web 客户端
CLI	终端跑集合测试、对接流水线	npm 全局安装；目前为 alpha
Cloud	不想自己托管与扩容	托管平台，官方称无需操心托管、扩缩与维护
Self-Host Community	要数据所有权与可控成本	免费；自行安装、管理、维护；季度发布需自助升级
Self-Host Enterprise	企业合规与管理能力	含优先支持、高级管理、SAML SSO/OIDC、域名白名单等

自托管前提（官方指南）：Node.js v18+、npm v9+、pnpm v6+、Docker v20+、Git。数据使用 PostgreSQL，需在配置中设置 DATABASE_URL；库内敏感数据加密键 DATA_ENCRYPTION_KEY 须为 32 个字符。Community 与 Enterprise 均可在支持 Docker 的环境部署。

拉取 AIO 镜像：

docker pull hoppscotch/hoppscotch

该命令从 Docker Hub 拉取 hoppscotch/hoppscotch 一体化镜像，作为后续迁移与运行的基础镜像。

在容器内执行数据库迁移（先进入容器 shell，再部署 Prisma 迁移）：

docker run -it --entrypoint sh --env-file .env hoppscotch/hoppscotch
# pnpm exec prisma migrate deploy

-it：交互终端，便于进入 shell
--entrypoint sh：覆盖默认入口为 shell，方便手动跑迁移
--env-file：从环境文件注入 DATABASE_URL、DATA_ENCRYPTION_KEY 等配置
pnpm exec prisma migrate deploy：在容器内应用数据库迁移

启动 AIO 容器并映射端口：

docker run -p 3000:3000 -p 3100:3100 -p 3170:3170 --env-file .env --restart unless-stopped hoppscotch/hoppscotch

-p 3000:3000：应用默认访问端口（http://localhost:3000）
-p 3100:3100：管理端（在 subpath access 为 false 时为 http://localhost:3100）
-p 3170:3170：镜像一并暴露的服务端口
--restart unless-stopped：非主动停止时自动重启
自托管目标是在自有数据中心或云资源中掌握数据与控制面

CLI 安装：

npm i -g @hoppscotch/cli

当前 CLI 最低 Node.js 为 v22。若仍在 Node.js v20（官方写明 2026 年 4 月 EOL），可继续使用 CLI v0.26.0，并搭配应用 v2025.10.1。CLI 可对云版或自托管中的集合发起测试（需个人访问令牌等机制，见 CLI 文档）。

生产安全相关配置还包括：显式设置 INFRA.SESSION_SECRET；可用 INFRA.RATE_LIMIT_TTL、INFRA.RATE_LIMIT_MAX 做后端限流；GraphQL 有查询复杂度限制；分析采集 INFRA.ALLOW_ANALYTICS_COLLECTION 为可选且默认关闭。

hoppscotch 与 OpenTelemetry 集成界面，展示对接可观测性组件时的配置与架构说明

hoppscotch 怎么用？以 REST 调试与团队协作场景完整演示

以一次 REST 调试为例（官方入门路径）：

打开 https://hoppscotch.io（或自托管后的应用地址，默认 http://localhost:3000）
在 URL 栏填入 API 端点
按需要选择方法、添加 Header、Body 与授权（None / Basic / Bearer / OAuth 2.0 / OIDC 等）
点击 Send
在响应区查看状态码、正文与相关调试信息

登录选项包括 GitHub、Google、Microsoft、Email，以及企业版 SSO。云版快速开始写明可获得 unlimited collections，功能面向个人与团队。

团队协作常见路径：

使用 Cloud 或自托管，创建工作区与团队，共享集合
用 RBAC 控制成员权限
集合/环境通过文件或 GitHub gist 导入导出，便于备份与流转
需要跨域时安装 Chrome/Firefox 扩展，或使用代理（proxyscotch）

以 CLI 跑集合测试为例：

hopp test [-e <environment file>] [-d <delay_in_ms> ] <hoppscotch collection file>

<hoppscotch collection file>：集合文件路径
-e：环境文件
-d：请求间隔（毫秒）

需要 JUnit 输出时可使用：

hopp test <file_path_or_id> --env <file_path_or_id> --reporter-junit [path]

可将结果交给 CI 系统解析。官方同时提醒：CLI 目前仍是 alpha。

hoppscotch 云版多少钱？自托管成本如何？

方案	价格	关键额度	适合谁
Community Edition（自托管）	Free	自行安装维护；社区论坛支持；季度发布自助更新	个人、可接受自运维的团队
Enterprise Edition（自托管）	19 美元/用户/月（按月计费）	优先支持；高级管理；SAML SSO/OIDC；域名白名单	要企业能力与本地部署的组织
Hoppscotch Cloud	Get started for free	托管；文档写明 unlimited collections；无需自管扩缩	想尽快用托管平台的个人/团队

补充要点：

企业自托管可预约演示以获取 free trial
Community 为开源分发；Enterprise 为 open-core
云版强调无需担心托管、扩缩与维护
付费通过 Stripe 等支付处理方采集卡信息（隐私政策表述）
自托管「成本」除许可证外，还包括你方的主机、数据库、备份与升级人力；社区版许可证费用为 Free，但不等于零运维
2026.9.0 引入 Enterprise Cloud 层级（IAM、SSO、Audit Logs、Dedicated Support 等）；具体云版付费档位若页面未在既有说明中展开，以官方定价页为准

hoppscotch 支持中文吗？界面与文档本地化怎么样？

应用支持 i18n，官方功能列表写明可「用你的语言体验应用」。社区翻译流程见仓库中的 TRANSLATIONS.md，欢迎贡献翻译。

发行记录中可见持续补齐文案键值（例如 2026.9.0 相关变更中有土耳其语缺失键的修补），说明本地化随版本迭代。界面语言能否完整覆盖简体中文的每一个词条，以你当前客户端内语言列表为准；文档站点本身请在浏览器中直接切换或查阅。

隐私政策提到，自动采集的设备数据中可能包含语言设置等信息。

hoppscotch 和 Postman、Insomnia 有什么区别？能替代它们吗？

维度	hoppscotch	Postman（一般特点）	Insomnia（一般特点）
产品形态	开源生态；Web / 桌面 / CLI；可云可自托管	常见为功能完整的 API 平台与协作套件	常见为 API 客户端与设计/调试工具
协议面	REST、GraphQL、WebSocket、SSE、Socket.IO、MQTT	通常覆盖主流 HTTP/API 调试与协作	通常侧重 REST/GraphQL 等常见调试
许可与部署	社区版 MIT、可商用自托管；企业版 open-core	多为厂商托管与商业订阅组合	常见开源/商业并行的客户端模式
协作	无限团队/工作区、共享集合、RBAC；云或自托管	一般强调团队空间、共享与组织管理	一般提供团队同步或类似协作能力
自动化	CLI（alpha）可跑集合并输出 JUnit	一般提供集合运行、监控与 CI 集成	一般支持 CLI/自动化或等价方案
UI 取向	官方强调极简、不打扰	一般功能入口多、生态插件全	一般界面相对精简

是否能「替代」取决于你的硬需求：若需要 MIT 自托管、轻量多协议调试、PWA/桌面/CLI 组合，hoppscotch 很合适；若强依赖某竞品独有生态、成熟度更高的 CLI/商用支持体系，或 issue 中仍在请求的能力（如 gRPC-Web、与 Git 仓库同步集合等），则需评估能否接受差距或用企业版/其他工具补齐。

竞品信息以各家官网为准。

hoppscotch 有哪些局限与常见坑？

已知问题与局限

CLI 仍是 alpha：命令行可跑集合测试并支持 JUnit 报告，但官方写明处于 alpha，Node 最低 v22；v20 用户需锁定 CLI v0.26.0 与应用 v2025.10.1 组合，升级前要核对兼容性。

社区版与企业版能力切割：SSO、审计日志、域名白名单、优先支持、AI Assistant（企业自托管，2026.9.0）等并不在「MIT 可商用」这句话里自动赠送；选型时按版本文档勾选，而不是只看许可证名称。

自托管运维责任在己方：Community 需自行安装、管理、维护，并跟随季度发布升级；还要正确配置 PostgreSQL、DATA_ENCRYPTION_KEY（32 字符）、生产环境 INFRA.SESSION_SECRET 等，否则易出现无法启动、数据或会话异常。

集合与 Git 仓库同步仍是高票需求未闭环：#870 请求与 Git 同步 collections，讨论活跃；目前更现实的做法是文件/gist 导入导出，而不是假设已有原生 GitOps。

gRPC-Web 尚未作为已交付能力：#402 为 gRPC-Web 支持请求；若协议栈以 gRPC-Web 为主，需另找工具或等待进展。

自托管账号体系与 OAuth 细节有缺口：#3447 希望自托管支持用户名密码注册登录；#3602、#5954 关注 OAuth2 redirect_uri 自定义及桌面端限制，企业 OAuth 对接前应做验证。

易用性类需求仍开放：例如自动保存请求 #3437、URL 与查询参数输入同步 #2227、WebSocket 消息存入集合 #3311、GraphQL 团队集合 #2013 等，说明部分工作流仍要手动保存或受协议/团队功能边界限制。

桌面分发与编辑器集成在社区仍有呼声：如 Flatpak 打包 #3525、上架 VS Code 市场 #4068；Linux 软件源或编辑器内工作流可能需要自行安装官方桌面包。

安全流程与 AI 数据边界：漏洞应通过 GitHub Security Advisories 报告，不要开公开 issue。启用 AI 能力时，隐私政策写明可能向 OpenAI 提供提示词与 API 相关信息；密钥环境变量虽强调本地且不同步，仍需分清「密钥变量」与「普通变量/请求体」的处理差异。

仓库规模侧面反映维护与问题量：GitHub 数据为 Stars 80567、Forks 6147、Open issues 848（核对至事实采集时点）。open issues 含功能请求与缺陷讨论，不代表全部是故障，但升级与排障时应习惯检索既有 issue。

hoppscotch 适合谁？什么情况下不该用？

较适合：

想要开源、可审计、MIT 许可下自托管或商用二次分发（遵循许可证声明）的团队
需要同一工具覆盖 REST 与 GraphQL，并兼及 WebSocket、SSE、Socket.IO、MQTT 的开发者
偏好轻量 UI，并用 Web / PWA / 桌面快速开箱的个人
需要 Cloud 免运维，或 Community 自托管掌控数据的组织
计划用 CLI 在 CI 中跑集合（可接受 alpha）并输出 JUnit 的工程团队
企业需要 SSO、审计、域名白名单、专属支持或 AI Assistant 时，可评估 Enterprise / Enterprise Cloud

更宜谨慎或暂缓：

强依赖 gRPC-Web、集合与 Git 原生双向同步、密钥托管（Key vault）等仍在功能请求中的能力
希望自托管但只有用户名密码注册、且不能接受当前登录提供方模型时（见 #3447）
把 CLI 稳定性等同于正式版生产契约，却不锁定 Node/CLI 版本矩阵
不能接受 AI 功能可能向外发送提示与 API 信息，又必须全面启用云端 AI 时
需要厂商承担全部托管责任，却选了 Community 自托管且无平台工程资源时

FAQ

hoppscotch 需要联网吗？

不一定。官方描述支持 offline、on-prem 与 cloud。Web 云端使用通常需要网络；桌面、PWA 与自托管可在内网或离线场景按部署方式工作。访问公网 API 或云同步/登录时仍需要相应网络路径。

hoppscotch 有桌面版吗？

有。官方提供跨平台桌面应用（Mac、Windows、Linux），基于 Tauri 与 Hoppscotch Web 客户端。桌面自动更新从 releases.hoppscotch.com 获取，并做签名校验。

hoppscotch 支持 MQTT/SSE/Socket.IO 吗？

支持。官方与仓库能力列表写明除 REST、GraphQL、WebSocket 外，还包括 SSE、Socket.IO 与 MQTT。具体调试体验以当前客户端界面中的协议入口为准。

数据存在哪？密钥会不会上传？

Cloud 由托管平台保存你在云端创建的数据；自托管则使用你方 PostgreSQL 等基础设施，官方强调可完整拥有数据。安全说明写明：密钥类环境变量存在本地、不同步到服务器；脚本默认在 QuickJS WebAssembly 沙箱执行。

如何导入 Postman collection？

既有事实未给出「一键导入 Postman collection」的逐步说明。已确认支持的路径包括：导入 cURL，以及集合/环境以文件或 GitHub gist 导入导出。若从 Postman 迁移，需以官方文档当前导入器列表为准，或先转换为 hoppscotch 支持的文件格式再导入。

团队协作怎么做？

可在 Cloud 或自托管中创建无限团队与工作区，共享集合，并使用 RBAC。登录可用 GitHub、Google、Microsoft、Email；SSO 为企业版能力。云版文档写明面向个人与团队，并可免费开始使用。

CLI 能做 CI 吗？

可以用于在终端对集合跑测试，并支持 --reporter-junit 输出，便于 CI 解析。CLI 也能针对云或自托管上的集合运行（配合个人访问令牌等）。须注意 CLI 为 alpha，且 Node.js 版本要满足最低 v22（或按文档使用 v0.26.0 与旧应用组合）。

和 Apidog、Thunder Client 比如何？

事实未提供与 Apidog、Thunder Client 的逐项官方对比。对 hoppscotch 可确认的是：开源生态、多协议、Web/桌面/CLI、云与自托管、MIT 社区版等。与其他工具比较时，建议用「协议支持、部署模型、协作与许可」同一组标准自行对照各家官网。

商业支持怎么买？

Enterprise Edition 自托管标价为 19 美元/用户/月（按月计费），含优先支持等，并可预约演示申请 free trial。Enterprise Cloud 在 2026.9.0 发布说明中强调 Dedicated Support 等能力。采购与账单处理涉及 Stripe 等支付方；以官方销售/定价流程为准。

hoppscotch 官网与相关入口

官网：https://hoppscotch.io — 产品入口与 Web 客户端
文档：https://docs.hoppscotch.io/documentation/getting-started/introduction.md — 介绍与入门
快速开始：https://docs.hoppscotch.io/documentation/getting-started/quick-start.md — Cloud / 社区版 / 企业版差异
自托管说明：https://docs.hoppscotch.io/documentation/self-host/getting-started.md — 社区版与企业版自托管对照
GitHub：https://github.com/hoppscotch/hoppscotch — 源码、发行说明、许可证与 issue
CLI 文档：https://docs.hoppscotch.io/documentation/clients/cli/overview.md — 安装与 hopp test
客户端总览：https://docs.hoppscotch.io/documentation/getting-started/clients.md — Web / 桌面 / CLI / MCP
许可证说明：https://docs.hoppscotch.io/support/license.md — MIT 条款摘要
隐私政策：https://docs.hoppscotch.io/support/privacy.md — 数据与 AI 合作说明
安全政策：https://docs.hoppscotch.io/support/security-policy.md — 沙箱、限流与漏洞报告方式

本文信息核对至 2026 年 10 月(hoppscotch 2026.9.0)。价格与限制以官方页面为准。

hoppscotch：开源 API 生态，轻量可自托管

项目体检