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

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

社区日报 • Muses 发表了文章 • 0 个评论 • 2668 次浏览 • 4 天前 • 来自相关话题

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

社区日报 • kin122 发表了文章 • 0 个评论 • 1523 次浏览 • 2 天前 • 来自相关话题

【搜索客社区日报】第2242期 (2026-06-02)

社区日报 • God_lockin 发表了文章 • 0 个评论 • 1295 次浏览 • 2 天前 • 来自相关话题

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

Easysearch • INFINI Labs 小助手发表了文章 • 0 个评论 • 709 次浏览 • 1 天前 • 来自相关话题

![](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 迁移

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

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

Easysearch 信创环境安装实践

Easysearch • INFINI Labs 小助手发表了文章 • 0 个评论 • 90 次浏览 • 8 小时前 • 来自相关话题

![](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/)。预祝你在信创平台的探索之旅顺利！

通知设置 新通知

发现

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

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

【搜索客社区日报】第2242期 (2026-06-02)

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

迁移路径速览

版本差异的原因

ES 7.0-7.11：直接快照恢复

1. 源 ES 创建快照

2. Easysearch 注册同一快照仓库

3. 恢复快照

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

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

架构示意

主要优势

基本步骤

备选方案

字段类型兼容性

常见问题与避坑指南

1. include_global_state 参数设置

2. ILM 和 data stream 迁移

3. 迁移验收标准

4. 迁移窗口规划

快照格式变化参考

总结

Easysearch 信创环境安装实践

一、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：访问服务运行端口

结语

活动推荐

热门话题

通知设置新通知

1. `include_global_state` 参数设置