全域性 IP 列表

目錄結構

|-- global_ip_lists/
  |-- global_ip_lists.yaml
  |-- ...

YAML 檔案中可以包含一個或多個全域性 IP 列表。

配置說明

引數名資料型別是否必選描述
namestring全域性 IP 列表的名稱,也是該列表的唯一標識
typestringIP 列表的型別,可以是 “ipv4” 或 “ipv6”
itemsarrayIP 地址列表

items 配置

引數名資料型別是否必選描述
ipstringIP 地址

配置示例

- name: global-ip-list1
  type: ipv4
  items:
  - ip: 1.1.1.1
  - ip: 1.1.1.11
- name: global-ip-list2
  type: ipv4
  items:
  - ip: 1.1.1.1
  - ip: 1.1.1.2

此配置定義了兩個全域性 IP 列表,每個列表包含多個 IPv4 地址。

請注意,當前並未支援 IPv6 地址。

使用示例

更新配置到 OpenResty Edge 中:

edge-config https://192.168.1.1 -s -t 2051e780-1897-4ea0-92b4-2c2f0169aa94 -l global_ip_lists -i /root/oredge-configs

從 OpenResty Edge 中匯出配置:

edge-config -u https://192.168.1.1 -s -t 2051e780-1897-4ea0-92b4-2c2f0169aa94 -E -l global_ip_lists

示例中均使用 -l global_ip_lists 來指定只匯入/匯出全域性 IP 列表相關的配置。

注意事項

  1. 全域性 IP 列表是一個全域性配置,為了保持與多個本地配置的相容性,在更新配置時不會執行刪除操作。

  2. 每個全域性 IP 列表必須有一個唯一的名稱。

  3. IP 列表的型別必須是 “ipv4”。

  4. 在新增或更新 IP 列表時,工具會檢查 IP 地址的有效性。

  5. 在更新配置時,工具會比較新舊配置來確定是否需要更新。如果配置有變化,則會執行更新操作。

  6. 在匯入配置時,工具會先檢查配置的有效性,然後再執行新增或更新操作。

  7. 在匯出配置時,工具會格式化 YAML 內容,只包含必要的資訊(名稱、型別和 IP 地址)。

  8. IP 列表可以被其他功能引用,如“頁面規則 - 條件”等。

相關文件