> For the complete documentation index, see [llms.txt](https://docs.proxyshard.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.proxyshard.com/cn/chan-pin/proxyshard-extension.md).

# ProxyShard Extension

<mark style="color:purple;">**ProxyShard – Smart Proxy Manager**</mark> 是我们的官方浏览器扩展程序，适用于基于 Chromium 内核的浏览器（<mark style="color:purple;">Chrome</mark>、<mark style="color:purple;">Edge</mark>、<mark style="color:purple;">Opera</mark>、<mark style="color:purple;">Brave</mark>、<mark style="color:purple;">Yandex</mark> 等），让您只需点击几下即可直接在浏览器中添加、切换和测试代理，无需任何第三方软件。

#### 扩展程序的功能：

* 保存无限数量的代理配置文件
* 支持 <mark style="color:purple;">HTTP / HTTPS</mark> 与 <mark style="color:purple;">SOCKS5</mark>（无需身份验证）连接
* 一键测试每个配置文件（延迟、国家/地区、IP）
* <mark style="color:purple;">**按计时器或热键进行 IP 轮换**</mark>，适用于移动代理
* 旁路列表与高级域名路由
* 已本地化为**英语、俄语、乌克兰语和中文**

<div align="center"><figure><img src="/files/aKZbHiOElBGPtETaBeCq" alt="ProxyShard 扩展程序界面"><figcaption><p>ProxyShard 扩展程序界面</p></figcaption></figure></div>

## 安装扩展程序

该扩展程序可在官方 **Chrome Web Store** 中获取，也可以毫无问题地安装到 Edge、Opera、Brave 以及其他基于 Chromium 的浏览器中。

{% embed url="<https://chromewebstore.google.com/detail/proxyshard-%E2%80%93-smart-proxy/ohlcikccaeapbfpmejhckfjjddkcflbe>" %}

安装完成后，打开扩展菜单（地址栏右侧的拼图图标），点击 ProxyShard 名称旁的「图钉」图标，将其**固定**到工具栏以便快速访问。

<div align="center"><figure><img src="/files/RuPgnQ5yhTy14KBmna00" alt="将扩展程序固定到浏览器"><figcaption><p>1) 打开扩展菜单 2) 固定 ProxyShard</p></figcaption></figure></div>

{% hint style="danger" %}
**Chromium 浏览器中 SOCKS5 的限制**

Google Chrome（以及其他基于 Chromium 的浏览器）默认不支持通过用户名/密码对 SOCKS5 代理进行身份验证。对于基于 **Manifest V3** 的扩展程序，该限制依然存在。

通过扩展程序使用 SOCKS5 只能：

* **不带凭据**（匿名代理）使用，或
* **通过 IP 白名单**进行绑定

对于需要身份验证的代理，请使用 <mark style="color:purple;">**HTTP / HTTPS**</mark> 协议，该协议完全受支持。
{% endhint %}

## 配置住宅代理

