地理位置和代理选择

了解如何使用 Oxylabs 代理浏览器位置参数，从特定位置访问网页数据。

直接将地理定位和代理路由参数添加到 WebSocket 连接 URL，以通过目标地理区域路由您的自动化 Agent Browser 会话，并控制代理 IP 的使用。

地理定位参数

您可以使用三个主要查询参数，按国家、州或城市定位特定地理位置。

国家

p_cc	2位国家代码（例如， US, DE, FR）。如果未指定国家，则会根据可用性自动分配。

wss://USER:[e-mail]?p_cc=US

城市

p_city	小写城市名称（例如， berlin, los_angeles）。还必须指定以下之一 p_cc 或 p_state.

wss://USER:[e-mail]?p_cc=US&p_city=new_york

城市级定位的运行方式是 尽力偏好。如果住宅代理池中没有位于请求精确位置的可用代理，它会自动回退到国家范围。

州（仅限美国）

p_state	小写的美国州名（例如， texas, ohio）。请查看完整的 受支持州列表.

wss://USER:[e-mail]?p_state=texas&p_city=houston

注意： 如果 p_state 和 p_cc 都已指定， p_state 将优先，并且 p_cc 将被忽略。

代理选择（粘性代理）

默认情况下，代理网关会为每个唯一的浏览器连接会话分配一个新的出口 IP。或者，您可以通过包含 proxy_resi_ses_id 和 proxy_resi_ses_time 参数，在连续的浏览器连接尝试中固定一个特定的住宅出口 IP。

参数	说明	类型
proxy_resi_ses_id	字母数字会话跟踪器名称，长度为 3 到 36 个字符。	字符串
proxy_resi_ses_time	保留固定住宅代理出口 IP 的分钟数。最小值为 1 分钟，最大值为 1440 分钟（24 小时）。	整数

# 示例：将美国 IP 固定 60 分钟
wss://USER:[e-mail]?p_cc=US&proxy_resi_ses_id=unique_job_id_101&proxy_resi_ses_time=60

要在连续连接中保持完全相同的出口 IP，您必须为以下两项传递相同的值： proxy_resi_ses_id 和 proxy_resi_ses_time 在后续的每个 URL 字符串中。

代码示例

以下示例展示了如何构建同时应用地理定位和粘性住宅代理 IP 限制的连接字符串。

Python（Playwright）

from playwright.sync_api import sync_playwright

username = "USERNAME_abc12"
password = "PASSWORD"
endpoint = "hb.oxylabs.io"

# 定位纽约市并将住宅 IP 固定 30 分钟
geolocation = "p_cc=US&p_city=new_york"
sticky_proxy = "proxy_resi_ses_id=scrape_session_404&proxy_resi_ses_time=30"
browser_url = f"wss://{username}:{password}@{endpoint}?{geolocation}&{sticky_proxy}"

with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp(browser_url)
    page = browser.new_page()
    page.goto("https://ip.oxylabs.io/location")
    print(page.title())
    browser.close()

JavaScript（Playwright）

import { chromium } from "playwright";

const username = "USERNAME_abc12";
const password = "PASSWORD";
const endpoint = "hb.oxylabs.io";

// Target Texas state and pin the residential IP for 60 minutes
const geolocation = "p_state=texas&p_city=houston";
const sticky_proxy = "proxy_resi_ses_id=scrape_session_404&proxy_resi_ses_time=60";
const browserUrl = `wss://${username}:${password}@${endpoint}?${geolocation}&${sticky_proxy}`;

(async () => {
    const browser = await chromium.connectOverCDP(browserUrl);
    const page = await browser.newPage();
    await page.goto("https://ip.oxylabs.io/location");
    console.log(await page.title());
    await browser.close();
})();

JavaScript（Puppeteer）

import puppeteer from 'puppeteer';

(async () => {
    const username = 'USERNAME';
    const password = 'PASSWORD';
    const endpoint = 'hb.oxylabs.io';
    
    // Target Texas state and pin the residential IP for 60 minutes
    const geolocation = "p_state=texas&p_city=houston";
    const sticky_proxy = "proxy_resi_ses_id=scrape_session_404&proxy_resi_ses_time=60";
    const browserUrl = `wss://${username}:${password}@${endpoint}?${geolocation}&${sticky_proxy}`;

    const browser = await puppeteer.connect({
        browserWSEndpoint: browserUrl
    });
    const page = await browser.newPage();
    await page.goto('https://example.com');
    await browser.close();
})();