更新时间：2025-11-25 GMT+08:00
配置KooSearch文档问答服务集群路由
当KooSearch服务需要访问客户端或其他服务（如MaaS）时，如果KooSearch与目标服务位于不同VPC，默认无法直接通信。此时需要配置KooSearch路由打通网络。
- 建立VPC对等连接：打通两个VPC之间的网络。
- 配置KooSearch集群路由：在KooSearch服务添加客户端的路由信息，允许KooSearch访问客户端。
- 验证网络连通性：启动业务确认网络连通性。
配置集群路由有以下优势：
- 提升跨VPC通信性能：通过路由表直接指定流量路径，避免绕行公网。
- 安全通信保障：基于VPC对等连接实现私有网络互通，数据不经过公网。
- 灵活管理访问策略：可自定义开放特定子网的访问权限。
- 支持混合云架构：实现不同VPC环境下的服务互联。
约束限制
配置集群路由时，可能导致业务网络异常，建议在业务空闲时操作。
前提条件
- 确认KooSearch处于“可用”状态，集群配置的安全组的入方向规则放通了9200端口。
- 确认客户端的状态正常，服务器配置的安全组的出方向规则放通了9200端口。
建立VPC对等连接
配置集群路由之前要先在服务端和客户端的VPC之间建立网络连接，即VPC对等连接。
- 当KooSearch和客户端在相同账户下时，请参见创建相同账户下的对等连接。
- 当KooSearch和客户端在不同账户下时，请参见创建不同账户下的对等连接。
其中，对端VPC的信息填写KooSearch服务所在的VPC，本端VPC的信息填写客户端所在的VPC。
在添加VPC对等连接路由时，可以根据业务需要配置路由目的地址。
如果KooSearch服务和客户端使用的是同一个安全组，则默认不用配置对等连接两端VPC内实例的安全组规则。
配置KooSearch集群路由
在KooSearch服务配置客户端的路由网段，允许KooSearch访问客户端。
- 进入KooSearch服务详情页面。
- 登录云搜索服务管理控制台。
- 在左侧导航栏选择“KooSearch>KooSearch文档问答”，进入KooSearch服务列表。
- 选择目标服务，单击服务名称，进入服务详情页。
- 单击“集群路由”后面的“添加路由”。
- 在“添加路由”弹窗中，配置路由信息。
表1 添加路由 参数
说明
ip地址
填写客户端或其他KooSearch需要访问的服务器IP地址或网段，例如“10.10.1.0”。
子网掩码
填写“ip地址”对应的子网掩码。
子网掩码必须与IP地址的网段匹配，即：- 子网掩码的网络位（1的部分）必须覆盖IP地址的网络位。
- IP地址的主机位（0的部分）必须在子网掩码定义的主机范围内。
子网掩码的范围不宜过大，避免不必要的IP暴露或资源浪费。通常建议使用 /24（即 255.255.255.0），适用于大多数内部网络场景。
- 单击“确定”添加路由。
添加完成后，单击“查看路由”，可以查看已添加的路由信息；单击“添加路由”，可以继续增加路由信；单击“删除路由”，选择路由后输入DELETE，单击“确定”即可删除路由。
验证网络连通性
由于KooSearch访问客户端无法直接验证，请在路由配置完成后，启动业务，如果业务访问正常，表示路由配置成功。
父主题： 管理KooSearch文档问答服务
