防关联浏览器与 Qubix Connector
Qubix 通过您在防关联浏览器中的配置文件之眼来采集 Facebook 数据——这样平台看到的广告账户、广告系列和主页，就如同账户本身所见，而不是来自外部的请求。防关联浏览器与 Qubix 之间的纽带，就是 Qubix Connector 扩展。
该扩展只需安装一次。之后它会自行连接到您的防关联浏览器，连同代理一起拉取配置文件列表，并与 Qubix 保持联系——通常您无需输入任何内容。
Qubix 与普通解析器有何不同
- 账户存活更久、被封更少——采集从您的配置文件内部运行，不经过 Facebook 会以封号回应的第三方 API。
- 您的数据留在您手中——Qubix 在本地（on-premise）运行：无需交出密钥，也无需把别人的应用接入您的 Facebook。
- 无需让配置文件保持打开——采集自行按计划运行，即使浏览器已关闭。
- 团队自动运转——管理员设置一次，买量人员无需做任何事。
- 开箱即用支持 6 款防关联浏览器——AdsPower、Dolphin Anty、Multilogin、GoLogin、Incogniton、Vision。
为什么对账户更安全
普通解析器从外部访问 Facebook——通过第三方 API 和访问令牌。Facebook 会率先注意到这类请求，账户也因此被封。中间商服务走得更远：他们要求您交出密钥，或把他们的应用接入您的 Facebook——于是您的统计数据和访问权限就落到了别人那一边。
Qubix 不这样做。在 Facebook 看来，这就是您账户的正常活动，而非第三方程序——没有外部请求、访问密钥或外来应用。访问权限和统计数据哪里都不去：一切只留在您手中，在您自己的基础设施上。
您无需让配置文件保持打开
您无需让防关联配置文件一直运行。一旦 Connector 传递了会话，Qubix 就会自行持续采集数据——按计划进行，即使配置文件和浏览器都已关闭。唯一重要的是配置文件在 Facebook 上保持已登录状态；您无需让它一直打开。
当配置文件很多时这尤其方便：一个买量人员可能拥有数十个——无需仅仅为了采集而让它们全部打开，Qubix 会自行逐一处理。
您很少需要介入——例如，如果配置文件退出了 Facebook 登录，需要刷新会话。此时 Qubix 会在 Telegram 中提醒您：既在共享的采集错误频道中，也会私下通知负责的买量人员。您只需打开配置文件、重新登录——采集便会继续。
Connector 如何看到您的浏览器
Connector 在本地端口上与防关联浏览器的本地 API 通信。对大多数浏览器，Connector 会直接在那里读取配置文件及其代理的列表；对某些浏览器（Dolphin Anty、GoLogin），本地端口仅用于确认浏览器正在运行，配置文件列表则来自服务商的云端 API。无论哪种方式，都必须启用防关联浏览器的本地 API。
在大多数浏览器中它默认开启。如果扩展报告找不到浏览器或其 API 无响应，请打开防关联浏览器设置并启用本地 API（该选项可能叫 Local API、API 或 Local API Server），使浏览器在其本地地址和端口上侦听。每款浏览器都有各自的端口——见下表。
如果计算机上同时运行着多个防关联浏览器，您需要在扩展窗口中选出正确的那一个。
Connector 窗口会显示连接阶段：搜索 → API 检查 → 配置文件 → 服务器检查 → ✓ 已连接。
支持的浏览器
| 浏览器 | 本地 API（端口） | 是否需要 API 密钥 | 密钥格式 |
|---|---|---|---|
| AdsPower | 50325 | 可选 | Bearer token |
| Dolphin Anty | 3001 | 需要 | Bearer token |
| Multilogin | 45001 | 需要 | email:password |
| GoLogin | 36912 | 需要 | Bearer token |
| Incogniton | 35000 | 不需要 | — |
| Vision | 3030 | 需要 | token |
| Donut | 10108 | —（开发中） | — |
表中的端口是浏览器本地 API 的地址。如果 Connector 无法连接，请检查防关联浏览器设置中是否启用了本地 API 并在该端口上侦听。
有两款浏览器完全不需要 API 密钥：Incogniton（其本地 API 无需授权——返回完整的配置文件，包括代理）和 AdsPower（它会从启动 URL 给出当前配置文件的标识符——但仅有标识符；代理、名称和分组只有用密钥才能读取）。其余浏览器则需要密钥。
API 密钥：何时需要、从哪里获取
- 没有密钥时，Connector 只能看到当前打开的配置文件（对大多数浏览器——连这个都看不到）。如果该配置文件已为 Qubix 所知，这就足够了（见**「快捷通道」**一节）。
- 有密钥时，扩展会一次性从防关联浏览器中拉取全部配置文件——连同代理、名称、分组和 IP 所属国家——并发送给 Qubix。
密钥从防关联浏览器自身的控制面板（API / 设置部分）获取，并通过 Admin Mode 开关在扩展窗口中输入：打开弹窗 → Admin Mode → 把密钥粘贴到 API key 字段（带上您浏览器的名称，例如「API key AdsPower」）。每款浏览器的密钥格式见上表。
Multilogin 使用 email:password 组合而非令牌。此外，在 Mimic 配置文件设置中启用 Port scan protection → Custom 并添加允许的端口 5030,45001——否则 Connector 看不到您的配置文件。
快捷通道：管理员设置一次
最便捷的方案，是根本无需为每位买量人员输入密钥。
如果管理员一次性连接一个保存着团队配置文件的防关联浏览器并输入 API 密钥，Connector 就会读取整个配置文件列表（含代理）并在 Qubix 中保持更新。此后这些配置文件便已在服务器上注册。
现在任何买量人员打开自己的配置文件时，都会进入快捷通道：Qubix 已经知道该配置文件及其代理，扩展会显示一个简洁的**「✓ 已连接」**——无需输入任何内容。既不需要密钥，也不需要代理。
推荐的部署模式
全自动通道——买量人员无需输入任何内容——适用于那些不需要 API 密钥的防关联浏览器：AdsPower 和 Incogniton。对于团队，我们推荐 AdsPower——它最为常见，并且支持集中地把扩展推送到所有配置文件。对于其他浏览器（Dolphin、Multilogin、GoLogin、Vision），需要在每个配置文件中各输入一次密钥。
在 AdsPower 上：
- 管理员连接 AdsPower 并输入 API 密钥——使用一个能看到团队全部配置文件的账户。Connector 读取整个配置文件列表（含代理）并在 Qubix 中注册它们。
- 集中分发扩展——AdsPower 支持一次性把它添加到团队的所有配置文件，无需为每位买量人员手动安装。
- 买量人员自行连接——配置文件已为 Qubix 所知，Connector 显示**「✓ 已连接」**。一个打开且已登录的配置文件就足够了。
AdsPower + 管理员的密钥 = 整个团队开箱即用，买量人员一方无需任何密钥或代理。
买量人员需要手动输入什么
仅在三种情况下需要手动输入。
1. 未设置代理
如果 Qubix 还不知道该配置文件的代理，扩展会显示「proxy not set」。您可以这样设置代理：
- 在扩展窗口中（买量人员）——字符串
socks5://user:pass@host:port→ 保存； - 在防关联浏览器配置文件设置中（买量人员）——设置代理并重启配置文件，Connector 会自行获取；
- 在 Qubix 中，设置 → 浏览器（管理员）——配置文件卡片 → 代理 → 编辑（详见 浏览器）。在配置文件出现在列表中之后可用（扩展已至少上报过一次）；买量人员可能看不到自己新出现的配置文件——归因按广告系列进行。
一旦以上述任意方式设置了代理，该配置文件便切换到快捷通道，您也无需再在扩展中输入它。
2. API 密钥
如果该配置文件尚未为服务器所知，且防关联浏览器需要密钥才能访问其配置文件。通过 Admin Mode 输入（见上文**「API 密钥」**一节）。
3. Localhost 被拦截
如果配置文件的代理连本地地址也一并拦截，Connector 便无法读取配置文件标识符。一次性修复方法：
- 在防关联浏览器配置文件设置中把代理切换为 「No proxy」 并保存。
- 重启配置文件——Connector 读取并记住标识符。
- 在配置文件设置中恢复代理并再次重启。
之后，扩展窗口中所要做的，就只剩下输入代理字符串并按 保存。
扩展采集哪些内容
Connector 把防关联浏览器配置文件的数据传给 Qubix：标识符、名称、分组、代理字符串、IP 和国家。配置文件标识符是自动确定的——您无法手动输入（打错字的风险太高）。如果无法确定防关联浏览器或它没有密钥，Connector 也不会让您卡住：它会自行创建一个标识符并请您设置代理——按下 「Save」 后，采集即开始。扩展使用配置文件中已经打开的 Facebook 会话——无需单独登录 Qubix。
连接：简要步骤
- 打开设置 → 浏览器，点击 下载扩展。
- 把扩展安装到正确的防关联浏览器配置文件中。
- 确认配置文件已登录 Facebook。
- 打开 Connector 窗口，等待**「✓ 已连接」**。如有需要，按提示输入密钥或代理。