引言

在前面的文章中，我们分别进行了 Easysearch 在信创环境下的部署 以及 INFINI Gateway 数据网关的部署。到目前为止，整套搜索服务体系的核心组件已经就位 —— Easysearch 负责存储和检索，Gateway 负责进行流量管控。

但你可能注意到一个问题：Easysearch 虽然有着自己的管理界面。但随着集群数量增多、业务变得更加复杂，管理者不得不在多个系统之间切换，效率低下且容易遗漏告警。有没有一个 “管理中枢” ，将所有搜索集群统一纳管，一站式完成监控、告警、安全审计和数据探索？

这正是 INFINI Console 要解决的问题。本文将延续“小白友好”风格，带你完成系列第四篇——部署 INFINI Console，用它为整个搜索服务体系装上统一的“指挥中心”。

一、INFINI Console 是什么？为什么需要它？

1. 精准定位

INFINI Console 是一款 轻量级、跨版本、多集群的搜索基础设施统一管控平台，也是整个极限科技产品体系中承担“可观测性与集中管理”角色的核心组件。它可以将不同业务、不同版本的多个 Easysearch 或 Elasticsearch 集群集中纳管，让管理者和运维人员在一个平台上完成日常运维工作。

2. 它能做什么？

INFINI Console 的核心能力可以概括为以下五大板块：

• 平台管理：在一个平台内统一纳管任意多套 Easysearch / Elasticsearch 集群，支持跨版本（5.x 到 8.x）、跨云混合部署，新集群动态注册接入，目标集群无需安装任何插件。
• 可观察性监控：一键开启对目标集群的全维度监控，覆盖集群、节点、索引等级的详细指标，慢查询、异常日志、集群动态一览无余，帮你快速定位问题、缩短故障时间。
• 主动告警：支持灵活的告警规则配置，7×24 小时自动巡检集群关键指标和业务数据，一旦触发阈值立即通知，让你从“被动等故障”变成“主动防问题”。
• 安全审计：支持企业级 LDAP、AD、SSO 对接，提供集群、索引、字段、文档级别的统一访问控制，支持查询请求审计与分析，可智能识别和阻断异常查询。
• 开发者工具与数据探索：内置智能语法提示、多集群工作区、常用指令快捷加载，支持索引管理、数据浏览、文档编辑、时序数据快速查看等功能。

3. 轻量级特性

INFINI Console 使用 Golang 编写，安装包非常小，只有约 11MB，没有任何外部环境依赖（除了需要一个 Easysearch 或 Elasticsearch 集群作为存储后端），部署安装非常简单，只需下载对应平台的二进制可执行文件，启动即可。

此外，INFINI Console 已经通过了华为鲲鹏 Kunpeng 920 兼容性认证和统信 UOS 适配认证，并获得了 KUNPENG COMPATIBLE 证书，在信创环境下的稳定性和兼容性得到了官方验证.

二、部署前提

1. 环境前提：需要一个 Easysearch 集群作为“系统集群”

Console 本身不存储业务数据，但它需要将自身的配置信息（用户、角色、告警规则、监控数据等）存储到一个 Easysearch 集群中，这个集群被称为 “系统集群” 。

如果你已经按照本系列前面的文章Easysearch 在信创环境下的部署 安装了 Easysearch ，可以直接用它作为系统集群。而在部署 Console 之前，请确保该集群已正常启动：

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

2. 确认 CPU 架构

先确认你的信创服务器架构：

uname -m

本文示例使用的信创环境为：

• CPU ：鲲鹏 Kunpeng-920、aarch64
• 操作系统：统信服务器操作系统A版 V20

三、部署流程

步骤 1：下载 INFINI Console

使用命令下载

#创建文件安装目录
mkdir -p /opt/console

# 一键下载并安装到 /opt/console
curl -sSL http://get.infini.cloud | bash -s -- -p console -d /opt/console

步骤 2：修改配置文件

安装好后在安装目录下得到可执行程序 console-linux-arm64 与配置文件 console.yml，修改配置文件

network:
#找到 network 下的 binding 项，修改为想要放置服务的端点（默认为 9000）
     bingding：9001

步骤 3：启动程序

进入程序安装路径，运行可执行程序，首次运行建议直接运行程序启动，方便查看运行日志

#进入程序安装目录下
cd /opt/console

#运行可执行程序(console-linux-arm64 为可执行程序名)
./console-linux-arm64

从上述启动信息来看，意味着程序已经成功运行并监听了 9001 端口

如果想要关闭程序，按住 ：Ctrl+C

如果想将 Console 作为后台任务运行，请执行以下命令：

./console-linux-arm64 -service install

./console-linux-arm64 -service start

若是想要卸载服务的话，执行下列命令即可：

./console-linux-arm64 -service stop

./console-linux-arm64 -service uninstall

