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 生態，輕量可自託管

项目体检