全部产品
Search

搜索本产品

    检索分析服务Elasticsearch版：通过Postman连接集群

    文档中心

    检索分析服务Elasticsearch版：通过Postman连接集群

    更新时间：Mar 03, 2026

    本文介绍如何通过Postman连接阿里云Elasticsearch（ES）集群。

    准备工作

    获取集群连接地址

    您可以通过VPC私网或公网地址连接到ES集群。

    • VPC私网连接地址：通过VPC私网地址访问ES集群，延迟低，稳定性高。该地址在集群创建成功后默认开启。

    • 公网连接地址：通过公网访问ES集群，需手动开启。

    如何开启公网访问：

    1. 登录ES控制台，进入实例基本信息页面。

    2. 单击左侧导航栏 配置与管理>安全配置，开启公网访问。待集群状态由生效中变更为生效时，表示公网访问已成功开启。

      image

      重要

      公网地址会降低ES集群的安全性，如果使用公网地址，请务必配置IP白名单，并在使用完毕后及时关闭公网访问。

    设置IP白名单

    为保障集群安全，您需要将待访问设备的IP地址加入ES集群的VPC私网或者公网白名单，该IP地址所属的设备才能访问ES集群。

    1. 获取待访问设备IP。

      您可以参照以下场景，获取待访问设备的IP地址。

      场景

      需获取的IP地址

      获取方式

      在本地设备中连接ES集群

      本地设备公网IP。

      如果本地设备位于局域网（如家庭或公司网络）内，需将该局域网的公网出口IP地址添加到ES集群的公网白名单中。

      通过curl ipinfo.io/ip查询本地设备公网IP。

      在不同VPC的ECS实例中连接ES集群

      ECS实例的公网IP

      登录ECS控制台，在实例列表查看。

      在相同VPC的ECS实例中连接ES集群

      ECS实例的私网IP

      登录ECS控制台，在实例列表查看。

    2. 将获取到的IP地址添加到白名单分组中。

      1. 登录ES控制台，进入实例基本信息，单击左侧导航栏 配置与管理>安全配置，单击修改在弹窗中设置VPC私网或者公网访问白名单。

        image

      2. 单击default分组右侧的配置 ，在弹出的对话框中添加VPC私网或者公网白名单。单个集群最多可配置300个IP或者IP网段，多个IP或者IP网段之间用英文逗号隔开，且逗号前后不能有空格。

        • 也可单击新增IP白名单分组，自定义分组名称。

        • 白名单分组仅用于IP地址管理，不影响访问权限。所有分组内的IP地址权限相同。

        image

        配置类别

        格式和示例值

        重要注意事项

        IPv4地址格式

        • 单个IP：192.168.0.1

        • 网段：192.168.0.0/24

        • 禁止访问：127.0.0.1

        • 允许所有访问：0.0.0.0/0

          重要

          存在高危风险，强烈建议不要配置 0.0.0.0/0。

          部分集群版本（如7.16/8.5）和地域不支持 0.0.0.0/0，请以控制台界面或者报错提示为准。

        IPv6地址格式

        (仅v2部署架构且所属地域为杭州的集群支持)

        • 单个IP：2401:XXXX:1000:24::5

        • 网段：2401:XXXX:1000::/48

        • 禁止所有访问：::1

        • 允许所有访问::/0

          重要

          存在高危风险，强烈建议不要配置 ::/0。

          部分集群版本不支持 ::/0，请以控制台界面或者配置提示信息为准。

      3. 配置完成后，单击确认。

        image

    连接集群

    本文以Postman 11.61.1版本为例介绍如何连接ES集群，不同版本的界面可能存在一定差异。

    1. 创建Workspace和Collection

    1. 在您的设备中下载并安装Postman。

    2. 登录Postman控制台，单击上方导航栏Workspaces，在弹出页面中单击Create Workspace。

      image

      为方便后续识别，将名称修改为es-workspace。

      image

    3. 创建名为ES Collection的集合。

      image

      集合的名称修改为ES Collection。

    2. 配置认证信息

    为了避免在每个请求中重复输入密码，建议在Collection级别配置认证。

    1. 选择您刚创建的ES Collection，单击Authorization页签，配置Authorization。

      • Auth Type：选择Basic Auth。

        如果同一个集合下所有请求使用相同认证，建议在集合级配置授权，将Auth Type配置为Inherit auth from parent，子请求继承设置。

      • Username：默认访问用户名为elastic，该用户具有集群最高权限（可理解为管理员账户）。

        出于安全考虑，不建议在生产环境中直接使用此默认管理员账户，您可以通过Elasticsearch X-Pack的RBAC（Role-based Access Control）机制，自定义角色并分配权限，然后将角色分配给用户，实现权限精细化管控，具体操作请参见通过Elasticsearch X-Pack角色管理实现用户权限管控。

      • Password：Username对应的密码。

    2. 配置完毕后单击右上角Save保存。

    3. 发送连接请求

    1. 单击集合名称ES Collection，然后右键选择Add request，将请求的名称修改为ES Request。

    2. 在GET输入框中输入连接请求信息，格式为：http://<ES集群连接地址>:<端口号>。

      例如通过ES公网地址连接，格式为：http://es-cn-xxxxxxxxxxxxxxxxx.public.elasticsearch.aliyuncs.com:9200。

    3. 单击 Send 发送请求。

      返回状态码200即表示您已通过Postman成功连接到ES集群，可以继续发送其他API请求来管理您的集群了。

      image