认证
支持用户名密码认证,也支持服务器 IP 白名单。两种方式都在代理用户上配置,每个账号最多可创建 100 个代理用户。
每次连接,网关都要确定两件事:这些流量记在哪个账号上,以及应分配哪类 IP。两者都由代理用户决定。代理用户包含名称、密码、默认网络,可选的流量上限,以及可选的一组免密访问 IP。
用户名与密码
默认方式。客户端以 HANDLE-NAME,即账号标识加代理用户名称(可附加定向参数)作为用户名、代理用户的密码作为密码,走标准的代理认证流程:HTTP 和 HTTPS 下是 Proxy-Authorization: Basic 头,SOCKS5 下是 RFC 1929 定义的用户名/密码方法。凭据写进代理 URL 后,各语言的客户端库都会自动处理。
# 客户端将 user:pass 做 base64 编码,放入 Proxy-Authorization 头
curl -x icn-01.gw.scalardata.ai:7777 \
-U "k7f3q2-acme-country-kr:PASSWORD" \
https://ipinfo.io/json密码为 16 到 128 位可打印 ASCII 字符,不含空格和冒号。在控制台中密码由系统生成,可随时重新生成;通过 API 则可以自行设置。控制台的登录方式(邮件链接或 Google 账号)不能用于网关认证,网关只接受代理用户密码和白名单 IP。
IP 白名单
如果流量来自固定公网 IP 的服务器,可以直接把这些地址绑定到代理用户,省去分发密码的环节。来自白名单 IP 的连接,只对该地址所绑定的代理用户免去密码校验:完全不带凭据时,网关按该代理用户及其默认配置处理请求;需要定向时,发送该代理用户的用户名、不带密码即可。若使用其他代理用户的用户名,仍需提供该用户的密码。
# 白名单服务器发出:不带密码,用户名只用于定向
curl -x icn-01.gw.scalardata.ai:7777 \
-U "k7f3q2-acme-country-kr:" \
https://ipinfo.io/json
# 白名单服务器发出,且完全不带凭据:
# 按该 IP 绑定的代理用户及其默认配置路由
curl -x icn-01.gw.scalardata.ai:7777 https://ipinfo.io/json白名单支持单个 IPv4、IPv6 地址和 CIDR 网段,网段最宽为 IPv4 /24 或 IPv6 /64,每个账号最多 50 个条目;私有和保留地址段不能加入白名单。每个条目只属于一个代理用户。同一账号下各代理用户的条目可以重叠,此时连接归属于范围最小的条目(/24 内的 /32 优先)。其他账号已占用的地址无法添加。可在控制台的 IP 白名单页面维护(添加地址时选择要绑定的代理用户),也可调用白名单接口。
家庭宽带、出口地址不固定的云函数等场景不适合白名单;另外受 NAT 影响,同一公网 IP 后的所有机器会被识别为同一个代理用户。
多个代理用户
一个账号最多可创建 100 个代理用户。每个代理用户都有独立的密码、默认网络、白名单和上限,用量也分别统计,可直接当作成本中心使用。典型划分如下:
acme-prod 住宅网络,密码 A,上限 = 月度预算
acme-staging 住宅网络,密码 B,小额上限
acme-crawler 数据中心网络,密码 C,仅白名单所有代理用户共享账号的余额和订阅,因此像 acme-crawler 这样的数据中心代理用户,只有在账号拥有数据中心订阅时才能传输流量。给代理用户设置的上限,限制的是它每个 UTC 自然月在所有网络上可传输的字节数,并不会额外获得流量。代理用户可在控制台创建,也可通过 API 创建。
轮换凭据
可在控制台或通过 API 修改代理用户的密码。新密码对新建连接立即生效,已建立的连接保持不变。如需断开,请停用该代理用户,其已建立的连接会在数秒内关闭。粘性会话以代理用户加会话 ID 为键,与密码无关,因此进行中的会话在改密后仍保持原 IP。
若怀疑密码泄露,先停用该代理用户(这也会断开其已建立的连接),轮换密码后再重新启用,然后按日查看它的用量,确认是否有异常流量。养成以下两个习惯,可以降低这类风险:
- 每个环境、每个第三方各用一个代理用户,轮换时只影响泄露的那一个。
- 不要把代理 URL 写进日志。不少 HTTP 库在报错时会打印含凭据的完整 URL;长期运行的服务优先使用环境变量或白名单。