跳至正文

定向语法

国家、城市、ASN、会话都是代理用户名中的参数。本页给出完整语法。

网关从用户名中读取定向条件,因此一套端点和密码即可覆盖所有网络和城市。参数以 key-value 对的形式追加在代理用户的名称之后,顺序不限。键以及 country、city 的取值不区分大小写,会话 ID 则区分大小写。未知的键会直接返回 407,而不会被静默忽略。

目前所有 IP 均位于韩国。网关只接受 country-kr 这一个国家值,city 和 asn 负责在其范围内进一步收窄。

[res-|isp-|dc-]HANDLE-NAME[-parameter-value]...

  res-|isp-|dc-  可选的网络前缀
  HANDLE         账号标识(6 位小写字母和数字),可在控制台
                 及 GET /api/v1/account 的返回结果中查看
  NAME           代理用户名称
  parameter      下表中的任一键,不区分大小写
  value          字母和数字,不含空格和标点;
                 不区分大小写(会话 ID 除外)

参数

参数取值示例说明
country-XXISO 3166-1 两位字母代码country-kr所有网络可用。目前只接受 kr,因为全部 IP 都在韩国,其他代码返回 407。不带该参数时出口 IP 同样是韩国的,但建议始终带上,日后新增国家时用户名的含义不会改变。
city-nameseoul、gyeonggi、busan、incheon、daegu、daejeon、gwangju、ulsan 之一,不区分大小写city-seoul必须与 country 同时使用。按上游代理池中标注的城市匹配,或交由支持城市定向的上游供应商处理;没有匹配的上游时返回 502。控制台列出了全部可用的城市取值。
asn-NNNN自治系统号,1 到 4294967295asn-64496仅限住宅网络:与 isp-、dc- 前缀同用,或用于其他网络的代理用户时,返回 407。将出口 IP 锁定在某一家韩国 ISP 的网络内。ipinfo.io 返回的 org 字段会显示所得 IP 所属的 ASN。
session-ID自定义的字母和数字,最多 64 位,区分大小写session-a1b2复用同一 ID 的请求保持同一 IP。见会话。
sessduration-MIN分钟数,1 到 30sessduration-10会话保持 IP 的时长,仅与 session 同时使用时有效。不带时按代理用户的默认值。
res- / isp- / dc-网络前缀dc-k7f3q2-acme置于用户名最前面、账号标识之前,覆盖代理用户创建时绑定的网络。res- 流量从住宅余额扣费;isp-、dc- 需要该网络有生效中的订阅,且只从分配给你账号的 IP 发出。

需要注意的规则

  • 参数只会收窄 IP 池。只带 country-kr 时匹配网络中的全部 IP,city 加 asn 可能只剩寥寥几个。无任何匹配时,网关返回 502,不会自动放宽条件。
  • city 依赖 country。目前 country 始终是 country-kr,设此规则是为了在新增国家后,同一个用户名仍指向同一地点。
  • 城市和 ASN 按上游代理池中标注的标签匹配,或交由自身支持定向的上游供应商处理。使用自有地理定位数据库的网站,仍可能把出口判定到邻近城市。
  • 每次连接都必须发送完整的用户名,包括前缀和全部参数。除会话之外,网关不在连接之间保留任何状态。
  • 连字符之间的每一段都不能为空:开头、结尾或连续出现的连字符会返回 407。
  • 只有通过认证的请求(密码正确,或来自该代理用户的白名单地址),407 才会指明出错的参数。在此之前,用户名有任何问题都只返回笼统的 invalid credentials,外部无法借此试探用户名。

示例

以下均为完整请求。将 k7f3q2 替换为自己的账号标识,acme 替换为自己的代理用户,PASSWORD 替换为对应密码。

任意韩国 IP,每个连接重新选择

curl -x icn-01.gw.scalardata.ai:7777 -U "k7f3q2-acme-country-kr:PASSWORD" https://ipinfo.io/json

仅首尔

curl -x icn-01.gw.scalardata.ai:7777 -U "k7f3q2-acme-country-kr-city-seoul:PASSWORD" https://ipinfo.io/json

釜山,单一 IP 最长保持 30 分钟

curl -x icn-01.gw.scalardata.ai:7777 -U "k7f3q2-acme-country-kr-city-busan-session-b9x4m-sessduration-30:PASSWORD" https://ipinfo.io/json

至少每 5 分钟用同一 ID 连接一次;连续 5 分钟没有连接的会话会提前释放。

按 ASN 指定单一 ISP

curl -x icn-01.gw.scalardata.ai:7777 -U "k7f3q2-acme-country-kr-asn-64496:PASSWORD" https://ipinfo.io/json

数据中心网络,覆盖默认网络

curl -x icn-01.gw.scalardata.ai:7777 -U "dc-k7f3q2-acme-country-kr:PASSWORD" https://ipinfo.io/json

需要生效中的数据中心订阅;流量从分配给你账号的 IP 发出。