配置代理 API
代理API适用于服务商通过提取链接返回可用代理地址的场景。保存时，客户端会访问提取链接并从文本响应中获取 IPv4:端口；因此提取链接必须可访问，且返回内容中必须包含有效的 IPv4 地址和端口。
添加代理 API
在代理API页面点击添加代理，填写代理名称、协议、提取方式和提取链接，再执行检查链接。保存时会再次提取当前 IP 和端口。
| 字段 | 说明 |
|---|---|
名称 | 必填，用于识别该提取链接 |
代理协议 | 可选择 HTTP、HTTPS 或 SOCKS5 |
IP查询渠道 | 当前可选择 ip2location |
IP协议 | 当前仅支持 IPv4 |
提取方式 | 每次打开环境都提取新IP，或仅当上次提取的IP失效时才重新提取 |
提取链接 | 必须以 http:// 或 https:// 开头，并返回包含 IPv4:端口 的文本内容 |
关联环境 | 可在保存时多选已有环境 |
备注 | 记录非敏感说明，不要粘贴提取链接中的密钥或令牌 |
| 编号 | 功能 | 说明 |
|---|---|---|
1 | 名称 | 保存前必须填写，建议体现服务商或使用场景 |
2 | 代理协议 | 与提取到的代理实际协议一致 |
3 | 查询与 IP 协议 | 当前查询渠道为 ip2location，IP 协议为 IPv4 |
4 | 提取方式 | 决定启动关联环境时重新请求提取链接的时机 |
5 | 提取链接 | 只接受带 HTTP 或 HTTPS 协议的有效 URL |
6 | 检查链接 | 验证链接能否返回可解析的 IPv4:端口 |
7 | 关联环境 | 将该 API 代理直接关联到已有环境 |
8 | 备注 | 记录用途，不暴露链接中的认证参数 |
检查链接和保存时的 IP 提取都需要桌面客户端。网页端不能执行本机提取检查。
理解提取方式
| 提取方式 | 适合的服务商策略 | 行为 |
|---|---|---|
每次打开环境都提取新IP | 每次请求应获得新的出口 IP | 每次启动关联环境时请求提取链接 |
仅当上次提取的IP失效时才重新提取 | 希望尽量复用当前 IP | 优先使用已保存 IP，检测不可用后再请求新 IP |
选择前先确认服务商的换 IP 规则和访问频率限制。不要用频繁提取的策略去访问限频接口。
注意代理 IP 有效期
代理 API 通常提供动态代理，每个 IP 都有使用时长限制。环境启动后，即使当前代理已经过期，也不会在运行期间自动获取新 IP；需要重启环境，客户端才会按配置的提取策略更新代理 IP。使用前请确认服务商规定的 IP 有效时长，并合理安排环境的使用和重启时间。
若您的业务要求代理不可变更，请不要使用动态代理。
检测和更新 IP
在列表中点击检测代理时，客户端会先检测已保存的 IP 和端口。当前 IP 可用时，只更新检测状态；检测失败时，客户端会重新请求提取链接，解析出新的 IPv4:端口，保存后再检测一次。
若链接本身无法返回可解析地址，列表会提示提取失败。此时应检查链接是否完整、是否需要服务商白名单、响应是否为文本，以及其中的端口是否在 1-65535 范围内。
维护记录
代理 API 列表支持按 ID、名称、备注和协议筛选。可直接编辑名称、备注或协议；完整编辑表单可修改提取链接、提取方式和关联环境。删除前确认没有环境仍依赖该代理。