在管理 Elasticsearch 和 OpenSearch 集群时，开发者往往需要在庞大的 Web 控制台和零碎的终端脚本之间来回切换。 Kabanos 是一款专为 macOS 打造的本地优先（Local-First）桌面客户端，旨在解决这一运维与开发痛点 。
为什么需要一款新的搜索数据库客户端？
在调试生产集群、检查映射字段或构建多阶段聚合管道时，传统的 Web 界面通常存在几个普遍问题：
- 凭据安全隐患：在 Web 控制台或跨环境配置中，敏感凭据容易泄露或需要重复输入。
- 生产环境误操作风险：在缺乏防护的控制台中直接运行修改请求，容易引发意外删库或错误批量更新。
- 工具链碎片化：在文档浏览器与 HTTP 原始控制台之间频繁切换，打断开发者的专注流。
Kabanos 结合了 MongoDB Compass 的结构化导航体验 与 Kibana Dev Tools 控制台的高效执行能力，并辅以 macOS 原生安全机制。
核心功能与技术亮点
1. Compass 式树状浏览与 Kibana 智能控制台
Kabanos 将集群资源整理为清晰可筛选的树状视图，可以直观查看索引、数据流、别名和模板。查询工作区采用熟悉的 Kibana 控制台语法，内置基于 Elasticsearch 官方 API 规范的自动补全功能。
2. 本地优先安全与生产防护
安全控制在 Electron 主进程中强制执行：
- Keychain 原生加密 ：凭据和环境变量通过 macOS Keychain (
safeStorage) 加密，绝不会以明文形式写入磁盘或渲染进程日志。 - 生产环境二次确认：标记为"Production"的连接将显示警告横幅，并在执行写操作前触发系统级确认提示。
- 只读模式（Read-Only Mode）：直接在主进程拦截所有写入与危险请求。
3. 自动化 Routines 与强检索查询库
Kabanos 提供带嵌套文件夹、标签和 SQLite FTS5 全文搜索（⌘F）的查询库 。对于多步骤运维工作流，Routines 支持：
- 使用
{``{steps.<id>.<name>}}变量进行请求链式传递。 - 通过沙盒化
jsonata表达式进行响应断言与repeat-until轮询。 - 提供安全**试运行（Dry Run）**模式，在执行写操作前验证只读步骤。
4. 沙盒化进程架构
Kabanos 的 React 渲染进程运行在沙盒环境中，通过基于 Zod 校验的 IPC 通道与 Electron 主进程通信。网络请求、AWS SigV4 签名和 SSH 隧道均在主进程执行，实现凭据与渲染层的严格隔离。
快速上手指南（Quickstart）
环境要求
在本地构建和运行 Kabanos，需要满足以下前置条件：
- macOS 13+
- Node.js v22 （建议使用
nvm） - pnpm 包管理器
- Docker & Docker Compose（用于本地测试集群）
第一步：克隆仓库与安装依赖
# 克隆 Git 仓库 [16]
git clone https://github.com/vanunu1987/kabanos.git
cd kabanos
# 安装依赖项 [16]
pnpm install第二步：启动本地测试集群
Kabanos 提供了现成的 Docker Compose 配置，可一键启动 Elasticsearch 8、Elasticsearch 9 和 OpenSearch 2 集群：
# 启动本地 Docker 测试集群 [16]
pnpm clusters:up
# 初始化测试索引、数据流与别名 [16]
pnpm clusters:seed第三步：启动开发版桌面应用
pnpm dev启动后，可使用预设的本地端点连接测试集群：
- Elasticsearch 9 :
http://elastic:sift-dev-pass@localhost:9202
总结与社区参与
Kabanos 将结构化索引浏览、原始控制台调试和自动化请求工作流整合进一个安全的桌面端应用中。
- 项目开源地址 ：访问 GitHub 仓库 vanunu1987/kabanos 查看完整源码与架构说明。
- 参与贡献：欢迎提交 Issue、PR 或参与 OpenSearch 与 Elasticsearch 多版本兼容性测试。
下载
你可以在地址下载 kabanos --- a native Mac client for Elasticsearch & OpenSearch
