引言

上一篇文章里，我们已经完成了 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 介绍

在动手安装之前，我们先花一点时间了解这个工具。 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 级生产集群的平滑扩展，无论是个人学习还是企业级业务，都能灵活适配。如果在操作过程中遇到任何问题，建议优先查阅官方文档。预祝你在信创平台的探索之旅顺利！

近日，极限数据 (北京) 科技有限公司（以下简称：极限科技）旗下的软件 INFINI Easysearch 搜索引擎软件 V1.0 通过统信 UOS 服务器操作系统 V20 认证。

此次兼容适配基于统信 UOS 服务器操作系统 V20，联合国产 CPU：海光 5000、海光 7000、兆芯 KH-30000、兆芯 KH20000、兆芯 ZX-C+ 等系列处理器，经过共同严格测试表明 INFINI Easysearch 搜索引擎软件 V1.0 整体运行稳定，满足功能及兼容性测试要求，并获得通用软硬件适配认证中心联合认证证书。

统信软件是以“打造中国操作系统创新生态”为使命的中国基础软件公司。基于国产芯片架构的操作系统产品已经和龙芯、飞腾、申威、鲲鹏、兆芯、海光等芯片厂商开展了广泛和深入的合作，与国内各主流整机厂商及软件厂商展开了全方位的兼容性适配工作。

极限科技研发的 INFINI Easysearch 是一个分布式的近实时搜索与分析引擎，同时也是一款具备自主可控的分布式近实时搜索型数据库产品，具备高性能、高可用、弹性伸缩、高安全性等特性，具备支持丰富的个性化搜索及聚合分析能力，可部署在物理机、虚拟机、容器、私有云和公有云，能承载 PB 级别的海量业务数据，为金融核心系统、运营商、制造业和政企业务系统提供安全、稳定、可靠的快速检索和实时数据探索分析能力，可满足不同业务场景的各项复杂需求。

此次通过统信 UOS 的兼容适配联合认证，标志着极限科技在支持国产化方面又迈出关键一步。此外，Easysearch 也实现了对麒麟、欧拉等国产操作系统的支持。未来，极限科技将积极参与国产创新技术生态的建设，坚持自主可控安全可靠，深化对国产化软硬件技术栈的支持能力，为用户提供更加优质、稳定、高效、安全的产品与服务。

关于极限科技（INFINI Labs）

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

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

详情参见官网：https://www.infinilabs.com