全部產品
Search

搜尋本產品

    Elasticsearch：通過Postman串連叢集

    文件中心

    Elasticsearch：通過Postman串連叢集

    更新時間：Mar 04, 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