# Chrome 扩展（Beta）

> URL: https://foura.ai/zh/docs/dashboard/chrome-extension
> Updated: 2026-11-05
> Index: https://foura.ai/llms.txt

FourA Chrome 扩展为您的浏览器提供两款工具。**弹出窗口**通过 [proxy port](https://foura.ai/docs/api/proxy-port) 上的某个 proxy 用户转发 Chrome 流量。**DevTools 中的 FourA 标签页**可将页面发出的任何 request 转换为就绪的 API 调用。

该扩展目前处于公测阶段。它尚未上架 Chrome Web Store，因此需要在 Chrome 开发者模式下安装，其界面和设置可能仍会变动。它需要 Chrome 116 或更高版本，支持所有套餐（包括 Free 套餐）。

## 安装

Zip 文件位于控制面板中：打开侧边栏 **Tools** 下的 **Extension**，然后点击 **Download**。

1. 下载该 zip 文件并解压。请保留解压后的文件夹：Chrome 将从中加载扩展程序。
2. 打开 `chrome://extensions` 并在右上角开启**开发者模式**。
3. 点击**加载已解压的扩展程序**并选择解压后的文件夹。
4. 从工具栏的拼图图标处固定 FourA。FourA 未开启时图标为灰色，路由中时显示绿点。

### 更新

扩展程序每小时及打开弹出窗口时会检查新版本，弹出窗口“设置”中“版本”下的 **Check now** 会立即检查。发布新版本时，弹出窗口会显示该版本及 **Download** 按钮。解压新版本并使用**加载已解压的扩展程序**选择其文件夹。无论新版本来自哪个文件夹，FourA 都会自动替换并保留您的设置。如果您将其解压并覆盖了当前文件夹，点击 **Reload FourA** 即可。从 0.3.1 或更早版本升级时，它会作为一张新卡片安装：请重新选择您的 proxy 用户并移除旧卡片。

## 开始之前

- 一个 proxy 用户。在控制面板的 **Proxy** 页面创建：参见 [Proxy](https://foura.ai/docs/dashboard/proxy)。
- 在同一 Chrome 中登录控制面板。该扩展程序仅从控制面板读取您的 proxy 用户。若未打开控制面板标签页，它会在后台打开一个以读取数据，随后将其关闭。

## 通过 FourA 浏览

弹出窗口包含三个页面：**连接**、**位置**和**设置**。

### 连接

1. 从工具栏打开 FourA 并选择此浏览器使用的 proxy 用户。
2. 点击大开关。
3. 查看 **Address sites see**。FourA 会通过隧道测量该地址，而不是直接根据设置推测，并在旁边显示 **Your address** 以供比对。

**Traffic this period** 显示您当前套餐已使用的 proxy 流量配额。

### 位置

- **网络：** **共享**（我们的池，套餐流量）或 **高级**（家庭住宅地址，扣除套餐的高级流量）。在“共享”模式下，**共享网络无法加载页面时使用高级网络** 会在共享网络无法承载请求时改用高级出口节点。该功能仅在套餐包含高级流量且仍有剩余配额时触发。
- **国家/地区：** 默认任意国家/地区。最近使用的国家/地区支持一键切换。
- **地区**、**城市** 和 **网络运营商：** 仅限高级模式，选择国家/地区后可用。
- **地址：** **固定** 会保留相同出口节点，**每次请求更新** 会在每次请求时变更，**更换地址** 会立即获取新地址。在高级模式且选择 **固定** 时，**保留时长** 可设置该地址的保留时间（以分钟或小时为单位）。

这些选项背后的开关与 [Proxy Port](https://foura.ai/docs/api/proxy-port) 中介绍的代理端口参数完全一致。

### 设置

- **通过隧道传输的内容：** **除此列表外的所有流量** 或 **仅限这些**。`example.com` 覆盖其子域名，`*` 支持通配符，`203.0.113.0/24` 为 IP 地址段。
- **绝不对本地网络或本机使用隧道：** 不含点号的主机名、`localhost`、`.local` 以及私有 IP 地址段均走本地连接，不受上述规则列表影响。
- **允许纯 http:// 页面使用本地连接：** 该代理端口仅传输加密连接。关闭时，纯 `http://` 页面将无法加载。开启时，它将通过您的本地连接加载，且目标网站能看到您的真实地址。
- **防止 WebRTC 绕过代理：** 禁用页面在开启隧道时用于读取真实地址的途径。
- **无痕窗口：** 同样会使用该隧道。只有在您授权后，FourA 才能在无痕模式下自动填充代理密码：`chrome://extensions`、FourA、**详细信息**、**在无痕模式下启用**。在此之前，Chrome 会在无痕窗口中向您请求密码。
- **主题：** 弹窗支持 **跟随系统**、**浅色** 或 **深色**。
- **供其他工具使用的代理地址：** 所选代理用户的代理 URL（包含密码），可直接粘贴至任何支持代理的客户端。请将其视作密码妥善保管。
- **代理用户：** **从控制面板重新加载** 可同步已创建或修改的代理用户。**在此计算机上清除** 会将其从当前浏览器中移除。

### 图标变红时

带有数字的红色图标表示代理在过去一分钟内拒绝了相应数量的连接。打开 FourA 查看原因。最常见的原因如下：

- **同时连接数过多：** 达到套餐对活动隧道的限制。当连接关闭时，页面的部分内容会重新加载。
- **本分钟新建连接数过多：** 达到套餐对每分钟新建隧道的限制。请等待一分钟后再重新加载，因为每次重试也会计入限制。
- **本期 proxy 流量已用尽** 或 **Premium 流量已用尽：** 请在 **Billing** 页面添加流量，或等待下一个计费周期。
- **该 proxy 不在您的套餐内：** 请在 **Billing** 页面查看套餐详情。
- **proxy 未接受密码：** 控制台中的 proxy 用户可能已被轮换或删除。请重新选择。
- **其他扩展程序正在控制 proxy：** 当其他扩展程序占用 Chrome 的 proxy 设置时，FourA 不会路由任何内容。请关闭该扩展程序，然后将开关关闭并重新打开。

您套餐的当前限制可在 [Usage & Limits](https://foura.ai/docs/dashboard/quota) 页面查看。

## 将 Request 转换为 API 调用

1. 在任意页面打开 DevTools，选择 Network 旁边的 **FourA** 标签页（当 DevTools 窗口较窄时位于 `»` 后面）。如果在安装 FourA 时 DevTools 已处于打开状态，请将其关闭后重新打开。
2. 重新加载页面。该标签页会像 Network 一样列出页面的 request。**Hide ads and analytics** 默认开启，**This site only** 仅保留该页面自身的 request。
3. 在 **Find in responses** 中输入页面上看到的文本，以查找包含该文本的 request。选择该 request 即可查看其 **Headers**、**Payload** 和 **Response**。
4. 在 **FourA call** 下选择引擎（Single、Proxy Finder 或 Browser）；对于 Proxy Finder，可选择配置 **Exit country**，然后将调用复制为 cURL、Python、Node 或 MCP 代码。调用会携带页面所使用的 header 和 cookie。**Present the same browser and system as this window** 默认开启：调用会请求与当前 Chrome 匹配的浏览器配置文件，若在 Browser 模式下则发送当前窗口的 User-Agent。
5. 点击 **Open in the playground** 将调用加载到控制台的 [Playground](https://foura.ai/docs/dashboard/playground) 中，或点击 **Run through FourA** 直接运行。运行后，**The browser got** 和 **FourA got** 将并排显示页面原始响应与我们的响应。

右键点击 request 可使用相同的复制选项，并支持 **Copy URL**、**Copy response** 以及 **Open in a new tab**。

### 运行所需的 API Key

**Run through FourA** 需要使用 API key 及其积分。请在该标签页的 **Settings** 中进行配置：

1. 点击 **Choose from your dashboard** 选择一个 key，或在 **Or paste an API key** 中粘贴一个 key。
2. 勾选 **Keep the key on this computer** 可在 Chrome 关闭后继续保留该 key。否则关闭 Chrome 时将被清除。
3. **Forget the key** 可将其移除。

若该 key 属于您的账户，Playground 打开时会自动选择相同的 key。否则会提示您选择一个。

## 计费说明

此扩展免费。通过我们出口节点发送的流量会计入您套餐的 proxy 配额，与 proxy 端口上的任何其他客户端相同。从 DevTools 发起的调用按 API 标准计费。参见 [套餐与计量](https://foura.ai/docs/guides/plans-and-metering)。

## 存储与发送的数据

- 您选择的 proxy 用户名和密码仅保留在本机上。
- 您在 DevTools 标签页中配置的 API key 会保留至 Chrome 关闭，或在您明确要求时保存在本机上。
- 不会存储或向我们发送任何与您访问的页面相关的信息。
- 该扩展本身仅会请求 ipinfo.io（若繁忙则请求 Cloudflare，随后请求 api.ipify.org）以获取目标站点看到的地址，每小时及打开时请求一次 foura.ai 以检查当前版本，从控制台读取您的 proxy 用户及国家列表，并通过 dns.google 或 Cloudflare 查询 proxy 地址。其他所有操作均在您点击按钮时触发。
- 携带 cookie 复制的请求会重放您已登录的会话。请将其视为密码对待，切勿粘贴到任何公开场合。
- 在开关开启状态下更改设置时，FourA 会清除 Chrome 保存的 proxy 凭据，以使新配置对 proxy 生效。该清理操作仅针对 proxy 自身的地址：您的 cookie 会被保留，控制台登录状态亦不受影响。

## 限制

- 您的浏览器会通过隧道自行建立加密连接，因此目标站点看到的是我们的地址和您的浏览器。执行身份校验的页面以及完整的浏览器渲染由 API 处理：参见 [站点校验](https://foura.ai/docs/api/site-checks)。
- Chrome 是该扩展构建和测试所支持的唯一浏览器。
