全部產品
Search
文件中心

ApsaraDB RDS:設定白名單

更新時間:Jul 18, 2025

新建立的RDS SQL Server執行個體預設禁止外部裝置訪問。為了確保安全性,您需要設定IP白名單,僅允許可信IP訪問執行個體。建議在建立執行個體後立即設定並定期維護白名單,以提升訪問安全性。設定白名單操作不會影響RDS執行個體的正常運行。

其他引擎設定白名單請參見:

使用情境

通常需要設定IP白名單的情境如下:

  • 建立RDS執行個體後,您需要將外部IP地址添加至白名單中,以便外部裝置能夠正常訪問該執行個體。

  • 當資料庫連接異常時,您可以檢查白名單設定是否正確。

不同串連情境下,IP白名單的設定請參見下表。

串連情境

網路類型

IP白名單設定

ECS執行個體和RDS執行個體串連

處於相同Virtual Private Cloud內(推薦)

添加ECS執行個體私人IP地址。

處於不同Virtual Private Cloud內

不同專用網路的執行個體無法內網互連。您可以將兩個執行個體切換至同一個VPC下,然後在IP白名單中添加私人IP地址。

ACK叢集的容器和RDS執行個體串連

處於相同Virtual Private Cloud內(推薦)

  • 當ACK叢集的容器網路外掛程式為Flannel時,添加應用程式所在的節點IP。

  • 當ACK叢集的容器網路外掛程式為Terway時,添加應用程式所在的Pod IP。

您可以在目標ACK叢集的容器組頁面,查Pod IP和節點IP。

處於不同Virtual Private Cloud內

不同專用網路的執行個體無法內網互連。您可以將兩個執行個體切換至同一個VPC下,然後在IP白名單中添加應用程式所在的ACK叢集對應的IP地址。

  • 當ACK叢集的容器網路外掛程式為Flannel時,添加應用程式所在的節點IP。

  • 當ACK叢集的容器網路外掛程式為Terway時,添加應用程式所在的Pod IP。

雲外主機串連RDS執行個體

在IP白名單中添加雲外主機的公網IP地址

說明

雲外主機的應用程式中使用RDS執行個體的外網串連地址。

注意事項

  • 單個執行個體最多支援50個IP白名單分組。

  • 預設的IP白名單分組(default )不能刪除,只能清空。預設的IP白名單為127.0.0.1,表示任何IP均無法訪問該RDS執行個體。

  • 請勿修改或刪除系統自動產生的分組,避免影響相關產品的使用。例如ali_dms_groupDMS產品IP地址白名單分組)、hdm_security_ipsDAS產品IP地址白名單分組)。

    重要

    為防止誤修改或刪除白名單分組,2020年12月之後的建立執行個體,hdm_security_ips白名單分組對使用者不可見。

操作步驟

  1. 訪問RDS執行個體列表,在上方選擇地區,然後單擊目標執行個體ID。

  2. 在左側導覽列單擊白名單與安全性群組

    白名單設定頁面,可查看當前的IP白名單模式。

    說明

    較早建立的執行個體可能採用高安全模式。新建立的執行個體都採用通用白名單模式。

  3. 單擊新增白名單分組,填寫分組名稱並把應用伺服器IP地址添加至白名單中,單擊確定

    說明
    • 您也可以單擊default分組右側的修改,變更組內白名單。

    • 多個IP地址用半形逗號(,)隔開,且逗號前後不能有空格,例如192.XXX.XXX.1,172.XXX.XXX.9

    • 單個執行個體最多添加1000個IP地址或IP段。如果IP地址較多時,建議將零散的IP合并為IP段,例如10.10.10.0/24。

    • 如果擷取的白名單模式是通用模式,則無額外注意事項。如果是高安全模式,需注意

      • 把公網IP或傳統網路ECS執行個體私網IP添加至傳統網路分組。

      • 把專用網路ECS執行個體私網IP添加至專用網路分組。

  4. (可選)在新增白名單分組彈窗中,單擊載入ECS內網IP,可將當前阿里雲帳號下所有ECS執行個體的IP地址快速添加到白名單中。添加白名單分組

下一步

串連RDS SQL Server執行個體

附錄:應用伺服器IP擷取方法

確認您當前的情境,根據情境擷取正確的IP地址,並將其添加至白名單。

情境

需擷取的IP地址

如何擷取

滿足內網訪問的條件

ACK叢集的容器的對應IP

  • 當ACK叢集的容器網路外掛程式為Flannel時,添加應用程式所在的節點IP。

  • 當ACK叢集的容器網路外掛程式為Terway時,添加應用程式所在的Pod IP。

您在目標ACK叢集的容器組頁面,查Pod IP和節點IP。

ECS執行個體私網IP

  1. 點此開啟ECS執行個體列表

  2. 在頂部選擇執行個體所在地區。

  3. 在執行個體列表可以看到私網IP和公網IP。

    image

需要通過ECS執行個體訪問RDS執行個體,但不滿足內網訪問的條件

ECS執行個體公網IP

需要通過本地裝置訪問RDS執行個體

本地裝置公網IP

在本地裝置中,使用搜尋引擎(如百度)搜尋IP。

說明

該方式擷取的IP地址若不準確,請通過其他方案擷取。

常見問題

通過RDS控制台添加白名單時報錯InvalidSecurityIPListLength.Malformed

問題描述

使用者通過RDS控制台添加白名單時,可能會出現如下報錯:

錯誤碼:InvalidSecurityIPListLength.Malformed
報錯資訊(中文):安全IP地址不在可用範圍內或已被佔用。
報錯資訊(英文):The security ip address is not in the available range or occupied.

解決方案

  • 原因1:單個白名單分組中最多支援1000個IP地址/段,新增的IP超過了限制。

    解決方案:確保單個白名單分組中的IP地址或IP段數量不超過1000個。建議將零散的IP地址合并為CIDR格式的IP段(如192.168.1.0/24),以減少佔用數量。

  • 原因2:添加的IP白名單包含非法地址。

    解決方案:確保輸入的IP地址合法,推薦使用標準CIDR格式(如10.23.12.0/24),掩碼範圍為1~32。若需添加多個IP地址,請使用英文逗號(,)分隔。

  • 原因3:與已存在的白名單存在衝突。例如,在RDS MySQL中192.168.1.8會與192.168.1.1/8發生衝突。

    解決方案:根據實際需求合理規劃並添加白名單,避免與現有規則產生重疊或衝突。

說明

請勿刪除預設分組default(包含127.0.0.1),也不要修改系統分組(如ali_dms_grouphdm_security_ips),以免影響系統功能或串連安全性。

相關API