步骤 4：程序初始化

在浏览器中输入地址：http://0.0.0.0:9001，首次访问会自动进入初始化流程

连接已安装的集群

进行初始化系统索引和模板

设置用户，可以选择重置管理员账户

初始化完成，请妥善保存账号数据避免遗失

初始化流程结束后会回到登录界面，此时就可以使用设置好的账号信息进行登录

登陆后进入工作台页面

总结

到这里，你已经完成了 INFINI Console 在信创平台上的部署与初步上手。我们回顾一下整个流程：

1. 确认环境 — Easysearch 已启动，明确 CPU 架构；
2. 下载安装 — 执行命令一键下载与安装；
3. 编写配置 — 修改配置文件 console.yml，指定服务监听地址；
4. 启动服务 — 先前台验证，再以后台模式运行；
5. 初始化 — 浏览器访问服务端口，创建管理员账号；
6. 注册集群 — 将 Easysearch 集群接入 Console，开启监控和管理。

部署完成后，你就拥有了一个统一的搜索服务管理中枢，可以在一个界面内完成多集群的监控、告警、安全审计和数据探索。

如果在部署过程中遇到困难，欢迎查阅官方文档。祝你部署顺利！

一、引言

2026 年 6 月 21 日，经过 Bboss 开源社区与极限科技（INFINI Labs）的紧密合作， Bboss v7.5.6 正式发布！

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

二、Bboss Elasticsearch 客户端简介

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

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

核心特性

三、为什么选择 Bboss + Easysearch

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

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

四、快速开始

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

1. 添加 Maven 依赖

<dependency>
    <groupId>com.bbossgroups.plugins</groupId>
    <artifactId>bboss-datatran-jdbc</artifactId>
    <version>7.5.6</version>
</dependency>

2. 配置 Easysearch 连接

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

3. 基础操作

@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<Document> 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/easysearch/main/docs/integrations/third-party/bboss

六、关于 Easysearch

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

1. 国产化自主可控

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

2. 轻量级架构

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

3. 卓越性能表现

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

4. 良好兼容性

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

社区福利

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

引言

上一篇文章里，我们已经完成了 Easysearch 在信创环境下的部署。搜索服务能跑起来只是第一步，要让它真正用于生产，还需要补上“入口治理”这一环。

例如，下面这些问题在生产环境中非常常见：

• 如何防止某个应用或用户发出超大查询请求，把 Easysearch 集群拖垮？
• 如果 Easysearch 某个节点突然宕机，请求能不能自动切换到健康节点，让业务无感知？
• 如何知道每天有多少次查询、哪些查询慢、哪些请求不合法，有没有办法对请求进行审计？

这些正是 INFINI Gateway（极限网关） 擅长解决的问题。本文延续“小白友好”风格，带你完成 Gateway 的安装与验证，为 Easysearch 增加一层高性能、安全、可观测的入口防护。

一、INFINI Gateway 是什么？和 Easysearch 是什么关系？

如果把 Easysearch 比作大型图书馆，那么 INFINI Gateway 就像门口的 “前台总台”。过去读者（应用程序）直接进入书库检索；现在所有请求先经过前台，再转发到书库。这样做的好处很直接：可以缓存热门请求，减少后端压力；可以限制流量，避免集群被突发请求冲垮；还可以记录访问日志，方便审计与分析。

从技术层面讲，INFINI Gateway 的定位如下：

• 高性能数据网关：面向搜索场景设计，请求先在网关完成处理，再转发到后端 Easysearch 集群。
• 代理 + 增强：位于客户端与 Easysearch 之间，可在转发链路中叠加限流、缓存加速、请求审计、结果改写等能力。
• 兼容原生 API：对外接口兼容 Elasticsearch / Easysearch 原生 API，应用只需把连接地址从直连 Easysearch 改为指向网关，无需改业务代码。
• 轻量易部署：基于 Golang 开发，安装包约 10MB，无额外外部依赖。
• 信创兼容认证：已通过华为鲲鹏 Kunpeng 920 兼容性认证，并获得 KUNPENG COMPATIBLE 证书。

整个系列的组件关系如下：

应用程序 → INFINI Gateway（流量入口） → Easysearch（数据存储与检索）

有了 Gateway，你就可以更放心地将搜索服务开放给更多应用和用户，而不必过度担心安全与性能失控问题。

二、部署前置条件

1. 信创环境

• CPU ：鲲鹏 Kunpeng-920、aarch64
• 操作系统：统信服务器操作系统A版 V20

2. 确保 Easysearch 已正常运行

Gateway 本身不存储数据，核心职责是代理与增强 Easysearch。因此部署前请先确认 Easysearch 已启动，并且网络可达：

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

三、部署步骤

步骤 1：下载 INFINI Gateway

