動態住宅代理
購買流量包、安裝閘道、設定出口國家與輪換方式
動態住宅代理按流量計費，出口 IP 來自真實家庭寬頻中的線上裝置。在 VPS 上安裝閘道後，本機程式透過 HTTP 或 SOCKS5 本機連接埠使用住宅 IP。
流量包與有效期
- 購買入口：控制台 → 動態住宅代理 → 購買代理。方案和價格請見 產品頁。
- 所有方案功能相同，只有流量大小不同。
- 10 GB 入門包自付款成功起 30 天內有效，逾期未用完的流量作廢；其他方案的流量不設有效期。
- 同時持有多個流量包時，優先使用最早到期的有效流量。某個流量包到期後，只清除它的剩餘流量，其他流量包不受影響。到期時間以新加坡時間顯示。
- 流量用完後在管理頁點擊 加購流量 繼續購買，新流量會追加到目前帳號。
自動購買
在管理頁的 自動購買 中可以設定：
- 剩餘流量低於設定的門檻（GB）時，自動購買所選流量包。
- 到期自動購買：僅對短期流量包生效，在最後到期的短期流量包到期前 24 小時購買一次。
續費費用透過你選擇的支付方式扣除。自動購買失敗多次後會停止，並在頁面顯示失敗提示，需要檢查支付方式後重新開啟。支付方式請見 儲值、支付與發票，續費規則請見 續費、到期與退款。
安裝閘道
閘道可以裝在 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 天未與平台通訊的裝置可以從清單移除；再次連線時會自動重新顯示。
輪換權杖
懷疑權杖洩漏時，在 閘道安裝 中點擊 輪換權杖。舊權杖立即失效，所有裝置都需要用新指令重新安裝或更新。