> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/integrations/cn/proxy-integrations/oxy-proxy-extension-for-chrome.md).

# Oxy® Proxy Extension for Chrome

Oxy® Proxy Extension for Chrome 与 Oxylabs 代理的设置——快速集成指南。适用于任何提供商的免费代理管理器。

[**Oxy**® **代理扩展程序**](https://oxylabs.io/products/chrome-proxy-extension) 是 Chrome 的代理管理扩展程序。它免费，并可与您选择的任何代理服务商配合使用。

本快速指南展示如何集成以下 Oxylabs 代理：

* [**住宅代理和移动代理**](#residential-and-mobile-proxies)
* [**数据中心代理**](#datacenter-proxies)
* [**独享数据中心代理（企业版）**](#dedicated-datacenter-proxies-enterprise)
* [**独享数据中心代理（自助服务版）**](#dedicated-datacenter-proxies-self-service)
* [**ISP代理**](#isp-proxies)
* [**独享ISP代理**](#dedicated-isp-proxies)

### 设置

{% stepper %}
{% step %}
[**下载**](https://chrome.google.com/webstore/detail/oxylabs-proxy-extension/infajoaodhhdogakhloedbppcbeajhoo) 并点击扩展图标打开应用。

<figure><img src="https://1216392379-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU4lV7kLC2Df45W0aLQlX%2Fuploads%2Fgit-blob-31071ad50bef4d09d1718c64b77869ab74245df2%2Foxy-extension-1.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
点击 **+添加新代理** 按钮。

<figure><img src="https://1216392379-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU4lV7kLC2Df45W0aLQlX%2Fuploads%2Fgit-blob-b0a29fc8f469a4c2ffdbef10e3b61a1b19cdefa2%2Foxy-extension-2.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
将打开一个新标签页，您可以在其中 **设置您的代理配置文件**.

填写您所选代理类型的详细信息：

* [**住宅代理和移动代理**](#residential-and-mobile-proxies)
* [**数据中心代理**](#datacenter-proxies)
* [**独享数据中心代理（企业版）**](#dedicated-datacenter-proxies-enterprise)
* [**独享数据中心代理（自助服务版）**](#dedicated-datacenter-proxies-self-service)
* [**ISP代理**](#isp-proxies)
* [**独享ISP代理**](#dedicated-isp-proxies)

#### 住宅代理和移动代理

<table data-header-hidden data-full-width="false"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>名称</strong></td><td><code>项目名称</code></td></tr><tr><td><strong>协议</strong></td><td><code>HTTP</code> 或 <code>HTTPS</code></td></tr><tr><td><strong>域名</strong></td><td><code>pr.oxylabs.io</code></td></tr><tr><td><strong>端口</strong></td><td><code>7777</code></td></tr><tr><td><strong>用户名</strong></td><td><code>customer-USERNAME</code></td></tr><tr><td><strong>密码</strong></td><td><code>PASSWORD</code></td></tr></tbody></table>

{% hint style="warning" %}
请务必添加 `customer-` 部分到你的用户名中。
{% endhint %}

<figure><img src="https://1216392379-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU4lV7kLC2Df45W0aLQlX%2Fuploads%2Fgit-blob-0aeb88bc128eb08694f896f3f10c89ee44f8ff8d%2Fpr-oxy-1.png?alt=media" alt=""><figcaption></figcaption></figure>

你还可以使用 **附加参数** 搭配住宅代理和移动代理来设置地理位置（国家/地区、州、省、市等）并控制会话。查看 [住宅代理文档](/products/cn/proxies/residential-proxies.md) 了解更多。下表概述了可用参数及其示例值。

<table><thead><tr><th width="167">代理参数</th><th width="465.5">示例</th></tr></thead><tbody><tr><td><a href="/products/cn/proxies/residential-proxies/location-settings/select-country.md#country-specific-entry-nodes">国家入口节点</a></td><td><p><strong>主机：</strong> <code>us-pr.oxylabs.io</code></p><p><strong>端口：</strong> <code>10000</code></p></td></tr><tr><td><a href="/products/cn/proxies/residential-proxies/location-settings/select-country.md">国家</a></td><td><strong>用户：</strong> <code>customer-username-cc-US</code></td></tr><tr><td><a href="/products/cn/proxies/residential-proxies/location-settings/select-state.md">州</a></td><td><strong>用户：</strong> <code>customer-username-st-US_texas</code></td></tr><tr><td><a href="/products/cn/proxies/residential-proxies/location-settings/select-city.md">城市</a></td><td><strong>用户：</strong> <code>customer-username-city-paris</code></td></tr><tr><td><a href="/products/cn/proxies/residential-proxies/location-settings/continent.md">洲</a></td><td><strong>用户：</strong> <code>customer-username-cn-NA</code></td></tr><tr><td><a href="/products/cn/proxies/residential-proxies/location-settings/zip-postal-code.md">ZIP/邮政编码</a></td><td><strong>用户：</strong> <code>customer-username-cc-US-postalcode-90210</code></td></tr><tr><td><a href="/products/cn/proxies/residential-proxies/location-settings/asn-targeting.md">ASN 定向</a></td><td><strong>用户：</strong> <code>customer-username-ASN-21928</code></td></tr><tr><td><a href="/products/cn/proxies/residential-proxies/session-control.md">会话</a></td><td><strong>用户：</strong> <code>customer-username-sessid-qwerty123-sesstime-30</code></td></tr><tr><td><a href="/products/cn/proxies/residential-proxies/session-control.md#session-time">会话时间</a></td><td><p><strong>主机：</strong> <code>us-pr.oxylabs.io</code></p><p><strong>端口：</strong> <code>10001</code></p></td></tr></tbody></table>

#### 数据中心代理

<table data-header-hidden data-full-width="false"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>名称</strong></td><td><code>项目名称</code></td></tr><tr><td><strong>协议</strong></td><td><code>HTTP</code> 或 <code>HTTPS</code></td></tr><tr><td><strong>域名</strong></td><td><code>dc.oxylabs.io</code></td></tr><tr><td><strong>端口</strong></td><td><code>8000</code></td></tr><tr><td><strong>用户名</strong></td><td><code>user-USERNAME</code></td></tr><tr><td><strong>密码</strong></td><td><code>PASSWORD</code></td></tr></tbody></table>

{% hint style="warning" %}
请务必添加 `user-` 用户名前缀。
{% endhint %}

<figure><img src="https://1216392379-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU4lV7kLC2Df45W0aLQlX%2Fuploads%2Fgit-blob-debd7c7f9d8859050e3a304e3c116a26e498c910%2Foxy-extension-3.png?alt=media" alt=""><figcaption></figcaption></figure>

**按 IP 计费订阅**

端口是从代理列表中分配给 IP 地址的顺序编号。因此，端口 `8001` 使用列表中的第一个 IP 地址。您也可以通过将端口设置为以下值来启用代理 IP 轮换： `8000`.

此外，您可以通过将代理用户名设置为以下值来指定地理位置，例如美国： `user-USERNAME-country-US`.

**按流量计费订阅**

端口 `8001` 会随机选择一个 IP 地址，但在会话期间保持一致。或者，您可以使用端口按每个请求轮换代理 IP： `8000`.

还可以通过将代理用户名设置为以下值来指定地理位置，例如美国： `user-USERNAME-country-US`.

#### 独享数据中心代理（企业版）

<table data-header-hidden data-full-width="false"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>名称</strong></td><td><code>项目名称</code></td></tr><tr><td><strong>协议</strong></td><td><code>HTTP</code></td></tr><tr><td><strong>域名</strong></td><td><code>1.2.3.4</code> （示例）</td></tr><tr><td><strong>端口</strong></td><td><code>60000</code></td></tr><tr><td><strong>用户名</strong></td><td><code>USERNAME</code></td></tr><tr><td><strong>密码</strong></td><td><code>PASSWORD</code></td></tr></tbody></table>

<figure><img src="https://1216392379-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU4lV7kLC2Df45W0aLQlX%2Fuploads%2Fgit-blob-885f3835d1d1faa393ae4d94f28a05aeed64b2b8%2Feddc-oxy-1.png?alt=media" alt=""><figcaption></figcaption></figure>

对于 Enterprise 独享数据中心代理，您需要从获取的列表中选择一个 IP 地址。此外，如果您使用的是 **已列入白名单的 IP 地址**，则需要使用端口 `65432`。请访问我们的 [文档](/products/cn/proxies/dedicated-datacenter-proxies/enterprise/proxy-lists.md) 了解更多详情。

#### 独享数据中心代理（自助服务版）

<table data-header-hidden data-full-width="false"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>名称</strong></td><td><code>项目名称</code></td></tr><tr><td><strong>协议</strong></td><td><code>HTTP</code> 或 <code>HTTPS</code></td></tr><tr><td><strong>域名</strong></td><td><code>ddc.oxylabs.io</code></td></tr><tr><td><strong>端口</strong></td><td><code>8000</code></td></tr><tr><td><strong>用户名</strong></td><td><code>user-USERNAME</code></td></tr><tr><td><strong>密码</strong></td><td><code>PASSWORD</code></td></tr></tbody></table>

{% hint style="warning" %}
请务必添加 `user-` 用户名前缀。
{% endhint %}

<figure><img src="https://1216392379-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU4lV7kLC2Df45W0aLQlX%2Fuploads%2Fgit-blob-3ece358046fc6dab92ae41e986a311f48745a232%2Fssddc-oxy-1.png?alt=media" alt=""><figcaption></figcaption></figure>

对于自助服务独享数据中心代理，端口表示来自已获取 [代理列表](/products/cn/proxies/dedicated-datacenter-proxies/self-service/proxy-list.md)。如果你希望每个请求都获取不同的 IP，请更改 **端口** 设置为 `8000` 以启用 [代理轮换](/products/cn/proxies/dedicated-datacenter-proxies/self-service/proxy-rotation.md).

#### ISP代理

<table data-header-hidden data-full-width="false"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>名称</strong></td><td><code>项目名称</code></td></tr><tr><td><strong>协议</strong></td><td><code>HTTP</code> 或 <code>HTTPS</code></td></tr><tr><td><strong>域名</strong></td><td><code>isp.oxylabs.io</code></td></tr><tr><td><strong>端口</strong></td><td><code>8000</code></td></tr><tr><td><strong>用户名</strong></td><td><code>user-USERNAME</code></td></tr><tr><td><strong>密码</strong></td><td><code>PASSWORD</code></td></tr></tbody></table>

{% hint style="warning" %}
请务必添加 `user-` 部分到你的用户名中。
{% endhint %}

<figure><img src="https://1216392379-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU4lV7kLC2Df45W0aLQlX%2Fuploads%2Fgit-blob-1acb7f74a9d7f08416253c5de3e32ea4e95d2a52%2Fisp-oxy-1.png?alt=media" alt=""><figcaption></figcaption></figure>

对于 ISP 代理，端口会分配给一个特定的 IP 地址及其位置。因此，端口 `8001` 将始终选择你 [代理列表](https://developers.oxylabs.io/proxies/isp-proxies/proxy-list).

中的第一个 IP。如果你希望每个请求都获得不同的 IP，请将端口改为 `8000` 以启用 [代理轮换](https://developers.oxylabs.io/proxies/isp-proxies/proxy-rotation).

#### 独享ISP代理

<table data-header-hidden data-full-width="false"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>名称</strong></td><td><code>项目名称</code></td></tr><tr><td><strong>协议</strong></td><td><code>HTTP</code>, <code>HTTPS</code>，或 <code>SOCKS5</code></td></tr><tr><td><strong>域名</strong></td><td><code>disp.oxylabs.io</code></td></tr><tr><td><strong>端口</strong></td><td><code>8001</code></td></tr><tr><td><strong>用户名</strong></td><td><code>user-USERNAME</code></td></tr><tr><td><strong>密码</strong></td><td><code>PASSWORD</code></td></tr></tbody></table>

{% hint style="warning" %}
请务必添加 `user-` 用户名前缀。
{% endhint %}

<figure><img src="https://1216392379-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU4lV7kLC2Df45W0aLQlX%2Fuploads%2Fgit-blob-57aee4fb98e3c1521430717caea2e58bcf92cc9c%2Foxy-1.png?alt=media" alt=""><figcaption></figcaption></figure>

端口号指示将使用您已获取的 [代理列表](/products/cn/proxies/dedicated-isp-proxies/self-service/proxy-list.md) 中的哪个 IP 地址。使用端口 `8000` 可自动进行 [代理 IP 轮换](/products/cn/proxies/dedicated-isp-proxies/self-service/proxy-rotation.md).
{% endstep %}

{% step %}
点击 **保存更改**.

<figure><img src="https://1216392379-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU4lV7kLC2Df45W0aLQlX%2Fuploads%2Fgit-blob-ac8c66ae309252e8f350bb5df8b08b1a75185e4d%2FScreenshot%202026-08-10%20at%2005.34.35.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
按照第一步所示打开扩展，然后点击 **连接**.

<figure><img src="https://1216392379-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU4lV7kLC2Df45W0aLQlX%2Fuploads%2Fgit-blob-722d952bce370c23a219f4888fdcaa1f17abf73a%2Fpr-oxy-2.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

就是这样。您现在正在通过 Oxylabs 代理使用互联网连接。

### 白名单

如果您不想在访问特定网站时使用代理，可以将其添加到白名单中。打开扩展，点击 **管理代理**，然后打开 **全局绕过列表**.

<figure><img src="https://1216392379-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU4lV7kLC2Df45W0aLQlX%2Fuploads%2Fgit-blob-baad5f504ea5c0bce922e3864ddce0a5c95bbd46%2Foxy-extension-7.png?alt=media" alt=""><figcaption></figcaption></figure>

例如，如果您想跳过为以下地址使用代理： `https://ip.oxylabs.io/`，您应按如下方式输入地址： `https://ip.oxylabs.io` 或 `ip.oxylabs.io`。访问此网站后，您应看到您的常规 IP 地址，而不是代理 IP。

{% hint style="warning" %}
保存更改后，断开并重新连接代理以启用白名单。
{% endhint %}

### 常见错误

请使用下方列出的故障排除步骤，修复使用 Oxylabs 或其他服务商代理时常见的扩展错误。

<details>

<summary><strong>代理无法连接</strong></summary>

尝试 **断开** 并 **重新连接** 您的代理在扩展中。如果问题仍然存在，请继续执行下一步。

</details>

<details>

<summary><strong>代理凭据不正确</strong></summary>

请验证代理 **username** 并 **password** 您输入的信息是否正确，并与代理服务商分配的凭据一致。

对于 Oxylabs 住宅代理，请确保您使用的是 **代理用户的** 您在 Oxylabs 中创建的用户名和密码 [控制面板](https://dashboard.oxylabs.io/)。您始终可以在仪表板中通过以下路径编辑这些凭据： **我的产品** → **数据中心代理** → [**用户**](https://dashboard.oxylabs.io/?route=/overview/residential-proxies/users).

</details>

<details>

<summary><strong>没有以下前缀的用户名无效 <code>customer-</code> 或 <code>user-</code> 前缀</strong></summary>

Oxylabs **住宅代理要求您在** 前添加 `customer-` 字符串到代理用户的用户名中。例如，如果您的用户名是 `john_TFTdL`，则您必须将用户名输入为 `customer-john_TFTdL`.

Oxylabs **ISP、独享 ISP、数据中心和自助式独享数据中心代理** **要求您在用户名后追加** 前添加 `user-` 字符串到代理用户的用户名中。例如，如果您的用户名是 `john_TFTdL`，则您必须将用户名输入为 `user-john_TFTdL`.

</details>

<details>

<summary><strong>代理域名或端口无效</strong></summary>

请确保您使用的是有效的代理域名和端口号 **，由您的代理服务商分配**.

可在此处找到 Oxylabs 代理各可用代理类型对应的有效域名：

* [住宅代理和移动代理](#residential-and-mobile-proxies)
* [数据中心代理](#datacenter-proxies)
* [独享数据中心代理（企业版）](#dedicated-datacenter-proxies-enterprise)
* [独享数据中心代理（自助服务版）](#dedicated-datacenter-proxies-self-service)
* [ISP代理](#isp-proxies)
* [独享ISP代理](#dedicated-isp-proxies)

</details>

<details>

<summary><strong>扩展无法工作</strong></summary>

如果扩展由于某种原因无法工作，请尝试 **卸载** 并 **重新安装** ，通过 [Chrome 网上应用店](https://chromewebstore.google.com/detail/oxylabs-proxy-extension/infajoaodhhdogakhloedbppcbeajhoo) 或浏览器设置。

</details>

<details>

<summary><strong>禁用第三方 VPN</strong></summary>

如果您正在使用第三方虚拟专用网络（VPN），请将其关闭。它可能与 Oxy® 代理扩展程序冲突。

</details>

您还可以查看我们的免费 [**Oxy**® **Proxy Manager 应用**](https://oxylabs.io/products/proxy-manager-app) 适用于 Android。它可让您轻松添加和管理代理，并通过简单的一键连接在多个 IP 之间切换。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers.oxylabs.io/integrations/cn/proxy-integrations/oxy-proxy-extension-for-chrome.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.