下面脚本会自动下载对应平台的 Gateway 最新版本，并解压到 /opt/gateway：

# 一键下载并安装到 /opt/gateway
curl -sSL http://get.infini.cloud | bash -s -- -p gateway -d /opt/gateway

步骤 2：编写 Gateway 配置文件

Gateway 启动依赖 YAML 配置文件，用来声明监听端口、后端 Easysearch 地址和认证信息。进入安装目录后，找到 gateway.yml 并按实际环境修改：

# 按实际情况填写可访问的 Easysearch 地址
LOGGING_ES_ENDPOINT:https://localhost:9200/

LOGGING_ES_USER:admin

LOGGING_ES_PASS:"你的 Easysearch 密码"

# 按实际情况填写可访问的 Easysearch 地址
PROD_ES_ENDPOINT:https://localhost:9200/

PROD_ES_USER:admin

PROD_ES_PASS:"你的 Easysearch 密码"

# 按需设置 Gateway 对外监听端口
GW_BINDING:"0.0.0.0:8000"

步骤 3：启动 Gateway

进入 Gateway 安装目录，执行下面命令启动程序：

# 进入安装目录
cd /opt/gateway

# 运行程序（gateway-linux-arm64 为可执行文件名）
./gateway-linux-arm64

程序启动后，即可通过配置端口访问 Easysearch 服务。

在前台运行模式下，如需停止 Gateway，按 Ctrl+C 即可。

如果希望将 Gateway 作为后台服务运行，可执行：

# 命令中的 gateway-linux-arm64 为可执行文件名
./gateway-linux-arm64 -service install && ./gateway-linux-arm64 -service start

如需卸载服务，执行以下命令：

./gateway-linux-arm64 -service stop

./gateway-linux-arm64 -service uninstall

步骤 4：验证 Gateway 是否正常工作

通过 Gateway 间接访问 Easysearch，确认转发通路正常：

# 通过 Gateway（8000 端口）访问 Easysearch
curl http://0.0.0.0:8000

# 对比直连 Easysearch 的结果
curl -ku admin:你的密码 https://localhost:9200

两条命令返回的 JSON 结果应基本一致。若都能正常响应，说明 Gateway 已成功接管 Easysearch 的访问入口。

如果你的生产环境需要将搜索服务开放给大量应用和用户，建议将 Gateway 纳入标准部署方案。借助 Gateway，你可以更好地保护后端 Easysearch 集群，并获得限流限速、缓存加速、安全防护、审计日志等增强能力，让整体架构更健壮、更安全、更可观测。

如果在部署过程中遇到问题，欢迎查阅官方文档。祝你部署顺利！

作者：小袁
原文：https://infinilabs.cn/blog/2026/gateway-install-at-xc-platform/

一、引言

在上一篇文章《从零到跑起来：Easysearch 信创环境安装全流程》中，我们成功在信创平台上安装并运行起了 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. 进行服务器相关优化

#内核参数优化
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。如果不确定，可以执行下面的命令验证：

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

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

如果还没有安装，可以参考上一篇文章《从零到跑起来：Easysearch 信创环境安装全流程》先行完成。

3. 信创平台信息确认

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

# 查看 CPU 架构
uname -m

# 查看操作系统信息
cat /etc/os-release

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

部署环境如下表中所示：

4. 软件环境

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

5. 网络端口配置

四、部署步骤

步骤 1：下载 Coco Server

# 调整为 Coco 实际要安装的路径
cd /opt

#下载Coco v1.0.0压缩包
curl -O https://release.infinilabs.com/.testing/coco-1.0.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 设置为实际的，参考如下：

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 进行加密存放，避免明文存放到配置文件，减少数据泄露风险

# 调整为 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 以服务方式启动

#安装系统服务（./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 桌面客户端，让团队成员真正体验“一个搜索框搜遍全公司”的高效便捷。

如果在部署过程中遇到任何困难，欢迎查阅官方文档，祝你部署顺利！

一、Easysearch 介绍

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

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

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

二、安装前需知

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

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

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

#查看操作系统信息
cat /etc/os-release

#查看CPU架构
uname -m

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

Easysearch 提供了两种安装方式：

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

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

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

三、安装环境简介

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

1.硬件信息

2.软件环境

3.网络端口设置

四、部署流程

具体细节详见部署手册

步骤1：系统初始化

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

# 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

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

# 创建数据安装目录
mkdir -p /opt/easysearch

# 下载最新版本并安装
curl -sSL http://get.infini.cloud | bash -s -- -p easysearch -d /opt/easysearch

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

步骤3：初始化并启动 Easysearch

# 进入 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 命令快速测试服务是否正常运行：

# 使用初始化时显示的 admin 密码测试连接
curl -ku admin:你的密码 https://localhost:9200

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

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

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

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

进入 ui 界面

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

结语

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