Cerebro：开源 Elasticsearch Web 管理工具 #

Cerebro 是什么？ #

Cerebro 是一款开源的 Elasticsearch Web 管理工具（Web Admin Tool），让你直接在浏览器中查看和管理 Elasticsearch 集群。它使用 Scala、Play Framework、AngularJS 与 Bootstrap 构建，遵循 MIT 开源协议，在 GitHub 上已获得 5.6k+ Star。

对于 Elasticsearch 的日常运维与排障来说，命令行里的 _cat 接口和 JSON 返回往往不够直观。Cerebro 把这些能力搬进了图形界面：集群健康度、节点负载、索引与分片分布、别名映射、分片路由调整、REST 查询等操作都可以在同一个控制台完成。它启动轻量、依赖简单（只需 Java 11 或更新版本），适合开发、测试与中小规模生产环境的集群管理与监控。

Cerebro 有哪些亮点特色？ #

• 开箱即用的 Web 控制台：只需 Java 11+ 即可运行，执行 bin/cerebro 后访问 http://localhost:9000 就能开始管理集群，无需额外部署服务端组件。
• 集群状态一目了然：以图形化方式展示集群健康状态、节点数量、索引与分片分布，帮助运维人员快速定位红色 / 黄色健康状态背后的异常节点。
• 索引与分片精细管理：支持查看索引详情、调整分片路由（reroute）、管理别名，常用于分片再均衡与故障恢复场景。
• 多集群自由切换：可在界面中输入任意 Elasticsearch 节点地址进行连接与切换，方便同时维护开发、测试、生产等多套集群。
• 企业级认证支持：内置 LDAP 认证配置能力，可通过环境变量（AUTH_TYPE=ldap、LDAP_URL、LDAP_BIND_DN 等）接入现有目录服务，满足团队协作下的权限管控需求。
• 多种部署方式：除官方压缩包外，还提供 Docker 官方镜像与 Windows Chocolatey 包（choco install cerebro-es），可无缝融入现有容器化或 Windows 运维体系。
• 灵活的配置项：支持通过启动参数修改监听地址与端口（如 -Dhttp.port=1234 -Dhttp.address=127.0.0.1），也可通过 conf/application.conf 或 -Dconfig.file 指定外部配置文件。
• MIT 开源、社区活跃：项目拥有 5.6k+ Star、733 次 Fork、430 次提交，采用 MIT 许可证，可自由用于商业环境并按需二次开发。

免费下载 Cerebro #

以下为官方提供的安装包，点击链接即可下载。

更多历史版本与各平台安装包可前往官方 Releases 页面获取：https://github.com/lmenezes/cerebro/releases

Cerebro 如何使用？ #

Cerebro 的使用流程非常直接，基本可以概括为「启动 → 连接 → 查看 → 操作」四步：

1. 启动服务。解压下载的安装包后，在命令行中执行 bin/cerebro（Windows 下执行 bin/cerebro.bat）。如果通过 Chocolatey 安装，Cerebro 会作为名为 cerebro 的 Windows 服务自动运行。
2. 打开浏览器访问。默认地址为 http://localhost:9000，如需更换监听地址与端口，可在启动时追加参数，例如 bin/cerebro -Dhttp.port=1234 -Dhttp.address=127.0.0.1。
3. 连接 Elasticsearch 集群。在首页的节点地址输入框中填写 Elasticsearch 节点地址（如 http://localhost:9200），点击连接即可进入控制台。Cerebro 支持保存多个节点地址，方便在多个集群之间快速切换。
4. 浏览与操作。进入主界面后，可以通过顶部导航切换不同功能模块，查看集群概览（Overview）、节点（Nodes）、索引（Indexes）、分片（Shards）、别名（Aliases）、分析器（Analyze）等信息。
5. 执行高级操作。在界面上可以创建新索引、修改索引设置、进行分片路由调整、管理别名，或通过 REST 面板直接提交任意 Elasticsearch API 请求；底部的日志面板还会记录你的操作历史，便于回溯。

配置提示：如需启用 LDAP 登录，可将 AUTH_TYPE 设为 ldap，并配置 LDAP_URL、LDAP_BASE_DN、LDAP_METHOD、LDAP_USER_TEMPLATE、LDAP_BIND_DN、LDAP_BIND_PWD 等环境变量。使用 Docker 时可以直接通过 --env-file 传入整个配置文件：

docker run -p 9000:9000 --env-file env-ldap lmenezes/cerebro

其他设置项则集中存放在应用目录下的 conf/application.conf 中，也可以通过 bin/cerebro -Dconfig.file=/some/other/dir/alternate.conf 指定外部配置文件。官方在仓库的 examples 目录中提供了若干配置示例，可直接参考。

Cerebro 的常见问题？ #

Cerebro 和 Kibana 有什么区别？ Kibana 更偏向日志检索、可视化与数据分析，功能全面但部署较重；Cerebro 定位为轻量级的集群管理工具，聚焦集群健康、节点、索引、分片与别名管理，界面简洁、资源占用低。两者可以共存，很多团队会同时使用 Kibana 做数据分析、用 Cerebro 做集群运维。

