代理 API 提取链接与提取源接入

新建链接模板并填写参数

在「代理 → 提取源」选择「新建提取源」，方式选「链接模板」。填写名称、提取地址和默认协议，按照代理商接口说明选择请求方式。提取链接本身是一个 HTTP 或 HTTPS 地址，接口返回的代理协议则可能是 HTTP、HTTPS 或 SOCKS5，这两处协议要分别确认。

接口要求 POST 时，填写请求体；要求额外认证头时，在「请求头」中添加。把密钥定义为参数并标记「密钥」，可以在维护配置时单独修改。直接写在链接中的密钥也是链接内容的一部分，后续导出或分享时不会因为取消携带密钥参数就自动删除。

不要把提取地址直接当作固定代理主机。固定代理保存的是连接地址和端口，提取源保存的是取得这些连接信息的方法。两类入口的区别可参考代理配置教程。

用地区参数控制提取请求

在模板中插入地区占位符后，可以为提取源选择省份和城市。内置参数包含省市简称及国家行政区划代码，也提供提取个数、时间戳和随机值。地址中的替换值会进行 URL 编码，参数名和位置仍需与代理商要求一致。

地区名称与地区代码是不同的数据。接口需要名称时传名称，需要代码时传对应代码；代理商采用自己的地区编码时，需要自行映射，不能直接假定与内置代码相同。测试时分别核对最终请求、接口返回和出口检测结果，不能只看界面选择的城市。

日常打开环境不会在所选地区没资源时自动改成其他地区。流程插件可以显式指定退到全省或不限地区的规则；这属于插件配置，不能用来推断普通环境打开时会发生同样的退回。

选择自动识别或指定返回字段

「返回格式」可选「自动识别」「文本」「JSON」和「正则」。自动识别会尝试解析文本或 JSON；文本可以包含多条代理，常见写法包括地址加端口、地址端口后带账号密码，以及账号密码放在地址前面的代理串。返回值缺少协议时使用提取源的默认协议。

JSON 常见地址字段 ip、host、sever，端口字段 port，以及常见账号密码字段可以识别。字段名特殊时，切换 JSON，指定「列表路径」「地址路径」和「端口路径」；嵌套路径用点号或数组下标表示，不能把整个返回对象误当成代理列表。

自动识别支持外层到期字段；需要读取列表条目各自的到期时间时，使用 JSON 解析并核对到期时间字段。正则适合固定文本结构，需要包含地址与端口的命名分组。下面是格式示例，地址和凭据都应替换为实际返回的数据。

203.0.113.10:8080
203.0.113.11:1080:user:pass
socks5://user:pass@203.0.113.12:1080

测试提取与检测出口

编辑器右侧的「测试」面板可以直接使用当前填写的配置，不必先保存。选择地区和个数，执行测试，查看代理地址、到期时间、请求记录及返回内容；开启「检测出口」后，再核对实际出口与地区。已提取到地址和出口可以连通是两个不同结果。

接口返回 HTTP 成功状态不一定表示业务提取成功。按真实返回设置「成功条件路径」「成功值」及「失败说明路径」，使余额、白名单或密钥问题能够显示出来。列表有记录但地址端口识别失败时，应修正字段映射；空列表则要核对该地区是否有资源。

失败会区分没资源、太频繁、临时失败和配置问题。先查看原始说明，再处理对应原因：配置问题修正参数或认证，频率问题调整调用安排，网络问题检查连接。需要核对特定返回结构时，可参考闪臣代理接入。

把提取源绑定到环境

测试通过后保存提取源。在代理库新建代理，或编辑环境的自定义代理，将类型选为「提取式」，提取方式选「提取源」，再选择源、地区和何时提取。需要长期维护多个环境时，先理清各账号使用的提取源及地区，不要用环境名称代替实际代理绑定。

「每次打开都提取」会在打开时重新请求；「上次的 IP 失效时才提取」在可复用且检测可用时继续使用已有代理。重新请求不保证得到不同 IP，提取源也不保证出口长期固定。选择方式前，先确认业务是否需要稳定出口，可查看静态住宅与动态住宅 IP。

提取请求从本机直接发出。使用白名单认证时，需要覆盖实际发起请求的电脑出口；换电脑或交给团队成员后应重新核对。代理返回信息里的用户名密码，与提取接口自身使用的密钥也应分别检查。

用对接脚本处理签名与多次请求

接口要计算签名、先换令牌再提取，或返回结构需要额外转换时，选择「对接脚本」。编辑器支持「插入示例」和「从文件导入」，脚本通过固定的 acquire(query, ctx) 入口接收地区与个数，返回代理地址、端口及可选的认证和到期时间。

脚本在成员本机运行，别人编写、修改、导入或分享来的脚本，需要在当前电脑先点「确认脚本」。修改后也可能需要重新确认。流程插件可以调用已接入的提取源，按失败分类决定后续处理；相关入口见自动化功能。

团队共享与配置转移

提取源属于团队共享配置，新建、修改和删除需要「管理代理库」权限。一个源可以供多个代理和环境引用，修改前应确认使用范围；仍被引用的提取源需要先解除引用才能删除。成员能使用提取源，不等于所有成员都能编辑定义。

勾选提取源后可「导出」为 JSON，另一个团队从「导入」选择文件。默认不携带密钥参数值，接收方补齐后再测试；选择携带密钥时默认加密。导入预览会显示已存在或同名冲突，可按需要新建改名、覆盖或跳过。

也可以生成分享口令，接收方在「代理 → 提取源 → 领取分享」预览并领取。领取复制的是当时的定义，之后两边分别维护；撤销口令阻止后续领取，不会收回已有副本。生成和领取都需要管理代理权限，成员分工可结合团队协作设置。

常见问题