获取 EdgeOne 回源节点 IP

最近更新时间：2024-06-25 10:26:32

我的收藏

本页目录：

获取方式
请求示例

获取 EdgeOne 的回源节点 IP，可以用于在源站防火墙中将 EdgeOne 的回源节点 IP 设为白名单，只允许固定来源（IP）请求源站，以实现对源站的保护。
获取方式
1. 通过浏览器或 curl 命令直接访问 https://api.edgeone.ai/ips。即可获取所有 EdgeOne 在全球可用区内的 IPv4 和 IPv6 回源节点 IP 地址，响应结果为 UTF-8 编码的纯文本，一行一个 IP 段。
2. 如果您只需要获取指定区域或指定 IP 地址类型的回源节点 IP，您也可以通过携带指定查询字符串（QueryString）来筛选回源节点 IP，支持的查询字符串如下：
查询字符串
 释义
 version
指定获取的回源节点 IP 地址类型，参数取值如下： 
v4：所有的 IPv4 的回源节点 IP 地址。
v6：所有的 IPv6 的回源节点 IP 地址。
不带此参数的时候默认返回所有IPv4 和 IPv6 的 IP 地址。
area
指定获取的回源节点 IP 区域，参数取值如下：
global：全球可用区内所有回源节点 IP 地址。
mainland-china：中国大陆可用区内的回源节点 IP 地址。
overseas：全球可用区（不含中国大陆）内的所有回源节点 IP 地址。
不带此参数的时候默认返回全球可用区内所有回源节点 IP 地址。
说明：
1. 一般情况，建议可以根据您的站点服务区域选择获取对应的区域的回源节点 IP 地址即可。例如：站点服务区域为中国大陆可用区，获取中国大陆可用区内的回源节点 IP 地址即可，其他服务地域同理。
2. 本功能与 源站防护 功能互斥，若您需要通过本文档方法获取最新回源 IP，请确定您已关闭业务 源站防护 功能。
3. 因为底层资源变更比较频繁且时间不固定，建议您每小时定时请求一次此接口 https://api.edgeone.ai/ips 以获取回源 IP 的增删情况，若检测到有变更，请及时将新的回源 IP 添加到源站防火墙配置中/删除已下线的回源 IP，以避免因回源 IP 更新造成的回源失败。
请求示例
若您想获得全球可用区（不含中国大陆）的所有 IPv6 回源节点 IP，可以通过在请求的 URL 中携带 version=v6&area=overseas 来查询此条件下的回源 IP 地址，具体的 URL 为： https://api.edgeone.ai/ips?version=v6&area=overseas 。
﻿
响应结果示例如下（此结果仅为示例，具体回源 IP 请参照实时请求结果）：
240d:c010::/28
2001:ee0:324b:100::/64
2405:3200:101:63::/64
2405:4800:a601::/64
2602:ffe4:c02:1001::/64
2602:ffe4:c12:101::/64
2602:ffe4:c12:105::/64
2602:ffe4:c15:124::/64
2602:ffe4:c18:c003::/64
2602:ffe4:c18:c201::/64
2602:ffe4:c18:c203::/64
2602:ffe4:c27:1003::/64
2604:980:4002:2::/64
2604:980:5003:2::/64
2604:980:7002:6::/64
2a02:b60:2001::/64
﻿

上一篇: 旧版源站组兼容相关问题下一篇: 概述

查询字符串	释义
version	指定获取的回源节点 IP 地址类型，参数取值如下： v4：所有的 IPv4 的回源节点 IP 地址。 v6：所有的 IPv6 的回源节点 IP 地址。不带此参数的时候默认返回所有IPv4 和 IPv6 的 IP 地址。
area	指定获取的回源节点 IP 区域，参数取值如下： global：全球可用区内所有回源节点 IP 地址。 mainland-china：中国大陆可用区内的回源节点 IP 地址。 overseas：全球可用区（不含中国大陆）内的所有回源节点 IP 地址。不带此参数的时候默认返回全球可用区内所有回源节点 IP 地址。