1. 在 [**Residential proxy**](https://dashboard.proxyshard.com/en/residential-main) 页面打开您的订单，设置代理参数（国家、地区、协议、TTL、端口等）。
2. 点击 <mark style="color:purple;">**Generate proxy**</mark>，生成的代理将显示在右侧的 <mark style="color:purple;">Proxy List</mark> 区块中。
3. 使用 <mark style="color:purple;">**Copy all**</mark> 按钮复制连接字符串。
4. 打开 ProxyShard 扩展程序（地址栏右侧已固定的图标）。

<figure><img src="/files/5nsrCkAbK0H1N6kYxFuq" alt="在控制面板生成住宅代理"><figcaption><p>步骤 1-4：在控制面板配置并复制代理</p></figcaption></figure>

5. 在扩展程序底部的输入框中，按 `ip:port:login:password` 格式**粘贴已复制的字符串**，然后点击 <mark style="color:purple;">**Add**</mark>。

<div align="center"><figure><img src="/files/0CwVt9rpm7HHxASf9Lf9" alt="在扩展程序中添加代理"><figcaption><p>步骤 5：粘贴代理并添加配置文件</p></figcaption></figure></div>

6. 配置文件将出现在列表中。点击 <mark style="color:purple;">**Test**</mark> 验证可用性，然后点击 <mark style="color:purple;">**Play**</mark> 按钮以激活代理。

<div align="center"><figure><img src="/files/WpTe9e7OILf0pELqunVv" alt="在扩展程序中激活代理"><figcaption><p>步骤 6：测试并启动配置文件</p></figcaption></figure></div>

## 配置 Datacenter / ISP 代理

1. 在控制面板打开您的 <mark style="color:purple;">Datacenter</mark> 或 <mark style="color:purple;">ISP proxy</mark> 订单，从 <mark style="color:purple;">Proxy List</mark> 区块**复制**连接字符串。
2. 打开已固定的 **ProxyShard** 扩展程序。

<figure><img src="/files/62shMwfnXYtxRY174lsh" alt="从 DC/ISP 订单复制代理"><figcaption><p>步骤 1-2：从订单复制代理并打开扩展程序</p></figcaption></figure>

3. 在扩展程序底部的输入框中**粘贴代理**（`ip:port:login:password`），然后点击 <mark style="color:purple;">**Add**</mark>。

<div align="center"><figure><img src="/files/uCba9aRqYOi5OxnsXxYX" alt="将代理粘贴到扩展程序"><figcaption><p>步骤 3：将代理粘贴到扩展程序</p></figcaption></figure></div>

4. 点击 <mark style="color:purple;">**Test**</mark> 验证，然后通过 <mark style="color:purple;">**Play**</mark> 按钮激活配置文件。

<div align="center"><figure><img src="/files/HmDmI4yf2O7fKQDvaRMN" alt="激活 DC/ISP 配置文件"><figcaption><p>步骤 4：测试并启动配置文件</p></figcaption></figure></div>

{% hint style="info" %}
**移动代理：按计时器或热键进行 IP 轮换**

编辑配置文件时，可以使用 <mark style="color:purple;">**IP Rotation**</mark> 区块，该功能对<mark style="color:purple;">移动代理</mark>特别有用：

* **Rotation URL** - 粘贴来自您移动代理订单的 IP 切换链接，扩展程序将自动调用它。
* **Trigger: Interval** - 按设定的时间间隔进行轮换。
* **Trigger: Hotkey** - 设置组合键（例如 `Shift+F2`）来即时切换 IP。
* **Track IP history** - 重复检测功能：如果在会话期间出现相同的 IP 地址，扩展程序将通知您。

<img src="/files/BC8CgURW9F4Qmc3MrT7F" alt="配置文件设置中的 IP Rotation 区块" data-size="original">
{% endhint %}

## 手动添加配置文件

如果您希望手动创建配置文件，而不是粘贴现成的字符串，请使用完整的 <mark style="color:purple;">**+ Add Profile**</mark> 表单。

1. 在扩展程序中打开 <mark style="color:purple;">**Profiles**</mark> 部分（通过齿轮 / 设置图标）。
2. 点击右上角的 <mark style="color:purple;">**+ Add Profile**</mark> 按钮。
3. 填写配置文件参数：
   * <mark style="color:purple;">**Name**</mark> - 任意配置文件名称
   * <mark style="color:purple;">**Color**</mark> - 用于方便识别的颜色标签
   * <mark style="color:purple;">**Type**</mark> - 协议（推荐 `HTTP / HTTPS`）
   * <mark style="color:purple;">**Host**</mark> 与 <mark style="color:purple;">**Port**</mark> - 代理服务器地址和端口
   * <mark style="color:purple;">**Bypass List**</mark> - 需要**直接**绕过代理的 IP / 域名列表（每行一条）
   * <mark style="color:purple;">**Username**</mark> / <mark style="color:purple;">**Password**</mark> - 身份验证信息
4. 点击 <mark style="color:purple;">**Save Profile**</mark>。

<figure><img src="/files/QkQLyNPYEYmSYyna0qdh" alt="手动添加配置文件"><figcaption><p>完整的配置文件创建表单</p></figcaption></figure>

{% hint style="success" %}
**完成！** ProxyShard 扩展程序已完全配置并可立即使用。在任何基于 Chromium 的浏览器中一键切换代理。
{% endhint %}


---

# 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:

```
GET https://docs.proxyshard.com/cn/chan-pin/proxyshard-extension.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
