API调试、设计、mock全搞定，这个开源客户端拿下了38k Star

API调试、设计、mock全搞定，这个开源客户端拿下了38k Star

Kong 开源的 API 客户端 Insomnia，在 GitHub 上拿下了 38k+ Star：

Insomnia 是 Kong 推出的一款开源桌面 API 客户端，支持 Mac、Windows 和 Linux 三大平台。

它的协议覆盖范围很广：GraphQL、REST、WebSockets、SSE（Server-Sent Events）、gRPC，以及任何兼容 HTTP 的协议。

核心能力

Insomnia 覆盖了 API 从调试到测试再到 mock 的完整链路：

• 调试 API：在图形界面中构造请求、查看响应，支持多种协议和格式。
• 设计 API：内置 OpenAPI 编辑器，可直接在工具内完成接口设计，支持可视化预览。
• 测试 API：提供测试套件和集合运行器，可编写自动化测试并批量执行。
• 模拟 API：通过云端或自建 Mock 服务器，在接口写好之前提供模拟数据。
• CI/CD 集成：提供命令行工具 Insomnia CLI，可在流水线中进行接口检查和自动化测试。
• 插件扩展：支持第三方插件，可在 Plugin Hub 中搜索和安装。

三种存储方式，按项目自由组合

Insomnia 的数据存储设计给了用户充分的自由度：

• Local Vault（本地存储）：所有资源 100% 存储在本地，不需要联网，数据不上传。
• Git Sync（Git 同步）：通过任意的 Git 仓库同步数据，不经过 Insomnia 云端。
• Cloud Sync（云端同步）：存储在 Insomnia 云端，支持团队协作，可开启端到端加密（E2EE）。

这三种方式可以混合使用。比如敏感项目的数据放在本地或 Git 仓库，同时将其他项目同步到云端与团队共享。Private Environments 功能进一步保证了环境变量始终存储在本地，与项目选择的存储方式无关。

上手简单，免费版足够日常使用

Insomnia 提供 Scratch Pad（草稿本）模式，不需要注册账号，所有数据存在本地，离线也能用。

如果需要云端同步、Git 同步、无限协作等功能，注册账号后可按需升级订阅方案。免费版对大多数个人开发者来说已经够用。

开发者可自行编译和扩展

Insomnia 基于 Node.js 开发，采用 monorepo 结构。克隆仓库后，在三大桌面平台上都可以进行二次开发：

# 安装依赖
npm i

# 运行测试
npm test

# 启动应用（热重载）
npm run dev

Insomnia 还提供了独立的 Inso CLI 命令行工具，专用于 CI/CD 场景：

npm i
npm run inso-start
./packages/insomnia-inso/bin/inso -v

社区生态

围绕 Insomnia 有一些实用的社区项目：

• Insomnia Documenter：根据 Insomnia 导出文件生成 API 文档页面。
• GitHub API Spec Importer：一套完整的 GitHub REST API 路由规范，可直接导入 Insomnia 使用。
• Swaggymnia：根据 Insomnia 的 API 定义生成 Swagger 文档。

Insomnia 使用 Apache 2.0 开源协议。