搜索客，搜索人自己的社区

Bboss v7.5.6 正式发布，全面兼容国产分布式搜索引擎 Easysearch

资讯动态 • INFINI Labs 小助手发表了文章 • 0 个评论 • 70 次浏览 • 7 小时前 • 来自相关话题

一、引言

2026 年 6 月 21 日，经过 Bboss 开源社区与极限科技（INFINI Labs）的紧密合作， [Bboss v7.5.6](https://esdoc.bbossgroups.com/ ... 260621) 正式发布！

作为国内领先的 AI 智能体开发框架、数据采集同步 ETL 工具以及流批一体化计算引擎，Bboss 在本次更新中与国产分布式搜索引擎 Easysearch 完成深度兼容，其 Elasticsearch Java 客户端 全面兼容 Easysearch 1.x、2.x 全系列版本。开发者现在可以无缝使用 Bboss 客户端操作 Easysearch 集群，享受与 Elasticsearch 一致的开发体验。

![](https://infinilabs.cn//img/blo ... /1.png)

二、Bboss Elasticsearch 客户端简介

Bboss 是一款高性能、高兼容性的搜索引擎 Java REST 客户端框架，基于 Apache License 2.0 开源，原生支持 Elasticsearch、Easysearch 和 Opensearch。

自带客户端集群节点负载均衡和容灾，多集群多数据源，自动索引托管，多种分页机制，傻瓜级 CRUD，脚本，SQL，JDBC，高亮，权重，聚合，IP，GEO 地理位置，父子嵌套，应有尽有。

核心特性

| 特性 | 说明 |
| ------------------ | --------------------------------------------------------------------- |
| 原生多引擎支持 | 完美支持 ES 1.x ~ 9.x、Easysearch 1.x ~ 2.x、Opensearch 1.x ~ 3.x |
| 学习成本低 | 无需学习额外 API，只需掌握 Elasticsearch DSL，极简使用方式 |
| 开箱即用 | Spring Boot 自动配置，无需复杂设置 |
| 高效异步处理 | 内置 BulkProcessor 异步批处理器，大幅提升写入性能 |
| 灵活查询方式 | 支持 DSL、SQL、O/R Mapping 多种查询模式 |
| 多数据源支持 | 一个应用可同时操作多个不同版本的搜索引擎集群 |
| 客户端负载均衡 | 默认启用客户端负载均衡，容灾性更好 |
| 完整的结果封装 | 返回结果支持 JSON、PO 对象、List 集合、Map 等多种类型 |

三、为什么选择 Bboss + Easysearch

将 Bboss 作为 Easysearch 的 Java 客户端，您将获得以下独特优势：

国产化技术栈：从底层搜索引擎到上层客户端框架，完全国产化自主可控，满足信创合规要求，无许可证风险。
极低迁移成本：如果您正在使用 Elasticsearch + Bboss 技术栈，切换到 Easysearch 几乎零成本，只需修改连接配置即可。
成熟稳定的客户端：Bboss 经过多年发展，已在国内众多企业和项目中得到广泛应用和验证，拥有活跃的中文社区和完善的文档支持。
丰富的生态能力：除了基础的 CRUD 操作，还提供数据采集 ETL、流批一体化计算、AI 智能体等丰富的扩展能力。

四、快速开始

通过以下简单步骤，即可在 Bboss 中接入 Easysearch：

1. 添加 Maven 依赖

```xml

com.bbossgroups.plugins
bboss-datatran-jdbc
7.5.6

```

### 2. 配置 Easysearch 连接

```yml
spring:
elasticsearch:
bboss:
elasticsearch:
rest:
hostNames: localhost:9200
useHttps: true # Easysearch 默认启用 HTTPS
elasticUser: admin
elasticPassword: your_password
```

### 3. 基础操作

```java
@Service
public class DocumentService {
@Autowired
private BBossESStarter bbossESStarter;

// 插入文档
public void insertDocument() {
ClientInterface client = bbossESStarter.getRestClient();
Document doc = new Document();
doc.setId("1");
doc.setTitle("Easysearch 与 Bboss 集成");
doc.setContent("这是一篇关于集成的文章");
client.addDocument("documents", doc, "refresh=true");
}

// 查询文档
public Document getDocument(String id) {
ClientInterface client = bbossESStarter.getRestClient();
return client.getDocument("documents", id, Document.class);
}

// 按字段查询
public ESDatas searchByAuthor(String author) {
ClientInterface client = bbossESStarter.getRestClient();
return client.searchListByField(
"documents", "author.keyword", author,
Document.class, 0, 10
);
}
}
```

## 五、结语

Bboss v7.5.6 与 Easysearch 的深度兼容，是国产开源生态建设的又一重要成果。作为 Easysearch 原厂，我们欢迎更多像 Bboss 这样的优秀开源项目加入国产搜索引擎生态，共同推动国内搜索型数据库的发展与繁荣。

对于正在评估搜索引擎选型或计划进行国产替代的企业用户，**Bboss + Easysearch** 的组合无疑是值得信赖的选择。

立即体验 Easysearch，开启国产搜索引擎之旅：

- **Easysearch 官网：** <https://easysearch.cn>
- **Bboss 官方文档：** <https://esdoc.bbossgroups.com>
- **Easysearch x Bboss 详细集成文档：** <https://docs.infinilabs.com/ea ... gt%3B

---

## 六、关于 Easysearch

![](https://infinilabs.cn/img/blog ... er.png)

INFINI Easysearch 是一个分布式的搜索型数据库，实现非结构化数据检索、全文检索、向量检索、地理位置信息查询、组合索引查询、多语种支持、聚合分析等。Easysearch 可以完美替代 Elasticsearch，同时添加和完善多项企业级功能。作为国内领先的国产搜索引擎产品，Easysearch 具备以下核心优势：

### 1. 国产化自主可控

自主研发，符合信创要求，无许可证风险，为企业提供安全可靠的技术保障。在当前国际形势日益复杂、信创需求持续提升的大背景下，Easysearch 为政府、金融、电信、能源等关键行业提供了值得信赖的搜索引擎基础设施。

### 2. 轻量级架构

相比传统搜索引擎，Easysearch 资源占用更少，启动更快速，显著降低企业运维成本。其精简的架构设计使得在同等硬件条件下可以承载更多的业务负载，特别适合资源受限的私有化部署场景。

### 3. 卓越性能表现

查询性能优异，能够满足大部分业务场景需求，用户体验流畅。通过持续的内核优化和算法改进，Easysearch 在多项基准测试中展现出媲美甚至超越同类产品的性能水平。

### 4. 良好兼容性

与 Elasticsearch 的 API 接口基本兼容，迁移成本较低，保护用户现有投资。这一特性使得基于 Elasticsearch 开发的应用可以快速平滑地迁移至 Easysearch，大大降低了国产替代的技术门槛。

---

## 社区福利

为感谢广大社区开发者的支持，Bboss 与 Easysearch 厂商极限科技联合发起抽奖活动，奖品为开源T恤。6 月 29 日上午 10 点自动开奖，欢迎大家扫码抽奖参与。

【搜索客社区日报】第2246期 (2026-06-10）

社区日报 • kin122 发表了文章 • 0 个评论 • 7378 次浏览 • 2026-06-10 22:58 • 来自相关话题

极限科技 Easysearch 与鼎甲备份系统完成深度兼容适配认证

资讯动态 • INFINI Labs 小助手发表了文章 • 0 个评论 • 7866 次浏览 • 2026-06-10 09:21 • 来自相关话题

国产统信 UOS 部署 Coco Server 全指南：从零搭建企业级 AI 搜索服务端

Easysearch • INFINI Labs 小助手发表了文章 • 0 个评论 • 8094 次浏览 • 2026-06-09 14:19 • 来自相关话题

一、引言

在上一篇文章《[从零到跑起来：Easysearch 信创环境安装全流程](https://infinilabs.cn/blog/202 ... tform/)》中，我们成功在信创平台上安装并运行起了 Easysearch。但 Easysearch 是一个底层搜索引擎，直接操作有一定门槛。如果我们想让团队里的每个人都能方便地“搜文件、聊文档、问知识”，就需要一个更贴近日常使用、又能把 AI 能力融入进来的上层应用——这就是 Coco AI 。

本文将继续手把手带你从零开始，在国产统信 UOS 服务器操作系统上部署 Coco Server，并与已安装的 Easysearch 进行对接。全文依然零基础可读，跟着步骤一步步来即可。

二、Coco Server 是什么？它和 Easysearch 什么关系？

先对我们的产品进行一个简单的介绍：

Easysearch 是底层引擎，负责存储和检索数据，像汽车的发动机和底盘；
Coco Server 是基于 Easysearch 之上的服务端应用程序，提供 Web 管理界面、统一搜索、AI 聊天、知识库管理等高级功能，类似车身和智能驾驶系统；
Coco AI 桌面客户端则是连接 Coco Server 的终端软件，安装在个人电脑上使用。

而在本文中部署的 Coco Server，是整个 Coco AI 体系的“大脑”：
它负责连接各类数据源（飞书、语雀、GitHub、本地文件等）；
它管理大模型提供商（Deepseek、通义千问、OpenAI 等）；
它提供 Web 管理后台，让管理员可以可视化地完成所有配置。

部署完成之后，团队成员只需通过客户端或浏览器，就能享受统一搜索与 AI 智能问答带来的便利。Coco AI 的整体架构图如下：

![](https://infinilabs.cn/img/blog ... p1.png)

三、部署前置条件

1. 进行服务器相关优化

```bash

内核参数优化

cat << SETTINGS | sudo tee /etc/sysctl.d/70-infini.conf
fs.file-max = 10485760
fs.nr_open = 10485760
vm.max_map_count = 262145

net.core.somaxconn = 65535
net.core.netdev_max_backlog = 65535
net.core.rmem_default = 262144
net.core.wmem_default = 262144
net.core.rmem_max = 4194304
net.core.wmem_max = 4194304

net.ipv4.ip_forward = 1
net.ipv4.ip_nonlocal_bind = 1
net.ipv4.ip_local_port_range = 1024 65535
net.ipv4.conf.default.accept_redirects = 0
net.ipv4.conf.default.rp_filter = 1
net.ipv4.conf.all.accept_redirects = 0
net.ipv4.conf.all.send_redirects = 0
net.ipv4.tcp_tw_reuse = 1
net.ipv4.tcp_tw_recycle = 1
net.ipv4.tcp_max_tw_buckets = 300000
net.ipv4.tcp_timestamps = 1
net.ipv4.tcp_syncookies = 1
net.ipv4.tcp_max_syn_backlog = 65535
net.ipv4.tcp_synack_retries = 0
net.ipv4.tcp_keepalive_intvl = 30
net.ipv4.tcp_keepalive_time = 900
net.ipv4.tcp_keepalive_probes = 3
net.ipv4.tcp_fin_timeout = 10
net.ipv4.tcp_max_orphans = 131072
net.ipv4.tcp_rmem = 4096 4096 16777216
net.ipv4.tcp_wmem = 4096 4096 16777216
net.ipv4.tcp_mem = 786432 3145728 4194304
SETTINGS

sysctl -p /etc/sysctl.d/70-infini.conf

```

2. 环境前提：Easysearch 已经运行好

Coco Server 运行强依赖 Easysearch，所以在继续之前，请确保你的信创服务器上已经安装并成功启动了 Easysearch。如果不确定，可以执行下面的命令验证：

bash curl -k -u admin:你的密码 <a href="https://localhost:9200" rel="nofollow" target="_blank">https://localhost:9200</a> 

运行命令后，看到正常的 JSON 响应即可。

如果还没有安装，可以参考上一篇文章《[从零到跑起来：Easysearch 信创环境安装全流程](https://infinilabs.cn/blog/202 ... tform/)》先行完成。

3. 信创平台信息确认

和 Easysearch 一样，你需要明确当前服务器的 CPU 架构和操作系统版本。在终端执行：

```bash

查看 CPU 架构

uname -m

查看操作系统信息

cat /etc/os-release
```

根据输出，确认 CPU 架构和操作系统，后续下载时选择对应版本。

部署环境如下表中所示：

4. 软件环境

| 名称 | 版本 | 备注 |
| ----------------------- | ------ | ------------------ |
| Coco AI 智能搜索软件 | V1.0.0 | Coco Server |
| 统信服务器操作系统 A 版 | V20 | |
| Easysearch 搜索型数据库 | V2.2.0 | 用于 Coco 数据存储 |
| 360安全浏览器 | V13 | |

5. Coco AI 大语言模型推荐配置

| 模型名称 | 上下文长度 | 最大输出长度 | 描述 |
| ----------------------- | ---------- | ------------ | ---------------------------------------------------- |
| deepseek-r1 | 128K | 16K | 数学、代码、自然语言推理等任务上，性能较高，能力较强 |
| qwen3-max | 256K | 32K | 配场景复杂的智能体需求 |
| tongyi-intent-detect-v3 | 8K | 8K | 用于意图识别和槽位填充，负责对话系统中的基础任务 |

5. 网络端口配置

| 服务名 | 端口 | 配置文件 | 说明 |
| ----------------- | ------------ | --------------------- | ----------------------------------------------------------- |
| Coco Server | 9000（默认） | coco.yml | |
| INFINI Easysearch | 9200（默认） | config/easysearch.yml | 默认仅监控 127.0.0.0，可通过配置 network.host: 0.0.0.0 调整 |
| | 9300（默认） | config/easysearch.yml | |

四、部署步骤

步骤 1：下载 Coco Server

```bash

调整为 Coco 实际要安装的路径

cd /opt

下载Coco v1.0.0压缩包

curl -O https://release.infinilabs.com ... 0.zip

解压到当前文件夹

unzip coco-1.0.0.zip

选择对应的版本解压tar.gz文件

tar -xzf coco-1.0.0-2002-linux-arm64.tar.gz

解压后在对应文件夹下得到可执行程序coco-linux-arm64（arm64版本）和配置文件coco.yml

```

步骤 2：配置 Easysearch 连接信息

Coco Server 需要得到 Easysearch 的地址和登录凭证才能进行工作。

在安装路径的目录下，找到配置文件进行配置，比如监听的端口地址 WEB_BINDING，将 Easysearch 的服务地址环境变量 ES_ENDPOINT 和用户名 ES_USERNAME 设置为实际的，参考如下：

```plain
env:

调整为实际可以访问的 Easysearch 访问地址

ES_ENDPOINT: https://localhost:9200

调整为实际可以访问的 Easysearch 的用户

ES_USERNAME: admin

使用 keystore 存储的密码

ES_PASSWORD: $[[keystore.ES_PASSWORD]]

Coco Server 对外提供服务的端口（默认9000端口）

WEB_BINDING: 0.0.0.0:9000
```

步骤 3：使用keystore对密码进行加密处理

Easysearch 的服务密码通过 Keystore 进行加密存放，避免明文存放到配置文件，减少数据泄露风险

```bash

调整为 Coco 实际安装路径进行配置

cd /opt

创建 coco 软链接，可不区分 amd64/arm64 平台进行操作

ln -s coco-linux-arch | grep -q "x86_64" && echo "amd64" || echo "arm64" coco

根据之前拿到的 Easysearch 密码进行初始化 ES_PASSWORD 变量

ES_PASSWORD=xxx

将 ES_PASSWORD 变量的值存储到 keystore（./coco-linux-arm64替换为对应版本名,下同）

echo "$ES_PASSWORD" | ./coco-linux-arm64 keystore add --stdin ES_PASSWORD

检查 keystore 存储列表，确认 ES_PASSWORD 添加成功

./coco-linux-arm64 keystore list
```

步骤 4：启动服务

以上配置完成后，设置 Coco Server 以服务方式启动

```bash

安装系统服务（./coco-linux-arm64替换为对应版本名,下同）

./coco-linux-arm64 -service install

启动服务

./coco-linux-arm64 -service start
```

![](https://infinilabs.cn/img/blog ... p2.png)

步骤 5：初始化设置

服务启动后，在信创服务器的桌面环境下，打开浏览器，访问 UI 界面：

http://localhost:9000/#/_guide/

你将看到 Coco Server 的 Web 引导界面。因为是首次访问，所以需要创建管理员账号，按页面引导填写即可。

![](https://infinilabs.cn/img/blog ... p3.png)

创建完管理员账户后，下一步

设置一个模型提供商，Coco Server 支持:
Deepseek
Ollama
任何和 OpenAI 格式兼容的模型提供商

如果设置的模型是推理模型，需要打开“推理模式”。我们推荐使用参数较大的模型，来获得更好的使用体验。同时请注意：Endpoint 地址的配置要准确。

![](https://infinilabs.cn/img/blog ... p4.png)

Coco Server 默认配置了一些小助手，建议在初始化向导的时候直接配置一个可用的模型，这样进入系统之后就可以直接使用，避免一个个的手动配置。

向导设置完成后，就会跳转到登录页面，输入刚才创建的账户和密码，就可以进行登录了，如下图：

![](https://infinilabs.cn/img/blog ... p5.png)

管理员首次登录之后的第一件事是确认服务器的地址是否正确，如果 Coco server 前面增加了负载均衡或者配置了域名，需要在这里设置一下正确的 Coco Server 对外服务地址，如下图：

![](https://infinilabs.cn/img/blog ... p6.png)

五、总结

到这里，你已经完成了 Coco Server 在信创平台上的部署与初始化。我们回顾一下整个部署流程：
1. 确认环境 — Easysearch 已部署成功，并明确 CPU 架构；
2. 下载安装 — 下载 Coco Server 的压缩包进行解压；
3. 配置连接 — 编辑 coco.yml，填入 Easysearch 端点和密码；
4. 启动服务 — 将 Coco Server 以服务方式启动；
5. 初始化 — 浏览器打开 http://localhost:9000/#/_guide/ 进行管理员账户的创建；添加大模型、连接数据源、创建助手。
  
  Coco Server 部署完成后，你就拥有了一个完全私有化、自主可控的企业级统一搜索与 AI 智能助手服务端。下一步可以安装 [ Coco AI 桌面客户端](https://coco.rs/zh/download)，让团队成员真正体验“一个搜索框搜遍全公司”的高效便捷。
  
  如果在部署过程中遇到任何困难，欢迎查阅[官方文档](https://docs.infinilabs.com/coco-server/main/ "官方文档")，祝你部署顺利！

【搜索客社区日报】第2245期 (2026-06-09）

社区日报 • God_lockin 发表了文章 • 0 个评论 • 8407 次浏览 • 2026-06-09 09:44 • 来自相关话题

【搜索客社区日报】第2244期 (2026-06-08）

社区日报 • Muses 发表了文章 • 0 个评论 • 8929 次浏览 • 2026-06-08 11:20 • 来自相关话题

Easysearch 信创环境安装实践

Easysearch • INFINI Labs 小助手发表了文章 • 0 个评论 • 10423 次浏览 • 2026-06-05 18:10 • 来自相关话题

![](https://infinilabs.cn/img/blog ... er.png)

一、Easysearch 介绍

在动手安装之前，我们先花一点时间了解这个工具。
INFINI Easysearch （以下简称 Easysearch）是由极限科技（INFINI Labs）自主研发的一款分布式 AI 搜索型数据库。用通俗的话讲，它是一个“超级搜索引擎”，能帮你在海量数据中快速查找信息，支持结构化和非结构化的数据检索、全文检索、向量检索、空间地理位置信息检索、组合查询、多语种支持、语义分析和聚合分析等多种功能，被广泛应用于企业搜索、日志分析、知识库管理等场景。它的安装包仅50MB，非常轻量。

Easysearch 的“自主可控”特性十分突出：

完全国产化：已适配龙芯、鲲鹏、飞腾、海光、兆芯、申威等主流国产 CPU；
全面兼容国产操作系统：支持银河麒麟、统信 UOS、中标麒麟等国产操作系统；
国密算法支持：全量支持 SM2/SM3/SM4 国密算法，满足等保三级及信创合规要求；
ES生态兼容：完全兼容 Elasticsearch 的 API 接口，可无缝平替。

![](https://infinilabs.cn/img/blog ... p1.png)

二、安装前需知

1.你的信创平台属于哪种？

信创平台的组合通常是“国产 CPU + 国产操作系统”，你需要确认你的环境属于哪种：

| 国产CPU | 架构 | 常见搭配操作系统 |
| ---------------- | :-------: | -------------------- |
| 鲲鹏（Kunpeng） | ARM64 | 银河麒麟V10、统信UOS |
| 飞腾（Phytium） | ARM64 | 银河麒麟V10、统信UOS |
| 海光（Hygon） | x86 | 统信UOS、银河麒麟V10 |
| 龙芯（Loongson） | LoongArch | 银河麒麟V10、统信UOS |
| 兆芯（Zhaoxin） | x86 | 银河麒麟V10、统信UOS |
| 申威（Sunway） | SW64 | 统信UOS |

不确定的话，可以在终端执行以下命令查看：

```bash

查看操作系统信息

cat /etc/os-release

查看CPU架构

uname -m
```

2.在线部署or离线部署？

Easysearch 提供了两种安装方式：

联网环境：如果服务器能正常访问外网，推荐使用一键安装部署，简单快速；

离线环境：如果服务器在内网、无法访问外网（常见信创环境），则下载 Bundle 包进行离线部署。

在这篇文章中所使用的是在线部署方式。

三、安装环境简介

以统信 UOS 信创平台为例，以下表中为本机采用的安装环境

1.硬件信息

| 硬件 | 信息 |
| ------ | :-----------------------------: |
| 处理器 | 架构：aarch64 型号：Kunpeng-920 |
| 内存 | 容量：8G 类型：RAM |
| 硬盘 | 类型：QEMU HARDDISK 容量：100G |

2.软件环境

| 名称 | 版本 |
| ----------------------- | :----: |
| 统信服务器操作系统A版 | V20 |
| Easysearch 搜索型数据库 | V2.2.0 |
| 360安全浏览器 | V13 |

3.网络端口设置

| 服务名 | 端口 | 配置文件 | 说明 |
| ----------------- | :----------: | --------------------- | :---------------------------------------------------------: |
| INFINI Easysearch | 9200（默认） | config/easysearch.yml | 默认仅监控 127.0.0.0，可通过配置 network.host: 0.0.0.0 调整 |
| | 9300（默认） | config/easysearch.yml | |

四、部署流程

具体细节详见[部署手册](https://docs.infinilabs.com/ea ... yment/)

步骤1：系统初始化

安装前需要完成两项系统准备工作：调整内核参数和创建专用用户。无论在线还是离线安装，这两步都必须先做好，并且需要使用 root 账户或 sudo 权限执行。

```bash

1. 调整内核参数（vm.max_map_count，Easysearch 运行的必要条件）

echo "vm.max_map_count=262144" >> /etc/sysctl.conf && sysctl -p

2. 创建 Easysearch 专用用户组和用户

groupadd -r easysearch && useradd -r -g easysearch -d /home/easysearch -s /sbin/nologin -c "Easysearch Service Account" easysearch

```

步骤2：安装 Easysearch

如果服务器能正常访问外网，直接使用官方一键安装脚本：

```bash

创建数据安装目录

mkdir -p /opt/easysearch

下载最新版本并安装

curl -sSL http://get.infini.cloud | bash -s -- -p easysearch -d /opt/easysearch

`` 脚本会自动检测系统架构（ARM64还是x86` ），并下载对应的安装包。

![](https://infinilabs.cn/img/blog ... p2.png)

步骤3：初始化并启动 Easysearch

```bash

进入 Easysearch 目录

cd /opt/easysearch

初始化 Easysearch （初始化过程中，日志将输出管理员访问密码,请妥善保存）

bin/initialize.sh -s

调整目录权限

chown -R easysearch:easysearch /opt/easysearch

启动 Easysearch

runuser -u easysearch -- /opt/easysearch/bin/easysearch -d -p /opt/easysearch/easysearch.pid

```

步骤4：验证服务运行

启动后，可以使用 curl 命令快速测试服务是否正常运行：

```bash

使用初始化时显示的 admin 密码测试连接

curl -ku admin:你的密码 https://localhost:9200

```

![](https://infinilabs.cn/img/blog ... p3.png)

步骤5：访问服务运行端口

服务运行后，访问设置好的服务端点

<https://localhost:9200/_ui/>（默认服务端点）

输入之前保存的账号与密码进行登录

![](https://infinilabs.cn/img/blog ... p4.png)

进入 ui 界面

![](https://infinilabs.cn/img/blog ... p5.png)

之后就可以实现对 Easysearch 可视化管理了

结语

以上就是 Easyserach 在信创平台部署的全流程了，整个过程操作下来，应该能在 10-20 分钟左右完成 Easysearch 支持从单机测试到 PB 级生产集群的平滑扩展，无论是个人学习还是企业级业务，都能灵活适配。如果在操作过程中遇到任何问题，建议优先查阅[官方文档](https://docs.infinilabs.com/easysearch/)。预祝你在信创平台的探索之旅顺利！

Elasticsearch 6/7/8 到 Easysearch 2.x 迁移指南

Easysearch • INFINI Labs 小助手发表了文章 • 0 个评论 • 10912 次浏览 • 2026-06-04 14:14 • 来自相关话题

![](https://infinilabs.cn/img/blog ... er.jpg)

最近在协助客户进行 Elasticsearch 到 Easysearch 的迁移时，发现大家最关心的问题是"当前版本能否直接使用快照迁移"。这个问题看似简单，但不同版本的答案差异较大。本文将基于实际测试经验，梳理各版本的迁移路径和注意事项。

迁移路径速览

根据源 ES 版本，可以直接对照下表选择迁移方案：

| 源 ES 版本 | 能否直接快照恢复 | 推荐方案 | 实施复杂度 |
| -------------- | :--------------: | ------------------------------------- | :--------: |
| ES 6.x | 否 | INFINI Gateway 迁移或 ES 7.10.x 中转 | 较低 |
| ES 7.0 - 7.11 | 是 | 直接快照恢复 | 较低 |
| ES 7.12 - 7.17 | 否 | INFINI Gateway 迁移 | 较低 |
| ES 8.x | 否 | INFINI Gateway 迁移 | 较低 |

结论：ES 7.0-7.11 是迁移最顺畅的版本窗口，可直接快照恢复；其他版本也有成熟的迁移方案，只是路径不同。

版本差异的原因

迁移路径的差异主要源于两方面：Lucene 版本兼容性和快照元数据格式变化。

Lucene 兼容性：Easysearch 2.x 底层要求的最低 Lucene 版本对应 ES 7.0.0。ES 6.x 的索引文件使用老版本 Lucene，直接恢复会报错：

 The index was created with version [6.8.23] but the minimum compatible version is [7.0.0]. 

快照元数据格式：ES 7.12 开始在快照中引入 uuid、cluster_id 字段，7.14 增加 writer_uuid，8.x 又引入 transport_version。这些字段与 Easysearch 2.x 的快照解析器不兼容。

因此，ES 7.0-7.11 成为迁移的"黄金窗口"——既满足 Lucene 兼容性要求，快照格式又足够简洁。

ES 7.0-7.11：直接快照恢复

这是测试最充分的迁移路径，已验证版本包括 ES 7.0.1、7.8.1、7.10.2 OSS、7.11.2。

已验证能力：

单索引 / 多索引 / 通配符批量恢复
常见字段类型与别名
自定义 settings、多分片索引
ILM 托管索引、数据流后备索引、冻结索引

操作步骤：

```bash

1. 源 ES 创建快照

PUT /_snapshot/my_backup/snapshot_1
{
"indices": "索引列表",
"include_global_state": false
}

2. Easysearch 注册同一快照仓库

PUT /_snapshot/my_backup
{
"type": "fs",
"settings": {
"location": "/path/to/snapshot/repo",
"readonly": true
}
}

3. 恢复快照

POST /_snapshot/my_backup/snapshot_1/_restore
{
"indices": "索引列表",
"include_global_state": false
}
```

ES 6.x：Gateway 迁移或中转方案

ES 6.x 无法直接快照恢复到 Easysearch 2.x，有两种迁移方案可选：

方案一：INFINI Gateway 迁移（推荐）

直接使用 Gateway 从 ES 6.x 迁移数据到 Easysearch，无需中转集群。Gateway 已验证支持 ES 6.8.x 的数据迁移。

方案二：ES 7.10.x 中转

 ES 6.8 -> 快照 -> ES 7.10.x -> 快照 -> Easysearch 2.x 

ES 7.10.x 可以正常恢复 ES 6.x 的快照，恢复完成后再创建快照供 Easysearch 使用。该方案数据完整性有保障，但需要额外的中转存储和迁移窗口。

ES 6.x 特有字段：ES 6.x 的 string 类型在 Easysearch 中需映射为 text 或 keyword（根据实际使用场景选择）。

ES 7.12+ 和 8.x：INFINI Gateway 迁移

这两个版本段的快照格式与 Easysearch 2.x 不兼容，推荐使用 INFINI Gateway 进行迁移。Gateway 是 INFINI Labs 提供的数据迁移工具，专门针对 Elasticsearch 到 Easysearch 的迁移场景进行了优化。

架构示意

 ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │ Elasticsearch │ ──── │ INFINI Gateway │ ──── │ Easysearch │ │ （源集群） │ │ （迁移工具） │ │ （目标集群） │ └─────────────────┘ └─────────────────┘ └─────────────────┘ 

Gateway 内部通过 Scroll API 从源集群分批拉取数据，再通过 Bulk API 写入目标集群，整个过程对业务透明。

主要优势
配置简单：只需配置源集群和目标集群地址、索引名称即可
断点续传：支持从断点恢复，避免网络抖动导致重头再来
进度可视：实时显示迁移进度和速率
多索引并行：支持同时迁移多个索引

基本步骤
1. 在目标集群创建索引的 mapping 和 setting
2. 准备 Gateway 配置文件，填写源集群和目标集群连接信息
3. 运行 Gateway 执行迁移
4. 迁移完成后进行数据校验
  
  详细的配置说明和操作示例，可参考 [ES 数据迁移之 INFINI Gateway](https://infinilabs.cn/blog/202 ... teway/)。
  
  备选方案
  
  如果需要更灵活的控制，也可以自行编写脚本，通过 Scroll API 读取源数据、Bulk API 写入目标。这种方式适合有定制化需求的场景，但需要自行处理断点续传、错误重试等逻辑。
  
  字段类型兼容性
  
  直接兼容类型：text、keyword、long、double、boolean、date、object、nested、geo_point、geo_shape、ip、completion、wildcard、flattened、alias、join、rank_feature、rank_features、integer_range、long_range、date_range、match_only_text 等。
  
  ES 7.x / 8.x 需替换类型：
  
  | ES 类型 | Easysearch 替代方案 | 数据保留 | 说明 |
  | ------------------------- | ------------------------ | :------: | --------------------------------- |
  | dense_vector | knn_dense_float_vector | 是 | 需安装 knn 插件，向量数据格式兼容 |
  | knn_vector | knn_dense_float_vector | 是 | 需安装 knn 插件 |
  | sparse_vector | knn_sparse_bool_vector | 是 | 需安装 knn 插件 |
  | constant_keyword | keyword | 是 | 需手动维护常量值 |
  | runtime | 移除或转为普通字段 | 是 | Easysearch 不支持运行时字段 |
  | histogram | object | 是 | 聚合 histogram 功能丢失 |
  | aggregate_metric_double | object | 是 | 需手动计算聚合 |
  | unsigned_long | long 或 keyword | 是 | 注意数值范围 |
  | semantic | 暂不支持 | - | ES 专有 AI 功能 |
  
  向量迁移要点：ES 的 dense_vector 数据可直接迁移到 Easysearch 的 knn_dense_float_vector，数据格式 [0.1, 0.2, ...] 完全兼容。需预先在目标索引创建正确的 mapping。
  
  建议迁移前先用小索引测试，确认 mapping 无问题后再全量迁移。
  
  常见问题与避坑指南
  
  1. include_global_state 参数设置
  
  该参数控制是否恢复集群级配置（模板、ILM 策略等）。不同版本的情况：
  
  | ES 版本 | 发行版 | global_state | 说明 |
  | -------- | ------- | ------------ | -------------------------------- |
  | 7.0-7.7 | 任意 | 兼容 | 无 _index_template API |
  | 7.8-7.10 | OSS | 兼容 | 无内置 _index_template |
  | 7.8-7.10 | default | 可能不兼容 | 取决于是否使用 _index_template |
  | 7.11+ | 任意 | 不兼容 | 有 9 个内置 _index_template |
  
  建议：迁移时统一使用 include_global_state=false，先恢复数据再重建配置。
  
  2. ILM 和 data stream 迁移
ILM：索引的 lifecycle 设置保留，但 policy 需在 Easysearch 中重建
数据流 (data stream)：后备索引 (backing index) 数据完整恢复，语义需在目标侧重建
冻结索引 (frozen index)：自动恢复为普通可访问状态

3. 迁移验收标准

建议至少完成三项验证：
文档量一致
关键查询结果一致
核心业务链路压测通过

4. 迁移窗口规划
快照方案通常需要短停机窗口完成切换
Gateway 迁移可实现近实时同步，仅在切换连接时短暂停服

快照格式变化参考

| 字段 | ES 7.0-7.11 | ES 7.12-7.17 | ES 8.x | Easysearch 2.x |
| ------------------- | :---------: | :----------: | :----: | :------------: |
| min_version | 7.9.0 或无 | 7.12.0 | 7.12.0 | 支持 |
| uuid（仓库级） | 无 | 有 | 有 | 不支持 |
| cluster_id | 无 | 有 | 有 | 不支持 |
| writer_uuid | 无 | 有（7.14+） | 有 | 不支持 |
| transport_version | 无 | 无 | 有 | 不支持 |

总结

本文梳理了 Easysearch 2.x 对 ES 6/7/8 的迁移路径：
ES 7.0-7.11：直接快照恢复，路径最短
ES 6.x：INFINI Gateway 迁移或 ES 7.10.x 中转
ES 7.12+ / 8.x：使用 INFINI Gateway 迁移

建议在正式迁移前，先选择非核心索引进行小规模验证，确认数据完整性和业务兼容性后再扩大迁移范围。

如有迁移相关问题，欢迎联系我们。

通知设置 新通知

发现

一、引言

二、Bboss Elasticsearch 客户端简介

核心特性

三、为什么选择 Bboss + Easysearch

四、快速开始

1. 添加 Maven 依赖

一、引言

二、Coco Server 是什么？它和 Easysearch 什么关系？

三、部署前置条件

1. 进行服务器相关优化

内核参数优化

2. 环境前提：Easysearch 已经运行好

3. 信创平台信息确认

查看 CPU 架构

查看操作系统信息

4. 软件环境

5. Coco AI 大语言模型 推荐配置

5. 网络端口配置

四、部署步骤

步骤 1：下载 Coco Server

调整为 Coco 实际要安装的路径

下载Coco v1.0.0压缩包

解压到当前文件夹

选择对应的版本解压tar.gz文件

解压后在对应文件夹下得到可执行程序coco-linux-arm64（arm64版本）和配置文件coco.yml

步骤 2：配置 Easysearch 连接信息

调整为实际可以访问的 Easysearch 访问地址

调整为实际可以访问的 Easysearch 的用户

使用 keystore 存储的密码

Coco Server 对外提供服务的端口（默认9000端口）

步骤 3：使用keystore对密码进行加密处理

调整为 Coco 实际安装路径进行配置

创建 coco 软链接，可不区分 amd64/arm64 平台进行操作

根据之前拿到的 Easysearch 密码进行初始化 ES_PASSWORD 变量

将 ES_PASSWORD 变量的值存储到 keystore（./coco-linux-arm64替换为对应版本名,下同）

检查 keystore 存储列表，确认 ES_PASSWORD 添加成功

步骤 4：启动服务

安装系统服务（./coco-linux-arm64替换为对应版本名,下同）

启动服务

步骤 5：初始化设置

五、总结

一、Easysearch 介绍

二、安装前需知

1.你的信创平台属于哪种？

查看操作系统信息

查看CPU架构

2.在线部署or离线部署？

三、安装环境简介

1.硬件信息

2.软件环境

3.网络端口设置

四、部署流程

步骤1：系统初始化

1. 调整内核参数（vm.max_map_count，Easysearch 运行的必要条件）

2. 创建 Easysearch 专用用户组和用户

步骤2：安装 Easysearch

创建数据安装目录

下载最新版本并安装

步骤3：初始化并启动 Easysearch

进入 Easysearch 目录

初始化 Easysearch （初始化过程中，日志将输出管理员访问密码,请妥善保存）

调整目录权限

启动 Easysearch

步骤4：验证服务运行

使用初始化时显示的 admin 密码测试连接

步骤5：访问服务运行端口

结语

迁移路径速览

版本差异的原因

ES 7.0-7.11：直接快照恢复

1. 源 ES 创建快照

2. Easysearch 注册同一快照仓库

3. 恢复快照

ES 6.x：Gateway 迁移或中转方案

ES 7.12+ 和 8.x：INFINI Gateway 迁移

架构示意

主要优势

基本步骤

通知设置新通知

5. Coco AI 大语言模型推荐配置

1. `include_global_state` 参数设置