前言回顾

在上一篇文章《搭建持久化的 INFINI Console 与 Easysearch 容器环境》中，我们详细介绍了如何使用基础的 docker run 命令，手动启动和配置 INFINI Console (1.29.6) 和 INFINI Easysearch (1.13.0) 容器，并实现了关键数据的持久化，解决了重启后配置丢失的问题。

手动操作虽然能让我们深入理解 Docker 的核心机制，但在管理多个容器、网络和卷时，命令会变得冗长且容易出错。这时，Docker Compose 就派上了用场。它允许我们使用一个 YAML 文件来定义和运行多容器 Docker 应用程序。

本篇文章将演示如何将上一篇的手动步骤转换为使用 Docker Compose，让你更轻松地管理和维护这套本地开发测试环境。

Docker Compose 的优势

使用 Docker Compose 带来了诸多好处：

• 声明式配置：在一个 docker-compose.yml 文件中定义所有服务、网络和卷，清晰明了。
• 一键式管理：使用简单的命令（如 docker compose up, docker compose down）即可启动、停止和重建整个应用环境。
• 简化网络和服务连接：Compose 会自动处理服务间的网络设置和依赖关系。
• 易于共享和版本控制：docker-compose.yml 文件可以轻松地与团队共享并通过版本控制系统（如 Git）进行管理。

准备工作

与上一篇类似，你需要：

