Быстрая интеграция за пару минут.

Аутентификация

Все запросы используют стандартную Proxy Basic Auth в URL подключения. Логин содержит код вашего тарифа и параметры маршрутизации.

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

Вы можете сбросить пароль в любое время через меню бота в Telegram.

Синтаксис эндпоинтов и сессий

Имя пользователя формируется через дефис: код тарифа, ID аккаунта и модификаторы маршрутизации.

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

Поддерживаемые протоколы

Один и тот же шлюз поддерживает все три протокола — выбирайте любой для каждого запроса.

Таргетинг по Geo и ASN

Фильтрация IP по ISO коду страны или 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 — расширение для Chrome на Manifest V3, которое подключается к официальному прокси Bifrost или к любому HTTP/HTTPS/SOCKS5 прокси, не покидая браузер. В этом разделе — установка, настройка и решение проблем.

Установка

1. Установите Bifrost Proxy Manager из Chrome Web Store.
2. Закрепите расширение на панели инструментов для доступа в один клик.
3. Откройте всплывающее окно по клику на иконку — здесь переключаются режимы, управляются профили и проверяется соединение.

Подключение по токену аккаунта

Чтобы использовать официальную сеть Bifrost через расширение, нужен токен аккаунта, а не строка подключения тарифа.

1. Войдите в панель управления и скопируйте токен аккаунта в разделе «Settings → Account API Token».
2. Откройте всплывающее окно расширения, перейдите в «Settings» и вставьте токен в поле «Bifrost Account API Token».
3. Вернитесь в главное окно, выберите режим «Bifrost Official Proxy», укажите тариф и регион, затем нажмите «Enable Proxy».

После установки токена всплывающее окно автоматически получает ваши тарифы, доступные регионы и данные шлюза — вручную собирать строку подключения не нужно.

Пользовательские профили прокси

Если вы не используете официальную сеть Bifrost — или хотите переключаться между несколькими своими прокси — используйте режим «Custom Proxy Profile».

Сохраняйте сколько угодно профилей. Переключение между ними — или обратно на официальный прокси Bifrost — занимает один клик; повторно вводить сохранённые данные не нужно.

Проверка соединения

При каждом включении прокси всплывающее окно автоматически проверяет исходящий IP и геолокацию. Результат отображается прямо под переключателем соединения, так что вы сразу видите, сработало ли переключение.

Список исключений (Bypass List)

Локальные и внутренние адреса можно оставить на прямом соединении независимо от активного режима прокси. В «Settings → Bypass List» добавьте по одному правилу на строку:

<local>
127.0.0.1
localhost
*.local
192.168.0.0/16

Автоматический вход

Для прокси, требующих аутентификации, расширение автоматически передаёт сохранённые логин и пароль через API chrome.webRequest. Это означает:

• Окно входа больше не появляется, даже для прокси, которые обычно вызывают стандартный диалог аутентификации Chrome.
• Учётные данные хранятся только в локальном хранилище расширения Chrome — они передаются только самому прокси (или в API Bifrost для официального режима) и никогда не синхронизируются со сторонними серверами.

Решение проблем

Использование BifrostBrowser

BifrostBrowser — антидетект-браузер, который бесплатно включён в каждый аккаунт Bifrost. Каждый профиль — полностью изолированная среда: свои cookies, кэш и согласованный аппаратно-программный отпечаток. Прокси и шаблоны отпечатков управляются из того же приложения.

Установка

Скачайте сборку для своей ОС из раздела загрузки — страница сама определит систему и предложит нужный установщик.

Если macOS сообщает «BifrostBrowser.app повреждён и не может быть открыт» — это карантин Gatekeeper для неподписанного приложения, а не повреждённая загрузка. Снимите его через Терминал:

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

При первом запуске откройте «Settings → BifrostNetwork Account Token», вставьте токен из меню пользователя в панели управления и нажмите «Open Browser to Login», чтобы привязать приложение к аккаунту.

Обзор рабочей области

• Workspace — Browsers (список профилей: имя, статус, прокси, заметки, последнее использование) и Proxies (сохранённый пул прокси).
• Library — Fingerprints, библиотека шаблонов отпечатков реальных устройств.
• System — Settings.

В верхней части панели Browsers отображаются счётчики: всего профилей, сколько сейчас запущено, сохранённых прокси и доступных шаблонов в библиотеке.

Создание профиля

На вкладке Browsers нажмите «+ New profile» (или «From template», чтобы взять готовый отпечаток вместо ручной настройки каждого поля). Редактор разделён на пять секций:

По завершении нажмите «Create profile».

Библиотека отпечатков

Library → Fingerprints хранит снимки отпечатков, собранные с реальных устройств — они заполняют селектор GPU/устройства в редакторе профиля. Шаблоны сгруппированы по ОС (macOS, Windows, Linux) и названы по модели устройства (например mac-m1-air13, mac-m2-pro-mbp14), каждый помечен версией Chrome и строкой рендерера с реальной машины. Нажмите «Use →» на любой карточке, чтобы создать профиль на её основе, либо пополните библиотеку через «Import from file» или «+ Paste JSON», используя отпечаток, экспортированный из другого профиля BifrostBrowser.

Добавление прокси

Перейдите в Proxies и используйте «BifrostNetwork Proxy Quick Generator», чтобы брать данные напрямую из купленных тарифов вместо ручного набора строки подключения:

Нажмите «Generate and batch import» — прокси сразу попадут в список Proxies и будут готовы к привязке к любому профилю. Используется тот же аккаунт и те же тарифы, что и во всём шлюзе Bifrost — если хотите собрать строку подключения вручную, см. синтаксис эндпоинтов выше.

Automation API

BifrostBrowser предоставляет локальный HTTP API для автоматизации: создание, запуск и закрытие профилей, а также получение адреса 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>

Справочник настроек

Решение проблем

Дальнейшие шаги