IP 代理入門

比較動態住宅、靜態 ISP 和資料中心代理，並在 curl、Python、Playwright 和指紋瀏覽器中接入

VoyraCloud 提供三類 IP 代理：動態住宅、靜態 ISP 和資料中心。本頁先幫你選出合適的類型，再給出常用工具的接入寫法；購買和控制台操作請見各產品頁。

選擇代理類型

	動態住宅代理	靜態 ISP 代理	資料中心代理
IP 來源	真實家庭寬頻中的線上裝置	電信業者 ASN 網段	機房網段
計費	按流量（流量包）	按 IP 數量和週期，不限流量	按 IP 數量和週期，不限流量
IP 變化	每次請求切換、黏性或定時切換	有效期內固定，續費保留原 IP	有效期內固定，續費保留原 IP
獨享或共享	共享 IP 池	獨享，一個 IP 只分配給一個帳號	獨享，一個 IP 只分配給一個帳號
接入方式	在 VPS 上安裝閘道，使用本機 HTTP / SOCKS5 連接埠	SOCKS5 + 使用者名稱密碼，可一鍵部署到 VoyraCloud Linux 伺服器	SOCKS5 + 使用者名稱密碼
定位	國家、州 / 省、城市	國家、城市、電信業者	國家
典型用途	資料擷取、SERP 查詢、廣告驗證、地區價格測試	跨境店鋪、社群帳號、需要長期固定身分的自動化	資料擷取、價格監控、SEO、批次任務

價格以產品頁和結帳頁為準：

依情境選擇

需要大量互不相關的請求、分散到不同 IP：選動態住宅代理，輪換方式設為每次請求切換。
登入、加入購物車、填寫表單等多步驟操作需要短時間內 IP 不變：選動態住宅代理，使用黏性或定時切換。
帳號或店鋪需要長期固定的家寬 ISP 出口，或需要 IP 白名單：選靜態 ISP 代理。
對成本敏感、目標網站不攔截機房 IP：選資料中心代理。

什麼時候用住宅 IP 伺服器

代理是在既有機器上增加一個出口。如果需要的是一台公網 IP 本身就是住宅 IP 的伺服器（例如直播推流、多店鋪遠端桌面這類以整機為單位的情境），選住宅 IP 伺服器更直接：IP 綁定在伺服器上，不需要額外設定代理。

如果已經有 VoyraCloud Linux 伺服器，只想讓它的出站流量走電信業者 IP，可以購買靜態 ISP 代理並一鍵部署到伺服器。

連線資訊

產品	協定	位址	驗證
動態住宅代理	HTTP	`127.0.0.1:18080`	無，僅限安裝了閘道的那台 VPS
動態住宅代理	SOCKS5	`127.0.0.1:18081`	無，僅限安裝了閘道的那台 VPS
靜態 ISP / 資料中心代理	SOCKS5	`HOST:PORT`	使用者名稱和密碼

靜態 ISP 和資料中心代理的憑證可在我的靜態 IP 中查看或匯出，匯出格式為 socks5://USERNAME:PASSWORD@HOST:PORT。使用者名稱或密碼含特殊字元時，寫進 URI 前需要百分比編碼（匯出檔案已編碼）。

動態住宅代理請先依安裝閘道完成安裝，出口國家和輪換方式在控制台設定，程式裡只需要填本機連接埠。

程式碼範例

範例中的 USERNAME、PASSWORD、HOST、PORT 請替換為控制台中的實際連線資訊。

curl

動態住宅代理：

# 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

靜態 ISP / 資料中心代理：

curl --proxy socks5h://USERNAME:PASSWORD@HOST:PORT https://ipinfo.io/json

socks5h 表示網域名稱也由代理端解析，避免本機 DNS 暴露真實位置。

Python（requests）

使用 SOCKS5 需要安裝 SOCKS 支援：

pip install "requests[socks]"

動態住宅代理：

import requests

# HTTP 端口
proxy = "http://127.0.0.1:18080"
# 或 SOCKS5 端口
# proxy = "socks5h://127.0.0.1:18081"

resp = requests.get(
    "https://ipinfo.io/json",
    proxies={"http": proxy, "https": proxy},
    timeout=30,
)
print(resp.json())

靜態 ISP / 資料中心代理：

import requests

proxy = "socks5h://USERNAME:PASSWORD@HOST:PORT"

resp = requests.get(
    "https://ipinfo.io/json",
    proxies={"http": proxy, "https": proxy},
    timeout=30,
)
print(resp.json())

Playwright（Python）

動態住宅代理，使用本機 HTTP 連接埠：

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(proxy={"server": "http://127.0.0.1:18080"})
    page = browser.new_page()
    page.goto("https://ipinfo.io/json")
    print(page.text_content("body"))
    browser.close()

多步驟流程（登入、加入購物車等）建議在控制台把該裝置的輪換方式設為黏性或定時切換，避免中途換 IP。

靜態 ISP / 資料中心代理：Chromium 不支援帶使用者名稱密碼的 SOCKS5 代理。在 VoyraCloud Linux 伺服器上執行時，建議先把這個 IP 一鍵部署到伺服器，整機出站流量走代理，Playwright 中不再設定 proxy：

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch()
    page = browser.new_page()
    page.goto("https://ipinfo.io/json")
    print(page.text_content("body"))
    browser.close()

指紋瀏覽器

指紋瀏覽器和其他支援代理的軟體通常提供以下欄位，依產品填寫：

欄位	動態住宅代理	靜態 ISP / 資料中心代理
代理類型	HTTP 或 SOCKS5	SOCKS5
主機	`127.0.0.1`	控制台中連線位址的主機部分
連接埠	`18080`（HTTP）或 `18081`（SOCKS5）	控制台中的連接埠
使用者名稱 / 密碼	留空	控制台中的使用者名稱和密碼

部分軟體支援直接貼上 socks5://USERNAME:PASSWORD@HOST:PORT，可以使用匯出檔案中的內容。

動態住宅代理的本機連接埠只在安裝閘道的機器上可用，指紋瀏覽器需要執行在同一台機器上，例如在 Windows 伺服器上同時安裝閘道和指紋瀏覽器。

使用規則

代理不得用於詐欺、撞庫、攻擊、掃描或違反當地法律的活動，憑證未經書面同意不得轉售或分享。完整規則請見 IP 代理服務協議。

IP 代理入門

本頁目錄