最近在协助客户进行 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，直接恢复会报错：

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

快照元数据格式：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 中转
  
  <br /> ES 6.8 -> 快照 -> ES 7.10.x -> 快照 -> Easysearch 2.x<br />
  
  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 的迁移场景进行了优化。
  
  

  架构示意
  

  
  <br /> ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐<br /> │ Elasticsearch │ ──── │ INFINI Gateway │ ──── │ Easysearch │<br /> │ （源集群） │ │ （迁移工具） │ │ （目标集群） │<br /> └─────────────────┘ └─────────────────┘ └─────────────────┘<br />
  
  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 介绍

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

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

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

  二、安装前需知
  

  
  

  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
  
  ``<br /> <br /> 脚本会自动检测系统架构（ARM64还是x86` ），并下载对应的安装包。
  
  
  
  

  步骤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
  
  ```
  
  
  
  

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

  
  服务运行后，访问设置好的服务端点
  
  <https://localhost:9200/_ui/>（默认服务端点）
  
  输入之前保存的账号与密码进行登录
  
  
  
  进入 ui 界面
  
  
  
  之后就可以实现对 Easysearch 可视化管理了
  
  

  结语
  

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

1、6个资源，1条命令：使用 Terraform 全自动化实现 Elastic 异常检测
https://elasticstack.blog.csdn ... 77153

2、Kibana：使用 AI Chat 及 MCP 轻松创建 AI 原生仪表板
https://elasticstack.blog.csdn ... 23964

3、Elastic MCP Apps 入门：安装与试用
https://elasticstack.blog.csdn ... 21339
4、你的 Elastic agent、Google 的 ADK，以及零自定义 API：基于 A2A 构建 “幸运星球”
https://elasticstack.blog.csdn ... 37307
 
5、如何写好 Skill：一份终极实战经验手册
https://mp.weixin.qq.com/s/SZv3pDXPrL9vwV3Ua_84Kg
 
编辑：Muse
更多资讯：http://news.searchkit.cn
 

1. 起底 Lucene 段合并：你的 ES 索引是如何在后台偷偷“大练兵”的？（需要梯子）  
https://dev.to/iprithv/lucene- ... -1k78

2. 打败 ES 性能瓶颈！看我们如何转向 Weaviate 搞定生产级高性能混合检索！（需要梯子）  
https://dev.to/amirsefati/from ... n-b4i

3. 别让“数据引力”拖了后腿！如何让安全运营中心（SOC）的 AI 安全实现降维打击？  
https://www.elastic.co/blog/da ... urity

4. 微软 Build 2026 刚落幕，Azure 玩家用 ES 搞事情的正确姿势都在这儿了！  
https://www.elastic.co/blog/mi ... ap-up

5. AI 智能体接管安全运营？公共安全领域的 AI 网络防御大杀器来袭！  
https://www.elastic.co/blog/ag ... urity


编辑：斯蒂文  
更多资讯：http://news.searchkit.cn

一、引言

在上一篇文章《[从零到跑起来：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 的整体架构图如下：
  
  
  
  

  三、部署前置条件
  

  
  

  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<br /> curl -k -u admin:你的密码 <a href="https://localhost:9200" rel="nofollow" target="_blank">https://localhost:9200</a><br />
  
  运行命令后，看到正常的 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
  ```
  
  
  
  

  步骤 5：初始化设置
  

  
  服务启动后，在信创服务器的桌面环境下，打开浏览器，访问 UI 界面：
  
  http://localhost:9000/#/_guide/
  
  你将看到 Coco Server 的 Web 引导界面。因为是首次访问，所以需要创建管理员账号，按页面引导填写即可。
  
  
  
  创建完管理员账户后，下一步
  
  设置一个模型提供商，Coco Server 支持:
  
  

• Deepseek
  
• Ollama
  
• 任何和 OpenAI 格式兼容的模型提供商
  
  如果设置的模型是推理模型，需要打开“推理模式”。我们推荐使用参数较大的模型，来获得更好的使用体验。同时请注意：Endpoint 地址的配置要准确。
  
  
  
  Coco Server 默认配置了一些小助手，建议在初始化向导的时候直接配置一个可用的模型，这样进入系统之后就可以直接使用，避免一个个的手动配置。
  
  向导设置完成后，就会跳转到登录页面，输入刚才创建的账户和密码，就可以进行登录了，如下图：
  
  
  
  管理员首次登录之后的第一件事是确认服务器的地址是否正确，如果 Coco server 前面增加了负载均衡或者配置了域名，需要在这里设置一下正确的 Coco Server 对外服务地址，如下图：
  
  
  
  

  五、总结
  

  
  到这里，你已经完成了 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/ "官方文档")，祝你部署顺利！

近日，极限科技与鼎甲科技顺利完成双向兼容适配认证，国产分布式检索数据库 Easysearch V2.0 与鼎甲数据备份与恢复系统 DBackup V8.0 全面通过功能、性能、稳定性联合测试，产品适配顺畅、运行表现优异，成功实现国产检索存储与国产数据灾备全链路深度打通。


为保障适配落地效果，双方组建专项技术团队，围绕 Easysearch 海量索引、向量索引等特色数据结构开展定制化调优，覆盖全量与增量备份、瞬时恢复、故障回滚、集群高可用等核心业务场景。经过多轮严苛验证，两套自研产品可无缝协同，能够为检索类数据提供覆盖全生命周期的安全防护能力。

作为国产化核心检索引擎，Easysearch V2.0 原生兼容 ES 生态，支持全文检索、向量检索、多模态检索等丰富能力，深度适配国产软硬件环境，可有效助力政务、金融、大数据等行业实现搜索引擎国产化替换。鼎甲 DBackup V8.0 是国内主流政企级灾备产品，具备全域数据备份、极速恢复、异地容灾、勒索防护等成熟能力，长期为海量关键业务数据提供安全保障。

未来，极限科技与鼎甲科技将持续深化技术与生态合作，持续跟进产品版本迭代适配，联合打磨标准化行业解决方案，拓展金融、政务、能源等落地场景，携手完善国产基础软件产业链，持续赋能政企信创数字化建设。