API 白名单接入

除了账密认证，动态住宅 IP、动态机房 IP、移动手机 IP 都支持 API 白名单接入：将设备的公网出口 IP 加入白名单后，通过接口提取“IP:端口”列表，无需填写用户名和密码。

适合服务器、固定办公网络等出口 IP 固定的环境，或不方便在每个工具里逐一配置账密的场景。

与账密白名单的区别

• API 白名单接入（本页）：一种免账密的使用方式，白名单内的设备可直接提取 IP 使用。
• 账密白名单：一种安全限制，在账密认证基础上限制允许连接的来源 IP。

与账密认证的区别

	账密认证	白名单接入
认证方式	用户名 + 密码	本地公网 IP 加入白名单，免账密
使用形式	固定网关 + 参数化用户名	从接口提取具体「IP:端口」直接使用
地区 / 时长	通过用户名参数指定	通过提取接口参数指定
适合场景	多账号、会话精细控制	固定出口环境、批量提取

使用步骤

1. 打开对应网络的配置页面：动态住宅 IP、动态机房 IP 或 移动手机 IP。
2. 在「代理IP配置」中选择 白名单接入。
3. 将发起代理连接的设备公网出口 IP 加入白名单（配置页右上角「添加白名单」，或左侧菜单「API 白名单」）。未加入白名单的 IP 会被拒绝。
4. 设置地区、IP 维持时长、协议类型（SOCKS5 / HTTP）、输出格式和输出数量。
5. 点击 生成结果，获取代理地址和端口，并填写至客户端或程序中，无需用户名和密码。

TIP

白名单接入下，提取到的每个「IP:端口」均可用于代理连接，无需组合用户名参数；地区、时长等控制在提取时通过接口参数指定。

提取接口

配置页面的“白名单认证”会自动生成提取链接。请使用用户后台生成的实际链接，以下仅展示格式：

https://api2.rola.vip/extract?count=10&api_key=YOUR_API_KEY&proxy_type=residential&format=text&country=&state=&city=&time=10

参数说明

参数	说明	示例
count	提取数量（对应「输出数量」）	count=10
api_key	API 密钥，在用户后台获取	api_key=YOUR_API_KEY
proxy_type	网络类型：动态住宅 IP residential、动态机房 IP datacenter、移动手机 IP mobile	proxy_type=residential
format	输出格式，如 text	format=text
country / state / city	地区参数，留空表示不限；state、city 仅动态住宅 IP支持	country=us
time	IP 维持时长，单位分钟，支持 1～120 分钟	time=10

TIP

proxy_type 由所选网络决定，用户后台会自动填入，请以生成的实际链接为准。地区和时长参数的含义与账密认证中的对应参数一致。

使用提取到的 IP

format=text 时，提取结果为每行一个「IP:端口」：

1.2.3.4:2000
5.6.7.8:2000

其中每一条都是可直接使用的代理IP（设备已在白名单内，无需账密）：

curl -x socks5h://1.2.3.4:2000 http://ip123.in/ip.json

返回的 JSON 包含本次请求的出口 IP 和归属地，请核对是否符合配置要求。

关于提取到的 IP

提取到的“IP:端口”为代理中转入口。实际出口由地区设置及可用资源决定，请通过上述检测命令查询本次请求的出口 IP 和归属地。

WARNING

• 只有已加入白名单的设备 IP 才能使用提取到的代理IP；本地公网 IP 变化后，需要重新加入白名单。
• 如果连接失败，先确认设备公网 IP 是否已在白名单、api_key 是否正确、proxy_type 是否与所选网络一致。