• 操作系统: macOS (本文示例)
• Docker 环境: OrbStack (https://orbstack.dev/) 或 Docker Desktop for Mac。
• 确保 Docker Compose V2 (docker compose) 或 V1 (docker-compose) 已安装并可用。

查看 docker compose 版本

docker compose version
Docker Compose version v2.24.5

步骤一：项目目录结构

我们将继续使用上一篇文章中创建的目录结构。如果你还没有创建，或者想重新开始，可以在你的项目根目录（例如 ~/infini_compose_lab）下创建如下结构：

# 1. 创建项目根目录
mkdir -p ~/infini_compose_lab
cd ~/infini_compose_lab

# 2. 为 Console 和 Easysearch 创建持久化子目录
# 这些目录将用于存储配置、数据和日志
mkdir -p console/config console/data console/logs
mkdir -p easysearch/config easysearch/data easysearch/logs

步骤二：提取初始配置文件

这一步与上一篇完全相同。你在首次启动时使用从镜像中提取的默认配置，请执行以下操作。如果这些目录中已存在配置文件（例如从上一篇博客的操作中保留下来的），Docker Compose 在挂载时会直接使用它们。

1. INFINI Console (1.29.6) 初始配置 (容器内配置路径: /config)

# 确保在 ~/infini_compose_lab 目录下
docker pull infinilabs/console:1.29.6
docker run --rm \
-v $PWD/console/config:/temp_host_config \
infinilabs/console:1.29.6 \
sh -c "cp -a /config/. /temp_host_config/ && chmod -R ugo+rw /temp_host_config/"

2. INFINI Easysearch (1.13.0) 初始配置 (容器内配置路径: /app/easysearch/config，初始密码: INFINILabs01)

重要提示：请务必为 Easysearch 设置安全的密码。

# 确保在 ~/infini_compose_lab 目录下
docker pull infinilabs/easysearch:1.13.0
docker run --rm \
-e EASYSEARCH_INITIAL_ADMIN_PASSWORD="INFINILabs01" \
-v $PWD/easysearch/config:/temp_host_config \
infinilabs/easysearch:1.13.0 \
sh -c "cp -a /app/easysearch/config/. /temp_host_config/ && chmod -R ugo+rw /temp_host_config/"

步骤三：创建 docker-compose.yml 文件

这是核心步骤。在你的项目根目录 ~/infini_compose_lab 下，创建一个名为 docker-compose.yml 的文件，并填入以下内容。这个文件定义了我们的服务、它们如何运行以及它们如何交互。

cat <<EOF > docker-compose.yml
services:
  easysearch:
    image: infinilabs/easysearch:1.13.0
    container_name: infini-easysearch
    environment:
      - cluster.name=infini_compose_cluster
      - node.name=node-01
      - cluster.initial_master_nodes=node-01
      - "ES_JAVA_OPTS=-Xms1g -Xmx1g"
      - EASYSEARCH_INITIAL_ADMIN_PASSWORD=INFINILabs01
    ports:
      - "9200:9200"
      - "9300:9300"
    volumes:
      - ./easysearch/config:/app/easysearch/config
      - ./easysearch/data:/app/easysearch/data
      - ./easysearch/logs:/app/easysearch/logs
    ulimits:
      memlock: {soft: -1, hard: -1}
      nofile: {soft: 65536, hard: 65536}
    networks:
      - infini_app_net

  console:
    image: infinilabs/console:1.29.6
    container_name: infini-console
    ports:
      - "9000:9000"
    volumes:
      - ./console/config:/config
      - ./console/data:/data
      - ./console/logs:/log
    networks:
      - infini_app_net

networks:
  infini_app_net:
    driver: bridge
EOF

docker-compose.yml 文件关键点：

• services: 定义了 easysearch 和 console 两个服务。
• image: 指定了每个服务使用的 Docker 镜像和版本。
• container_name: 为容器指定一个易于识别的名称。
• environment: 设置容器的环境变量。
• Easysearch 单节点配置: 注意 cluster.initial_master_nodes 设置为节点自身的名称。
• ports: 将容器的端口映射到宿主机的端口。
• volumes: 实现持久化的核心。将宿主机当前目录 (./) 下的 console/* 和 easysearch/* 子目录分别映射到容器内对应的路径。
• networks: 将两个服务都连接到我们定义的 infini_app_net 网络。这使得 console 服务可以通过服务名 easysearch (例如 https://easysearch:9200) 来访问 easysearch 服务。

步骤四：使用 Docker Compose 启动环境

现在，所有配置都在 docker-compose.yml 文件中了。启动整个环境只需要一条命令。 在 ~/infini_compose_lab 目录下（包含 docker-compose.yml 文件），执行：

docker compose up -d

• docker compose (V2) 或 docker-compose (V1)。
• up: 创建并启动在 docker-compose.yml 中定义的所有服务。
• -d: 后台模式运行。

首次运行时，如果本地没有对应的镜像，Docker Compose 会自动拉取。

常用 Docker Compose 命令：

• 查看服务状态：

docker compose ps

• 查看所有服务的实时日志：

docker compose logs -f

• 查看特定服务的日志：

docker compose logs -f console
docker compose logs -f easysearch

• 停止所有服务（保留数据）：

docker compose stop

• 停止并移除所有容器、网络和匿名卷（保留通过 volumes 映射的本地数据）：

docker compose down

步骤五：验证和使用

1. 访问 Console: 浏览器打开 http://localhost:9000。
2. 进行配置: 在 Console 中连接 Easysearch (https://easysearch:9200，因为它们在同一个 Docker 网络中，可以直接使用服务名)，创建用户，查看监控等。
3. 测试持久化:

docker compose down # 停止并移除容器
# 稍等片刻
docker compose up -d # 重新启动

再次访问 http://localhost:9000，你会发现之前的配置都还在！

操作截图

彻底清理，包括删除命名卷（如果使用了的话）和本地数据(可选)

# -v 移除命名卷
docker compose down -v
# 然后手动删除本地持久化目录
rm -rf ~/infini_compose_lab/console
rm -rf ~/infini_compose_lab/easysearch

总结

通过 Docker Compose，我们用一个简洁的 docker-compose.yml 文件取代了之前冗长的 docker run 命令，极大地简化了 INFINI Console 和 Easysearch 本地环境的搭建和管理过程。同时，通过正确的卷挂载配置，我们依然确保了数据的持久化，解决了重启后配置丢失的问题。

对于开发、测试和快速原型验证，Docker Compose 无疑是一个强大而高效的工具。希望本教程能帮助你更轻松地使用 INFINI Console 进行本地实验和开发！

关于 INFINI Console

INFINI Console 是一款开源的非常轻量级的多集群、跨版本的搜索基础设施统一管控平台。通过对流行的搜索引擎基础设施进行跨版本、多集群的集中纳管，企业可以快速方便的统一管理企业内部的不同版本的多套搜索集群。INFINI Console 还可以对集群内的索引及数据进行操作管理，可以配置灵活的告警规则，可以指定统一的安全策略，可以查看各个维度的日志和审计信息，真正实现企业级的搜索服务平台化建设和运营。

官网文档：https://docs.infinilabs.com/console/main/
开源地址：https://github.com/infinilabs/console

作者：罗厚付，极限科技（INFINI Labs）云上产品设计与研发负责人，拥有多年安全风控及大数据系统架构经验，主导过多个核心产品的设计与落地，日常负责运维超大规模 ES 集群（800+节点/1PB+数据）。
原文：https://infinilabs.cn/blog/2025/console-easysearch-with-docker-compose/

背景介绍

许多用户在使用 Docker 部署 INFINI Console（本文使用 1.29.6 版本）时，可能会遇到一个常见问题：重启容器后，之前在 INFINI Console 中所连接的系统集群配置会丢失。这个问题通常源于未能正确配置 Docker 的数据持久化。原本通过 Docker 运行 INFINI Console 只是一个简单的测试示例，并未考虑多次重启使用，现官方文档也进行了更新，参考：容器部署

接下来我们本地测试一下。

理解核心问题：Docker 容器与数据持久化

默认情况下，Docker 容器的文件系统是临时的。当容器被停止并删除后，容器内部所做的任何未被持久化的更改都会丢失。INFINI Console 的配置存储在其容器内部的特定目录中。为了在容器重启或重建后保留这些信息，我们必须将这些关键目录映射到宿主机（你的电脑）上的持久化存储位置。

准备工作

• 操作系统: macOS (本文示例)
• Docker 环境: OrbStack (https://orbstack.dev/) 或 Docker Desktop for Mac。

请确保 Docker 服务已启动并正常运行。你可以通过在终端执行 docker --version 来验证。

docker --version
Docker version 25.0.5, build 5dc9bcc

步骤一：创建本地持久化目录和自定义 Docker 网络

首先，在宿主机上为 Console 和 Easysearch 创建用于存储配置、数据和日志的目录。同时，创建一个自定义 Docker 网络，以便容器之间可以通过名称进行通信。

# 1. 创建项目根目录和各个服务的持久化子目录
mkdir -p ~/infini_manual_setup/console/config ~/infini_manual_setup/console/data ~/infini_manual_setup/console/logs
mkdir -p ~/infini_manual_setup/easysearch/config ~/infini_manual_setup/easysearch/data ~/infini_manual_setup/easysearch/logs
cd ~/infini_manual_setup

# 2. 创建一个自定义的 Docker 桥接网络
docker network create infini_app_net

• infini_app_net 是我们为这两个容器创建的自定义网络名称。

步骤二：提取初始配置文件

为了方便首次启动和后续自定义，我们需要从官方 Docker 镜像中提取默认的配置文件到我们本地创建的持久化目录中。

1. INFINI Console (1.29.6) 初始配置 根据 INFINI Console 官方 Docker 文档，其容器内配置文件位于 /config。

docker pull infinilabs/console:1.29.6
docker run --rm \
    -v $PWD/console/config:/temp_host_config \
    infinilabs/console:1.29.6 \
    sh -c "cp -a /config/. /temp_host_config/ && chmod -R ugo+rw /temp_host_config/"

2. INFINI Easysearch (1.13.0) 初始配置 INFINI Easysearch 镜像内部的配置文件位于 /app/easysearch/config，并且需要初始管理员密码 INFINILabs01。

重要提示：请务必为 Easysearch 设置安全的密码。

docker pull infinilabs/easysearch:1.13.0
docker run --rm \
    -e EASYSEARCH_INITIAL_ADMIN_PASSWORD="INFINILabs01" \
    -v $PWD/easysearch/config:/temp_host_config \
    infinilabs/easysearch:1.13.0 \
    sh -c "cp -a /app/easysearch/config/. /temp_host_config/ && chmod -R ugo+rw /temp_host_config/"

现在，你的本地 console/config 和 easysearch/config 目录应该包含了初始配置文件。

检查目录如下

tree -L 3 .
.
├── console
│   ├── config
│   │   ├── install_agent.tpl
│   │   ├── permission.json
│   │   ├── setup
│   │   └── system_config.tpl
│   ├── data
│   └── logs
└── easysearch
    ├── config
    │   ├── admin.crt
    │   ├── admin.key
    │   ├── analysis-ik
    │   ├── ca.crt
    │   ├── ca.key
    │   ├── easysearch.yml
    │   ├── easysearch.yml.example
    │   ├── instance.crt
    │   ├── instance.key
    │   ├── jvm.options
    │   ├── jvm.options.d
    │   ├── log4j2.properties
    │   └── security
    ├── data
    └── logs

步骤三：手动运行 INFINI Easysearch 容器

使用 docker run 命令启动 Easysearch，并配置端口映射、环境变量和最重要的——卷挂载。

docker run -d \
--name easysearch01 \
--network infini_app_net \
-p 9200:9200 \
-p 9300:9300 \
-e cluster.name="infini_local_cluster" \
-e node.name="easysearch-node01" \
-e cluster.initial_master_nodes="easysearch-node01" \
-e "ES_JAVA_OPTS=-Xms1g -Xmx1g" \
-e EASYSEARCH_INITIAL_ADMIN_PASSWORD="INFINILabs01" \
-v $PWD/easysearch/config:/app/easysearch/config \
-v $PWD/easysearch/data:/app/easysearch/data \
-v $PWD/easysearch/logs:/app/easysearch/logs \
--ulimit memlock=-1:-1 \
--ulimit nofile=65536:65536 \
infinilabs/easysearch:1.13.0

关键参数解释：

• --name easysearch01: 为容器指定一个名称。
• --network infini_app_net: 连接到自定义网络。
• -p HOST_PORT:CONTAINER_PORT: 端口映射。
• -e VARIABLE=VALUE: 设置环境变量。
• -v $PWD/host/path:/container/path: 实现持久化的核心。将宿主机当前工作目录 ($PWD) 下的子目录映射到容器内的指定路径。

步骤四：手动运行 INFINI Console 容器

现在启动 Console 容器，同样配置网络、端口、环境变量和卷挂载。

docker run -d \
--name console01 \
--network infini_app_net \
-p 9000:9000 \
-v $PWD/console/config:/config \
-v $PWD/console/data:/data \
-v $PWD/console/logs:/log \
infinilabs/console:1.29.6

查看日志

docker logs -f easysearch01
docker logs -f console01

步骤五：验证服务和持久化

1. 检查容器状态: docker ps (应能看到 easysearch01 和 console01)。
2. 访问 Console: 浏览器打开 http://localhost:9000。
3. 在 Console 中进行初始化配置
4. 测试持久化 (重启 Console 容器):

docker stop console01
docker rm console01
# 重新运行步骤四中启动 Console 的 docker run 命令 (确保所有参数一致)

操作截图

再次访问 Console: 打开 http://localhost:9000。如果一切正常，证明持久化成功。

步骤六：停止和清理(可选)

• 停止容器: docker stop console01 easysearch01
• 移除容器: docker rm console01 easysearch01
• 移除网络: docker network rm infini_app_net
• 移除本地持久化数据 (如果不再需要):

rm -rf ~/infini_manual_setup/console
rm -rf ~/infini_manual_setup/easysearch

总结

通过 docker run 命令并仔细配置卷挂载，我们成功地为 INFINI Console 和 Easysearch 构建了一个具有持久化能力的本地容器环境，有效解决了重启后配置丢失的问题。虽然手动操作参数较多，但它能让你更清晰地理解 Docker 的核心机制。

在后续的文章中，我们将探讨如何使用 Docker Compose 来简化这一过程。

关于 INFINI Console

INFINI Console 是一款开源的非常轻量级的多集群、跨版本的搜索基础设施统一管控平台。通过对流行的搜索引擎基础设施进行跨版本、多集群的集中纳管，企业可以快速方便的统一管理企业内部的不同版本的多套搜索集群。INFINI Console 还可以对集群内的索引及数据进行操作管理，可以配置灵活的告警规则，可以指定统一的安全策略，可以查看各个维度的日志和审计信息，真正实现企业级的搜索服务平台化建设和运营。

官网文档：https://docs.infinilabs.com/console/main/
开源地址：https://github.com/infinilabs/console

作者：罗厚付，极限科技（INFINI Labs）云上产品设计与研发负责人，拥有多年安全风控及大数据系统架构经验，主导过多个核心产品的设计与落地，日常负责运维超大规模 ES 集群（800+节点/1PB+数据）。
原文：https://infinilabs.cn/blog/2025/console-easysearch-with-docker/

INFINI Labs 产品更新发布！此次更新涵盖 Console 、Easysearch 等产品多项重要升级，重点优化监控图表异常毛刺。

• INFINI Easysearch v1.13.0 Rollup Job 支持自动更新操作索引 mapping 更新, 未完成 rollup 的源索引禁止被 ilm 进行清理。
• INFINI Console v1.29.6 系统集群新增 Rollup Gap 指标，修复监控图表异常毛刺、历史数据 top 索引查询指标异常等问题。

INFINI Easysearch v1.13.0

INFINI Easysearch 是一个分布式的搜索型数据库，实现非结构化数据检索、全文检索、向量检索、地理位置信息查询、组合索引查询、多语种支持、聚合分析等。Easysearch 可以完美替代 Elasticsearch，同时添加和完善多项企业级功能。Easysearch 助您拥有简洁、高效、易用的搜索体验。

Easysearch 本次更新如下：

功能更新

• Rollup 新增对已创建 job 的 interval 和 page_size 参数更新的 api
• Rollup 索引数据增加 unique 字段标识当前 job 的数据
• Rollup 配置增加 window_start_time 字段，当重建 Rollup 时 会把历史 metadata 的最新时间戳写到 window_start_time 里

问题修复

优化改进

• Rollup 会自动检测源数据索引是否有新增字段，并更新到 metrics
• ILM 删除索引时 增加对 Rollup 的运行状态判断，未处理完的索引不会删除

INFINI Console v1.29.6

INFINI Console 是一款开源的非常轻量级的多集群、跨版本的搜索基础设施统一管控平台。通过对流行的搜索引擎基础设施进行跨版本、多集群的集中纳管， 企业可以快速方便的统一管理企业内部的不同版本的多套搜索集群。

Console 在线体验：

http://demo.infini.cloud (用户名/密码：readonly/readonly)。

Console 本次更新如下：

功能更新

• 集群设置切换指标采集模式时增加确认操作
• 系统集群增加 Rollup 监控指标
• 监控页面支持查看 Rollup 处理进度

问题修复

• 修复告警详情页面查询事件记录时时间范围错误的问题
• 修复高级页面中索引 top 查询异常问题

优化改进

• 增强指标聚合功能
• 更新查询和过滤功能以支持范围
• 优化桶大小计算
• 数据探索默认展示图表

更多详情请查看以下详细的 Release Notes 或联系我们的技术支持团队！

• INFINI Easysearch
• INFINI Console
• INFINI Gateway
• INFINI Agent
• INFINI Loadgen
• INFINI Framework

期待反馈

欢迎下载体验使用，如果您在使用过程中遇到如何疑问或者问题，欢迎前往 INFINI Labs Github（https://github.com/infinilabs） 中的对应项目中提交 Feature Request 或提交 Bug。

下载地址： https://infinilabs.cn/download

邮件：hello@infini.ltd

电话：(+86) 400-139-9200

Discord：https://discord.gg/4tKTMkkvVX

也欢迎大家微信扫码添加小助手（INFINI-Labs），加入用户群一起讨论交流。

关于极限科技（INFINI Labs）

极限科技，全称极限数据（北京）科技有限公司，是一家专注于实时搜索与数据分析的软件公司。旗下品牌极限实验室（INFINI Labs）致力于打造极致易用的数据探索与分析体验。

极限科技是一支年轻的团队，采用天然分布式的方式来进行远程协作，员工分布在全球各地，希望通过努力成为中国乃至全球企业大数据实时搜索分析产品的首选，为中国技术品牌输出添砖加瓦。

官网：https://infinilabs.cn

INFINI Labs 产品更新发布！此次更新涵盖 Coco AI 产品多项重要升级，重点提升 AI 搜索能力、易用性及企业级优化。

• Coco AI v0.5 无缝集成 AI 搜索能力，支持第三方插件，新增 AI Command 快速访问 AI 能力，支持快照版本更新，优化交互细节，提升整体稳定性与用户体验等。
• Coco AI Server v0.5 强化 API 能力与安全性，完善小助手配置，支持多用户登录。

Coco AI v0.5

Coco AI 是一个完全开源、跨平台的统一 AI 搜索与效率工具，能够连接并搜索多种数据源，包括应用程序、文件、谷歌网盘、Notion、语雀、Hugo 等本地与云端数据。通过接入 DeepSeek 等大模型，Coco AI 实现了智能化的个人知识库管理，注重隐私，支持私有部署，帮助用户快速、智能地访问信息。

Coco AI 本次详细更新记录如下：

Coco AI 客户端 v0.5

功能更新

• 搜索模式支持快速 AI 访问
• 支持插件扩展
• 添加 AI 摘要组件
• 支持搜索二级页面
• 点击或回车关闭助手列表
• 为置顶窗口添加暗度设置
• 支持 Shift + Enter 输入框换行
• 支持快照版本更新
• 历史记录列表添加收起按钮
• 聊天输入框支持多行输入
• 将 ~/Applications 添加到搜索路径
• 聊天内容添加返回底部按钮
• 搜索输入框支持多行输入
• WebSocket 支持自签名 TLS
• 添加允许自签名证书选项
• 支持通过环境变量 COCO_LOG 动态设置日志级别
• 搜索结果重新排序

问题修复

• 修复为设置 API 添加缺失的 CORS 功能标志
• 修复数据源图标显示错误
• 修复处理 HugoSite 类型数据源中的空 URL 值
• 修复数据源和 MCP 选择问题
• 修复创建模型提供者时 crypto.randomUUID 的兼容性问题
• 修复服务器图像加载失败
• 修复在 Windows 系统上获取应用元数据时出现崩溃
• 修复服务切换错误
• 修复切换服务器助手后会话保持不变
• 修复历史列表高度的问题
• 修复二级页面无法被搜索到的问题
• 修复滚动按钮默认不显示
• 修复推荐列表位置
• 修复独立聊天窗口中没有数据的问题
• 修复继续聊天操作中的导航错误

优化改进

• 调整列表错误消息
• 修复解决在聊天中修改助手的问题
• 完善搜索失败的提示文案
• 搜索和 MCP 显示隐藏逻辑
• 问候语显示隐藏逻辑
• 重构实时获取设置中的应用列表
• UpdateApp 组件加载位置
• 添加清理监控和缓存计算以优化性能
• 重构优化代码
• 重构优化数字输入框的修改操作
• 修改搜索输入框样式
• 聊天输入图标显示
• 重构重构图标组件
• 重构优化 markdown 内容中的列表样式
• 添加文本朗读组件
• 历史组件样式
• 搜索错误样式
• 跳过未登录的注册服务器
• 重构服务信息相关组件
• 聊天内容可以被复制
• 重构修复搜索错误
• 添加助手消息计数
• 添加全局登录判断
• 在用户登出时标记服务器为离线状态
• 登出时更新服务器配置文件
• 小助手键盘事件和鼠标事件
• Web 组件起始页配置
• 小助手支持设置聊天输入占位符
• 重构输入框相关组件
• 在刷新信息时将不可用服务器标记为离线
• 在聊天模式中只显示可用服务器
• 重构搜索结果相关组件

Coco AI 服务端 v0.5

功能更新

• 支持将图标转换为 base64 格式
• 实现小助手问答 API
• 在聊天设置中添加占位符、分类和标签
• 在 provider info 中返回助手数量
• 添加小助手到搜索结果中
• 添加内置小助手 AI Overview
• 添加带有请求指纹的限流过滤器
• 多用户登录支持

问题修复

• 修复为设置 API 添加缺失的 CORS 功能标志
• 修复数据源图标显示错误
• 修复处理 HugoSite 类型数据源中的空 URL 值
• 修复数据源和 MCP 选择问题
• 修复创建模型提供者时 crypto.randomUUID 的兼容性问题
• 修复嵌入组件起始页配置不起效的问题

优化改进

• 清理未使用的 LLM 设置代码
• 按创建时间排序聊天历史
• 为小助手编辑添加默认启用参数
• 密码支持更多特殊字符
• 重构聊天 API
• 忽略空消息

更多详情请查看以下详细的 Release Notes 或联系我们的技术支持团队！

• Coco AI App
• Coco AI Server

期待反馈

欢迎下载体验使用，如果您在使用过程中遇到如何疑问或者问题，欢迎前往 INFINI Labs Github（https://github.com/infinilabs） 中的对应项目中提交 Feature Request 或提交 Bug。

下载地址： https://infinilabs.cn/download

邮件：hello@infini.ltd

电话：(+86) 400-139-9200

Discord：https://discord.gg/4tKTMkkvVX

也欢迎大家微信扫码添加小助手（INFINI-Labs），加入用户群一起讨论交流。

关于极限科技（INFINI Labs）

极限科技，全称极限数据（北京）科技有限公司，是一家专注于实时搜索与数据分析的软件公司。旗下品牌极限实验室（INFINI Labs）致力于打造极致易用的数据探索与分析体验。

极限科技是一支年轻的团队，采用天然分布式的方式来进行远程协作，员工分布在全球各地，希望通过努力成为中国乃至全球企业大数据实时搜索分析产品的首选，为中国技术品牌输出添砖加瓦。

官网：https://infinilabs.cn

在生成式 AI 快速演进的今天，企业如何构建智能、高效、安全的搜索与交互系统，已成为提升信息利用效率与用户体验的关键。本次 Workshop 聚焦于极限科技推出的 Coco AI —— 一款完全开源、跨平台的企业级智能搜索与助手系统，带您深入了解其核心能力、技术架构与落地实践。

无论您是希望提升组织内部搜索效率的 IT 管理者，构建智能化办公系统的产品/研发团队，还是关注 AI 技术落地的开发者与创业者，本次活动都将带来满满干货，是一次不可错过的学习与交流机会。

活动时间：2025 年 7 月 10 日 13:30 ～ 17:30
活动地点：#腾讯会议：453-275-417
报名链接：https://hdxu.cn/1ffb5

内容摘要

• 企业多源异构数据的统一搜索方案
• Coco AI 如何构建类 ChatGPT 式智能问答助手
• Demo 演示：Coco AI 实现企业内部文档语义搜索与智能对话
• 案例实战：用 Coco AI 打造 Elasticsearch 智能助手
• 开源生态如何推动 Coco AI 持续创新
• 下一代企业 AI 搜索的演进趋势与 Coco AI 路线图

关于 Coco AI

Coco AI - 为现代团队打造的统一搜索与 AI 智能助手

Coco AI 是一款完全开源、跨平台的企业级智能搜索与助手系统，专为现代企业打造。它通过统一搜索入口，连接企业内外部的异构数据源，融合大模型能力，帮助团队高效访问知识，智能决策协作。

现代企业的三大痛点：

1. 数据分散，信息孤岛严重 企业数据散落在本地文件系统、云存储（如 S3）、协作工具（如 Notion、Google Workspace）、知识平台（如语雀）、以及代码仓库（如 GitHub）等多个系统中。员工在多个平台之间频繁切换，导致信息获取效率低下，工作成本居高不下。

2. 数据敏感，安全与隐私风险高 企业数据往往涉及敏感信息，不适合上云或调用公有云的大模型服务。像豆包、纳米搜索、Kimi 等流行 AI 工具由于无法部署在本地，难以在企业环境中落地使用。

3. 数据沉睡，知识难以利用 企业多年积累的大量文档和资料，静静躺在角落却难以调用。传统知识管理依赖人工整理，效率低下，维护困难，知识资产无法真正发挥价值。

Coco AI 解决方案：

• 统一搜索入口，跨平台连接数据：支持连接本地与云端多种数据源，包括文件、协作平台、知识库、代码仓库等，一站式搜索和信息聚合。
• 私有化部署，保障数据安全：完全开源，自主可控，可私有部署，数据不出企业，满足高安全、高合规场景需求。
• 融合大模型，构建智能助手：接入 DeepSeek 等先进大模型，支持语义理解、自然语言问答、智能推荐，激活沉睡数据，打造真正“会思考”的企业知识中枢。

以下是 Coco AI 项目地址, 可以先睹为快, 欢迎 Star 转发分享~

项目主页：

• https://coco.rs

开源地址：

• https://github.com/infinilabs/coco-app
• https://github.com/infinilabs/coco-server

参会提示

• 请务必自备电脑；
• 如有任何疑问可添加 INFINI Labs 小助手（微信号: INFINI-Labs）进行联系

在日常运维 Easysearch 的过程中，备份数据是一项重要工作。为了确保数据安全和业务连续性，我们可能需要了解并掌握多种备份索引的方法，以便应对不同的场景。我们先梳理下常用的备份方法有哪些。

Snapshot

Easysearch 的 Snapshot（快照） 是一种官方支持的集群数据备份与恢复机制，通过将索引数据、集群状态（如设置、模板）和分片分配信息保存到外部存储仓库（如本地文件系统、AWS S3、华为云 OBS 等）实现全量或增量备份。其核心原理是复制索引的 Lucene 分片文件，并利用段文件（Segment）的不可变性实现增量存储优化。

快照的优点包括：

1. 高效性：增量备份仅存储新增或修改的段文件，显著节省存储空间和网络传输成本；
2. 可靠性：支持跨集群恢复和灾难性故障修复，避免直接拷贝数据目录导致的数据不一致风险；
3. 灵活性：可指定备份特定索引，并支持版本兼容性恢复（需遵循版本匹配规则）；
4. 自动化：通过策略（Snapshot Policy）实现定时备份管理。

缺点则包括：

1. 时效性限制：无法实现实时备份，是一种 PIT (Point in Time) 备份；
2. 需预先配置：需预先注册仓库并确保存储系统可用性；
3. 恢复约束：恢复时需关闭或删除目标索引，或恢复时修改索引名称；
4. 依赖主分片状态：若主分片不可用（如节点故障），快照任务会失败。

总体而言，Snapshot 是生产环境首选的备份方案，尤其适合大规模数据归档和跨环境迁移，但需权衡备份频率与存储成本。详情可以参考文档。

Reindex

Easysearch 的 Reindex 是一种通过 API 将数据从一个索引复制到另一个索引的备份方法，适用于同集群或跨集群的数据迁移与重建。其核心操作是使用 POST _reindex 命令将源索引的文档批量读取并写入目标索引。备份时需确保目标索引的 Mapping 与源索引兼容（字段类型一致），并通过 size 参数控制批量处理量（如 "size": 2000）以优化性能。对于跨集群备份，需在目标集群配置文件中添加源集群 IP 白名单（reindex.remote.whitelist）并提供认证信息，详情可以参考文档。

优点：

1. 灵活性：支持通过 query 参数筛选特定数据备份（如仅迁移某字段值符合条件的数据）；
2. 无缝整合：可在目标索引中修改索引结构（如分片数、字段类型）；
3. 并发及限流：支持设置并发度和限流阈值，适应不同的场景；
4. 操作便捷：无需额外存储配置，适合临时备份或小规模迁移。

缺点：

1. 资源消耗大：reindex 本质是数据写入，要占用 CPU、内存和磁盘 IO，可能影响集群性能；
2. 网络依赖：跨集群备份依赖网络带宽，高延迟或带宽不足会显著拖慢速度；
3. 中断风险：reindex 一旦中途报错，无法继续重试，只能从头再来；
4. 时效性局限：备份完成后新增数据需手动触发二次迁移，无法实现实时同步。

建议在低峰期执行 Reindex，并优先采用快照（Snapshot）进行生产环境长期备份，Reindex 更适合索引结构调整或小规模数据迁移场景。

工具备份

还有些工具支持将 Easyearch 的索引数据备份成一个文件，比如 elasticsearch-dump、Logstash 等。数据量较大的情况下，这些工具可能会有效率问题，一般在特定场景下有用，在此不展开介绍。

Clone API

Easysearch 的 Clone API 并不是传统意义上的备份工具，其核心设计目标是通过复制索引的底层段文件（Segment）快速生成一个与原索引数据一致的新索引，包括源索引是 Mapping 和 Setting 也一起复制。

具体操作步骤如下：

1. 设置源索引为只读状态

PUT /.infini_metrics-000004/_settings
{
  "settings": {
    "index.blocks.write": true
  }
}

1. 执行 Clone 操作

POST .infini_metrics-000004/_clone/backup_infini_metrics-000004

3. 设置源索引和新索引为可读写状态

复制是新索引也会是只可读状态，大家根据需要选择是否都改成可读写状态。

PUT /.infini_metrics-000004,backup_infini_metrics-000004/_settings
{
  "settings": {
    "index.blocks.write": null
  }
}

优点：

• 极速复制：直接复用底层段文件，无需重写数据，适用于大数据量快速复制。
• 保留定义: 直接使用源索引的 Setting 和 Mapping。
• 存储优化：可调整目标索引的副本数，节省资源。

缺点：

• 业务影响：克隆前需修改源索引为只可读，导致写入中断，影响服务可用性。
• 不够灵活：沿用源索引 Setting 和 Mapping 无法修改（副本数可修改）。
• 扩展性不足：不能跨集群，目标索引只能在本集群。

Clone API 有自己鲜明的特点，对比 Snapshot，它不用恢复过程，目标索引直接在集群中了。对比 Reindex，它无需重写数据和先创建索引，更加高效。在特定场景下非常有用，也可以搭配其他备份方法一起使用。

关于 Easysearch

INFINI Easysearch 是一个分布式的搜索型数据库，实现非结构化数据检索、全文检索、向量检索、地理位置信息查询、组合索引查询、多语种支持、聚合分析等。Easysearch 可以完美替代 Elasticsearch，同时添加和完善多项企业级功能。Easysearch 助您拥有简洁、高效、易用的搜索体验。

官网文档：https://docs.infinilabs.com/easysearch

作者：杨帆，极限科技（INFINI Labs）高级解决方案架构师、《老杨玩搜索》栏目 B 站 UP 主，拥有十余年金融行业服务工作经验，熟悉 Linux、数据库、网络等领域。目前主要从事 Easysearch、Elasticsearch 等搜索引擎的技术支持工作，服务国内私有化部署的客户。
原文：https://infinilabs.cn/blog/2025/easysearch-index-clone-api/