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. 点击 生成结果，得到一组「IP:端口」，直接填到工具或代码里使用，无需账号密码。

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 由所选网络决定，控制台会自动填好——以控制台生成的链接为准即可。地区、时长参数（country/state/city/time）与账密认证里写在用户名中的参数一一对应。

使用提取到的 IP

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

1.2.3.4:2000
5.6.7.8:2000

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

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

返回的 JSON 里包含出口 IP 和归属地，说明代理已生效。

关于提取到的 IP

提取到的「IP:端口」是我们的中转服务器地址，并不是最终出口 IP。实际发起请求连接后，出口才会是你所选地区的 IP——用上面的检测命令查看返回结果，即可看到真实的出口 IP 和归属地。

WARNING

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