Hoppscotch - 開源 API 開發生態系統

解決什麼

Hoppscotch 針對開發者在 API 除錯過程中遇到的工具臃腫、資料隱私擔憂和跨平臺需求問題提供解決方案。傳統商業工具如 Postman 近年來功能膨脹、強制登入且資料儲存在雲端,Insomnia 被 Kong 收購後也走向企業化路線。Hoppscotch 提供輕量級的純 Web 體驗,支援完全離線使用或私有部署,讓開發者掌控自己的 API 測試資料。同時支援 REST、GraphQL、WebSocket、Server-Sent Events、Socket.IO 和 MQTT 等多種協議,覆蓋現代 API 開發的全場景需求。

為何火

專案在 GitHub 獲得近 8 萬星,主要因為踩中了開發者對商業工具"反噬"的痛點。Postman 從輕量工具演變為重度企業產品,Insomnia 被收購後社群版維護停滯,開發者急需可控的替代方案。Hoppscotch 的 PWA 架構讓它可以直接在瀏覽器執行無需安裝,同時提供桌面版和 CLI 滿足不同場景。MIT 協議允許企業自由修改和私有部署,加上活躍的社群維護(350位貢獻者、2天前還在更新),使其成為當前最受關注的開源 API 客戶端之一。

核心功能

支援完整的 HTTP 方法集(GET/POST/PUT/PATCH/DELETE 及自定義方法),內建程式碼生成器可匯出 10+ 種語言的請求程式碼。GraphQL 功能包含 schema 自動獲取和多列文件展示。即時協議方面覆蓋 WebSocket、SSE、Socket.IO 和 MQTT。認證支援 Basic、Bearer、OAuth 2.0 和 OIDC PKCE。請求歷史和集合管理支援雲同步或本地儲存,集合可匯出為檔案或 GitHub Gist。Pre-Request Scripts 允許執行 JavaScript 程式碼動態修改請求。團隊功能提供基於角色的許可權控制和共享集合,工作區機制支援多專案管理。內建代理模式解決 CORS 問題和訪問 HTTP 端點。

安裝

推薦使用 Docker Compose 部署。克隆倉庫後複製 .env.example 為 .env,修改 DATABASE_URL 和 DATA_ENCRYPTION_KEY(必須 32 字元)。執行 docker compose --profile default up 啟動完整服務(含 PostgreSQL)。前端訪問 http://localhost:3000,後端 API 在 http://localhost:3170,管理面板在 http://localhost:3100。若已有外部資料庫可用 --profile default-no-db。開發者可用 --profile just-backend 僅啟動後端服務。也可訪問官方託管版 hoppscotch.io 直接使用,但資料儲存在其伺服器。桌面版和 CLI 工具需單獨下載安裝包。

適合誰

個人開發者可用 PWA 版本快速除錯 API 無需安裝,離線可用且資源佔用低。需要資料隱私的團隊適合私有部署,所有請求記錄和集合留在內網。前端開發者受益於 CORS 代理功能,後端開發者可用 Pre-Request Scripts 自動化測試流程。小型團隊可利用免費的協作功能共享集合,大型企業可基於 MIT 協議定製開發。不適合需要複雜 API 監控和效能分析的場景,Hoppscotch 聚焦在請求構建和除錯環節,缺少 Postman 的高階監控功能。

社群評價

HN 討論(177 點贊 126 評論)顯示開發者對開源 API 客戶端的強烈需求。有使用者從 Insomnia 開源分支 Insomnium 遷移而來,因後者已停止維護。爭議點在於行業工具的頻繁變動:Insomnia 創始人賣給 Kong 後又推出新專案 Yaak,引發關於競業協議的討論,有評論認為 Kong 當初收購是為了控制敘事並將開發者導向其企業產品。部分使用者提到"行業已轉向 Bruno",但 Bruno 最近取消終身版改為訂閱制($6-11/月)引發不滿。正面觀點認為 Hoppscotch 的 PWA 架構和自託管能力是核心優勢,負面聲音指出 744 個未解決 issue 顯示專案維護壓力大。有開發者表示仍在用 HTTPie CLI 或 curl,質疑 GUI 工具過度商業化的必要性。

選型對比

對比 Postman:Hoppscotch 更輕量(PWA 架構 vs Electron 桌面應用),完全開源可私有部署,但缺少 Postman 的 API 監控、Mock Server 和自動化測試套件。Postman 團隊協作功能更成熟,Hoppscotch 的團隊功能仍在完善。對比 Insomnia:兩者都支援 GraphQL 和多協議,但 Insomnia 社群版已停滯,Hoppscotch 維護更活躍。對比 Bruno:Bruno 主打本地優先(Git 同步集合),Hoppscotch 提供雲同步和自託管兩種模式。Bruno 最近商業化引爭議,Hoppscotch 的 MIT 協議更寬鬆。技術棧上 Hoppscotch 用 Vue 生態,Bruno 基於 Electron,前者 PWA 版本更省資源。

已知坑

官方代理伺服器 proxy.hoppscotch.io 在中國大陸可能需要梯子,建議參考 Proxyscotch 專案自建代理。Docker 部署時 DATA_ENCRYPTION_KEY 必須嚴格 32 字元否則啟動失敗。團隊功能需要配置身份認證提供商(如 Google/GitHub OAuth),文件中配置項較多容易遺漏。744 個 open issues 表明部分邊緣功能可能有 bug,生產環境使用前建議充分測試。集合匯入匯出與 Postman 格式不完全相容,複雜集合遷移可能需要手動調整。WebSocket 和 MQTT 功能相對 REST API 測試較少,穩定性需驗證。PWA 版本在某些瀏覽器(如舊版 Safari)可能功能受限,建議用 Chrome/Edge 或桌面版。