运行 Cerebro 需要什么环境？ 根据官方说明，Cerebro 需要 Java 11 或更新版本才能运行。安装前请确认系统中已正确安装 Java 并配置好相关环境变量，否则启动脚本会报错。

如何修改默认的 9000 端口？ 可以通过启动参数指定，例如 bin/cerebro -Dhttp.port=1234 -Dhttp.address=127.0.0.1，其中 -Dhttp.port 修改端口，-Dhttp.address 修改监听地址（默认 0.0.0.0:9000）。

Cerebro 支持 LDAP 登录吗？ 支持。通过环境变量即可开启：将 AUTH_TYPE 设为 ldap，然后配置 LDAP_URL、LDAP_BASE_DN、LDAP_METHOD、LDAP_USER_TEMPLATE 等参数。官方还提供了可选的组权限配置项（如 LDAP_GROUP_BASE_DN、LDAP_USER_ATTR、LDAP_GROUP），用于限制可访问的用户范围。

如何在 Docker 中运行 Cerebro？ 官方在 Docker Hub 提供了镜像 lmenezes/cerebro，直接执行 docker run -p 9000:9000 lmenezes/cerebro 即可启动，随后访问 http://localhost:9000。更多用法可参考官方的 cerebro-docker 仓库。

刷新页面后配置会丢失吗？ Cerebro 在浏览器本地保存你最近使用过的 Elasticsearch 节点地址，清空浏览器缓存或更换浏览器后需要重新填写。而服务端的端口、认证等设置均来自启动参数或 conf/application.conf，不会因为页面刷新而丢失。

Cerebro 如何安装？ #

Cerebro 是跨平台工具，只要能运行 Java 11+ 即可使用，各平台安装方式如下。

Windows #

方式一：压缩包安装（推荐）

1. 确认系统已安装 Java 11 或更新版本。
2. 下载 cerebro-0.9.4.zip 并解压到任意目录。
3. 进入解压后的目录，双击运行 bin\cerebro.bat，或在命令行中执行该脚本。
4. 打开浏览器访问 http://localhost:9000 即可开始使用。

方式二：Chocolatey 安装

1. 确保系统已安装 Chocolatey 包管理器。
2. 执行命令：choco install cerebro-es
3. 该包会自动创建名为 cerebro 的 Windows 服务。
4. 浏览器访问 http://localhost:9000。

macOS / Linux #

1. 确认系统已安装 Java 11 或更新版本（可通过 java -version 检查）。
2. 从官方 Releases 页面下载对应平台的压缩包（.zip 或 .tgz）。
3. 解压到目标目录，例如：tar -xzf cerebro-0.9.4.tgz -C /opt/。
4. 赋予启动脚本执行权限：chmod +x /opt/cerebro-0.9.4/bin/cerebro
5. 启动服务：/opt/cerebro-0.9.4/bin/cerebro
6. 浏览器访问 http://localhost:9000。

Docker #

1. 确保已安装 Docker。
2. 拉取并运行官方镜像：

docker run -p 9000:9000 lmenezes/cerebro

3. 如需传入 LDAP 等配置，可使用 --env-file 参数：

docker run -p 9000:9000 --env-file env-ldap lmenezes/cerebro

4. 浏览器访问 http://localhost:9000。

注意事项：若在服务器上部署，建议通过 -Dhttp.address=127.0.0.1 限制监听地址，再配合 Nginx 等反向代理对外提供服务，避免控制台直接暴露在公网。

Cerebro 如何卸载？ #

Cerebro 本身非常「绿色」，没有复杂的注册表写入或系统级组件，卸载过程相对简单。

Windows #

• Chocolatey 安装的版本：在管理员命令行中执行 choco uninstall cerebro-es，该命令会同时移除之前创建的 cerebro Windows 服务。
• 压缩包安装的版本：先停止正在运行的 Cerebro 进程（可在任务管理器中结束对应的 java 进程或关闭命令行窗口），然后直接删除解压后的整个目录即可。
• 残留清理：如果曾修改过 conf/application.conf，删除目录前建议备份该文件。此外浏览器中保存的集群连接记录需要在浏览器设置中手动清除。

macOS / Linux #

1. 停止正在运行的进程（使用 Ctrl + C 终止前台进程，或通过 ps -ef | grep cerebro 找到 PID 后用 kill 结束）。
2. 删除安装目录，例如：rm -rf /opt/cerebro-0.9.4/
3. 如果之前通过 systemd 等方式配置了开机自启，请一并删除对应的 service 文件并执行 systemctl daemon-reload。
4. 如有自定义的外部配置文件（通过 -Dconfig.file 指定），也请一并删除或归档。

Docker #

1. 停止并删除容器：

docker stop cerebro
docker rm cerebro

2. 如需一并删除镜像：

docker rmi lmenezes/cerebro

3. 若使用了 --env-file 传入配置文件，可自行决定是否保留该文件以备后续复用。