几分钟完成接入，而非几天。

身份验证

每个请求均通过嵌入在连接 URL 中的标准代理 Basic Auth 进行身份验证——无需独立的 API 密钥或 OAuth 流程。用户名本身即编码了您的套餐和路由参数。

protocol://username:<pass>@gate.bifrostnetwork.cc:9521

可通过 Telegram 机器人的账户菜单随时重置密码——旧密码将在下一次连接请求时失效并切切换至新凭证。

端点与会话语法

用户名由连字符连接：包含套餐代码、账户 ID 以及若干路由修饰符。

<plan>.base_<account_id>-country-us-session-3439b03c-ttl-300

协议支持

同一个网关与凭证同时支持三种传输协议——您可自由按请求选择，无需创建多个通道或账户。

地理位置与 ASN 定位

可通过 ISO 国家代码或运营商 ASN 筛选出口 IP 池（住宅套餐支持 ASN 定位）。遇到未覆盖的组合时会自动退回至最贴近的节点。

resi.eco_b28ed8682f-country-us-asn-7018

代码示例

curl

$ curl -x socks5h://resi.eco_b28ed8682f-country-us-session-288ed66a:<pass>@gate.bifrostnetwork.cc:9521 https://httpbin.org/ip

Python (requests)

# pip install "requests[socks]"
import requests

proxy = "socks5h://resi.eco_b28ed8682f-country-us-session-288ed66a:@gate.bifrostnetwork.cc:9521"
r = requests.get("https://httpbin.org/ip", proxies={"http": proxy, "https": proxy})
print(r.json())

Node.js

// npm install socks-proxy-agent
import { SocksProxyAgent } from "socks-proxy-agent";

const agent = new SocksProxyAgent(
  "socks5h://resi.eco_b28ed8682f-country-us-session-288ed66a:@gate.bifrostnetwork.cc:9521"
);
const res = await fetch("https://httpbin.org/ip", { agent });
console.log(await res.json());

故障排查

使用 Chrome 插件

Bifrost Proxy Manager 是一款 Manifest V3 Chrome 插件，无需离开浏览器即可连接官方 Bifrost 代理，或任意 HTTP/HTTPS/SOCKS5 代理。本节介绍安装、配置与故障排查。

安装

1. 从 Chrome 网上应用店安装 Bifrost Proxy Manager。
2. 将插件固定到工具栏，方便随时一键打开。
3. 点击图标打开弹窗——在这里切换模式、管理配置并查看连接状态。

用账户 Token 连接

要通过插件使用官方 Bifrost 代理网络，你需要一个账户 Token，而不是套餐连接字符串。

1. 登录你的控制面板，在“设置 → 账户 API Token”中复制账户 Token。
2. 打开插件弹窗，进入“设置”，将 Token 粘贴到“Bifrost 账户 API Token”。
3. 回到主弹窗，选择“Bifrost 官方代理”模式，选好套餐和目标地区，点击“启用代理”。

设置好 Token 后，弹窗会自动拉取你已购买的套餐、可用地区和网关凭证，无需手动拼接连接字符串。

自定义代理配置

如果你没有使用官方 Bifrost 网络，或者想在自己运维的多个代理之间切换，可以使用“自定义代理配置”模式。

可以保存任意数量的配置。在它们之间切换——或切回官方 Bifrost 代理——都只需在弹窗里点一下，已保存的凭证无需重新输入。

验证连接

每次启用代理时，弹窗都会自动运行出口 IP 与地理位置检测，结果会直接显示在连接开关下方，让你在开始浏览前就能确认切换是否真的生效。

绕行列表（Bypass List）

无论当前使用哪种代理模式，都可以让本地和内网地址保持直连。在“设置 → 绕行列表”中，每行添加一条规则：

<local>
127.0.0.1
localhost
*.local
192.168.0.0/16

自动登录

对于需要认证的代理，插件会通过 Chrome 的 chrome.webRequest 认证 API 自动提交你保存的用户名和密码。这意味着：

• 即使是那些通常会弹出 Chrome 原生认证对话框的代理，也不会再弹出登录窗口。
• 凭证始终保存在 Chrome 插件本地存储中——只会发送给代理本身（或官方代理模式下的 Bifrost API），不会同步到任何第三方服务器。

故障排查

使用 BifrostBrowser

BifrostBrowser 是一款免费附赠给每一位 Bifrost 代理用户的指纹（防关联）浏览器。每个 profile 都是完全隔离的独立环境——各自的 Cookie、缓存，以及一套自洽的软硬件指纹——代理和指纹模板都在同一个应用里管理。

安装

从下载入口获取对应系统的安装包——页面会自动识别你当前系统并推荐正确的安装包。

如果 macOS 提示“BifrostBrowser.app 已损坏，无法打开”，这是 Gatekeeper 对未签名应用的隔离限制，不是安装包损坏。打开终端执行：

sudo xattr -rd com.apple.quarantine /Applications/BifrostBrowser.app

首次启动后，打开“设置 → BifrostNetwork 账户 Token”，粘贴你在控制面板用户菜单里拿到的 Token，点击“打开浏览器登录”即可将应用与你的账户关联。

工作区概览

• Workspace —— Browsers（你的 profile 列表：名称、状态、代理、备注、最近使用时间）和 Proxies（已保存的代理池）。
• Library —— Fingerprints，可浏览的真机指纹模板库。
• System —— Settings。

Browsers 面板顶部会实时显示：profile 总数、正在运行的数量、已保存代理数量，以及指纹库里可用的模板数量。

新建一个 Profile

在 Browsers 页面点“+ New profile”（或选“From template”直接套用一个精选指纹模板，而不是逐项手动填写）。编辑界面分成五块：

配置完成后点击“Create profile”即可。

指纹库

Library → Fingerprints 存放的是真实设备采集来的指纹快照，用于填充 profile 编辑界面里的 GPU/设备选择器。模板按系统分类（macOS/Windows/Linux），按机型命名（如 mac-m1-air13、mac-m2-pro-mbp14），每条都标注了对应的 Chrome 版本和渲染器字符串。点击任意卡片上的“Use →”即可以它为基础新建 profile，也可以用“Import from file”或“+ Paste JSON”导入从其他 BifrostBrowser profile 导出的指纹来扩充这个库。

添加代理

前往 Proxies 页面，使用“BifrostNetwork 代理极速生成器”直接读取你名下已购买的套餐，无需手动拼接连接字符串：

点击“生成并批量导入”即可直接创建并加入你的 Proxies 列表，随时可绑定到任意 profile。这里使用的是与 Bifrost 网关其余部分相同的账户和套餐——如果想手动拼接连接字符串，可参考上文的端点语法。

自动化 API

BifrostBrowser 提供一个本地 HTTP API 供脚本调用——创建、启动、关闭 profile，并获取 CDP WebSocket 地址，接入 Playwright、Puppeteer 或任意兼容 CDP 的客户端。

• 仅绑定在 127.0.0.1——外部机器无法访问。
• 认证方式：JWT Bearer Token——请求头携带 Authorization: Bearer <token>。
• 默认端口：40325，显示为 Base URL，并固定在侧边栏底部方便随时复制。

GET/POST http://127.0.0.1:40325/...
Authorization: Bearer <token>

设置一览

故障排查

下一步