动态住宅代理

动态住宅代理按流量计费，出口 IP 来自真实家庭宽带中的在线设备。在 VPS 上安装网关后，本机程序通过 HTTP 或 SOCKS5 本地端口使用住宅 IP。

流量包与有效期

购买入口：控制台 → 动态住宅代理 → 购买代理。套餐和价格见产品页。
所有套餐功能相同，只有流量大小不同。
10 GB 入门包自付款成功起 30 天内有效，逾期未用完的流量作废；其他套餐的流量不设有效期。
同时持有多个流量包时，优先使用最早到期的有效流量。某个流量包到期后，只清除它的剩余流量，其他流量包不受影响。到期时间按新加坡时间显示。
流量用完后在管理页点击 加购流量 继续购买，新流量追加到当前账户。

自动购买

在管理页的 自动购买 中可以设置：

剩余流量低于设定的阈值（GB）时，自动购买所选流量包。
到期自动购买：仅对短期流量包生效，在最后到期的短期流量包到期前 24 小时购买一次。

续费费用通过你选择的支付方式扣除。自动购买失败多次后会停止，并在页面显示失败提示，需要检查支付方式后重新开启。支付方式见充值、支付与发票，续费规则见续费、到期与退款。

动态住宅流量包属于消耗型资源，付款后不支持退款，与是否安装网关、是否使用无关。详见 IP 代理服务协议和续费、到期与退款。

安装网关

网关可以装在 VoyraCloud 或其他云厂商的 Linux / Windows VPS 上，购买时不需要选择 VPS。

打开控制台 → 动态住宅代理 → 网关安装，点击 安装网关。
选择 Linux 或 Windows，点击 复制命令。
在目标 VPS 上执行命令。Linux 需要 root 或 sudo 权限，Windows 在 PowerShell 中执行。
安装完成后，设备会自动出现在 已接入设备 列表中。

命令格式如下，安装令牌 为控制台显示的令牌。请直接复制控制台中的完整命令。

Linux：

curl -fsSL https://get.voyracloud.com/voyra-agent/install-linux.sh | sudo bash -s -- --token 安装令牌

Windows（PowerShell）：

Invoke-WebRequest -UseBasicParsing -Uri 'https://get.voyracloud.com/voyra-agent/install-windows.ps1' -OutFile "$env:TEMP\install-voyra-agent.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-voyra-agent.ps1" -Token '安装令牌'

安装命令包含你的安装令牌，请妥善保管，不要分享给他人。

本地端口

网关安装后，在该 VPS 内使用以下地址：

协议	地址
HTTP	`127.0.0.1:18080`
SOCKS5	`127.0.0.1:18081`

端口监听在本机 127.0.0.1，只供这台 VPS 上的程序使用。验证出口：

# HTTP
curl -x http://127.0.0.1:18080 https://ipinfo.io/json

# SOCKS5
curl --proxy socks5h://127.0.0.1:18081 https://ipinfo.io/json

更多语言和工具见 IP 代理入门。

配置出口

新设备默认使用 全球随机 / 每次请求切换。修改方法：

在 已接入设备 列表找到设备，点击 修改出口配置。
依次选择国家、州 / 省、城市。不选的部分在更大范围内随机分配；切换国家后州和城市会清空。
选择 IP 轮转 方式，定时切换需要填写 切换间隔。
点击保存。

可选的国家、州和城市随 IP 池中在线的设备变化，以控制台下拉选项为准。

轮换方式

方式	行为	适合
每次请求切换	每个新连接分配一个新的住宅 IP	数据采集、SERP 查询、批量检测
粘性	一直使用同一个出口 IP，直到修改配置或该住宅设备下线；下线后换成同地区的新 IP	登录、加购、填表等多步骤流程，浏览器自动化
定时切换	保持同一个 IP，到达间隔后更换；间隔按分钟或小时填写，例如 5 分钟、1 小时	持续监控、长时间运行的任务

住宅 IP 来自真实家庭设备，设备可能随时下线，因此粘性和定时切换只能尽量保持同一个 IP，不保证在任何时长内分配到特定 IP。

修改配置无需重装

出口配置保存在平台，网关下次拉取配置时自动生效，不需要重新执行安装命令。设备离线时保存成功，不代表出口已经切换，请在设备上线后用上面的命令验证。

多台设备共享流量包

每个流量包对应一个安装令牌。用同一个令牌在多台 VPS 上安装，所有设备共享流量。
每台设备可以单独设置出口和轮换方式。
设备管理：
- 修改设备名称：设置便于识别的备注。
- 停用 / 启用：设备在下次心跳后停止或恢复使用该流量包。
- 移除设备：超过 3 天未与平台通信的设备可以从列表移除；再次连接时会自动重新显示。