全域性 IP 列表
目錄結構
|-- global_ip_lists/
|-- global_ip_lists.yaml
|-- ...
YAML 檔案中可以包含一個或多個全域性 IP 列表。
配置說明
引數名 | 資料型別 | 是否必選 | 描述 |
---|---|---|---|
name | string | 是 | 全域性 IP 列表的名稱,也是該列表的唯一標識 |
type | string | 是 | IP 列表的型別,可以是 “ipv4” 或 “ipv6” |
items | array | 是 | IP 地址列表 |
items 配置
引數名 | 資料型別 | 是否必選 | 描述 |
---|---|---|---|
ip | string | 是 | IP 地址 |
配置示例
- 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 列表相關的配置。
注意事項
全域性 IP 列表是一個全域性配置,為了保持與多個本地配置的相容性,在更新配置時不會執行刪除操作。
每個全域性 IP 列表必須有一個唯一的名稱。
IP 列表的型別必須是 “ipv4”。
在新增或更新 IP 列表時,工具會檢查 IP 地址的有效性。
在更新配置時,工具會比較新舊配置來確定是否需要更新。如果配置有變化,則會執行更新操作。
在匯入配置時,工具會先檢查配置的有效性,然後再執行新增或更新操作。
在匯出配置時,工具會格式化 YAML 內容,只包含必要的資訊(名稱、型別和 IP 地址)。
IP 列表可以被其他功能引用,如“頁面規則 - 條件”等。