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 代理入门

本页目录