Bifrost Logo BifrostNetwork
Documentación para Desarrolladores

Integración en minutos, no en días.

Todo lo que necesita para conectar con BifrostNetwork: autenticación, sintaxis de endpoints, protocolos y código funcional en tres lenguajes.

01

Inicio rápido

  1. Cree una cuenta y adquiera cualquier plan desde su panel de control; las credenciales se emiten al instante sin esperas.
  2. Copie la cadena de conexión que se muestra en los detalles de su pedido (usuario, contraseña y host del gateway).
  3. Envíe una solicitud de prueba. Si devuelve una IP residencial que no es la suya, la conexión se ha establecido con éxito.
$ curl -x socks5h://resi.eco_b28ed8682f-country-us:<pass>@gate.bifrostnetwork.cc:9521 https://httpbin.org/ip
{ "origin": "203.0.113.42 (US Residential Node)" }
02

Autenticación

Cada solicitud se autentica mediante la autenticación básica de proxy (Basic Auth) estándar integrada directamente en la URL de conexión, sin necesidad de claves de API independientes ni flujos OAuth. El propio nombre de usuario codifica su plan y las opciones de enrutamiento.

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

Puede restablecer su contraseña en cualquier momento desde el menú del bot de Telegram; las sesiones antiguas se renovarán en su próxima conexión con las nuevas credenciales.

03

Sintaxis de endpoints y sesiones

El nombre de usuario es una cadena delimitada por guiones que contiene su código de plan, ID de cuenta y modificadores de enrutamiento.

<plan>.base_<account_id>-country-us-session-3439b03c-ttl-300
Modificador Ejemplo Efecto / Descripción
-country-xx -country-de Enruta a través de un nodo de salida en el código de país ISO especificado.
-session-id -session-3439b03c Mantiene la misma IP de salida para todas las solicitudes con este identificador (sesión fija o sticky).
-ttl-seconds -ttl-300 Duración de vida de la sesión fija en segundos (600 segundos por defecto si se omite).
(sin -session) Cada solicitud obtiene una nueva dirección IP rotativa de forma automática.
04

Protocolos soportados

El mismo gateway y credenciales admiten los tres protocolos de transporte; puede elegir libremente según cada solicitud sin crear túneles adicionales.

SOCKS5

Recomendado por defecto. Soporte nativo para TCP y UDP ASSOCIATE, compatible con tráfico QUIC.

HTTP / HTTPS

Túnel CONNECT estándar: configure directamente las mismas credenciales en cualquier cliente HTTP.

UDP / QUIC

Soporte nativo para HTTP/3 y escenarios de baja latencia, superando las limitaciones de los proxies TCP tradicionales.

05

Segmentación por Geo y ASN

Filtre el grupo de IPs por código de país ISO o ASN del proveedor (segmentación ASN disponible en planes residenciales). Si no hay disponibilidad, se redirige al nodo más cercano.

resi.eco_b28ed8682f-country-us-asn-7018
06

Ejemplos de código

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());
07

Resolución de problemas

Síntoma Causa probable y solución
407 Proxy Auth Required Verifique su usuario y contraseña; recuerde que distinguen entre mayúsculas y minúsculas.
Tiempo de espera agotado (Connection timeout) Utilice socks5h en lugar de socks5 para que la resolución de DNS se realice en el proxy.
La IP no cambia entre solicitudes Elimine el parámetro -session- o genere un nuevo ID de sesión para forzar la rotación.
Grupo de país especificado vacío El sistema asignará automáticamente el nodo disponible más próximo si faltan nodos en esa región.
08

Uso de la Extensión para Chrome

Bifrost Proxy Manager es una extensión de Chrome bajo Manifest V3 que le permite conectarse a la red oficial de proxies Bifrost o a cualquier proxy HTTP/HTTPS/SOCKS5 sin salir de su navegador.

Instalación

  1. Instale Bifrost Proxy Manager desde Chrome Web Store.
  2. Fije la extensión en la barra de herramientas para acceder a ella con un solo clic.
  3. Haga clic en el icono para abrir la ventana emergente, gestionar perfiles y verificar el estado de conexión.

Conectar mediante Token de cuenta

Para utilizar la red oficial de Bifrost mediante la extensión, necesita un Token de API de cuenta en lugar de una cadena de conexión de plan.

  1. Inicie sesión en su panel de control y copie el token en 'Configuración → Token API de cuenta'.
  2. Abra la extensión, vaya a 'Configuración' y pegue su token en 'Token API de cuenta Bifrost'.
  3. Regrese a la ventana principal, elija el modo 'Proxy Oficial Bifrost', seleccione el plan y la región deseada, y haga clic en 'Activar Proxy'.

Una vez configurado el token, la extensión cargará automáticamente sus planes contratados y regiones disponibles sin necesidad de configurar cadenas manualmente.

Perfiles de proxy personalizados

Si utiliza proxies propios fuera de la red de Bifrost, puede alternar entre ellos con el modo 'Perfil de proxy personalizado'.

Campo Descripción
Protocolo HTTP, HTTPS o SOCKS5
Host / Puerto Dirección y puerto de su servidor proxy
Usuario / Contraseña Opcional (dejar vacío si el proxy no requiere autenticación)
Nombre del perfil Etiqueta identificativa (ej.: 'VPN Trabajo', 'Servidor Hogar')

Guarde un número ilimitado de perfiles y alterne entre ellos con un solo clic.

Verificar conexión

Cada vez que activa el proxy, la extensión comprueba automáticamente la IP de salida y la geolocalización, mostrándolas directamente en pantalla.

Lista de exclusión (Bypass List)

Permita que las direcciones locales e intranets se conecten directamente sin pasar por el proxy configurando reglas en 'Configuración → Lista de exclusión':

<local>
127.0.0.1
localhost
*.local
192.168.0.0/16

Inicio de sesión automático

Para proxies con autenticación, la extensión envía las credenciales guardadas automáticamente a través de la API chrome.webRequest:

  • No aparecerán diálogos nativos de autenticación de Chrome.
  • Las credenciales se almacenan exclusivamente en el almacenamiento local de la extensión.

Resolución de problemas

Síntoma Causa y solución
Aviso 'Token de API no configurado' Guarde su token de cuenta en Configuración o use el modo de perfil personalizado.
La IP de salida no cambia Chrome puede estar utilizando una conexión en caché; recargue la página o reinicie el proxy.
Aparecen solicitudes de autenticación repetidas Verifique que el usuario y la contraseña del perfil sean correctos.
Sin acceso a dispositivos de red local Añada las IPs o subredes correspondientes a la lista de exclusión.
No aparecen planes en el selector de región El token puede haber caducado; genere uno nuevo en su panel de control.
09

Guía de BifrostBrowser

BifrostBrowser es un navegador antidetect gratuito para todos los usuarios de proxies Bifrost. Cada perfil opera como un entorno completamente aislado con sus propias cookies, caché y huella digital coherente.

Instalación

Descargue el instalador correspondiente a su sistema operativo desde la sección de descargas.

Sistema operativo Archivo
macOS (Apple Silicon) BifrostBrowser.dmg
Windows 10/11 (64 bits) BifrostBrowser.exe
Linux (Debian 10+ / Ubuntu 20.04+) BifrostBrowser.deb

Si macOS muestra el mensaje 'BifrostBrowser.app está dañado y no se puede abrir', ejecute el comando xattr en la Terminal para liberar la cuarentena de Gatekeeper:

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

Tras el primer inicio, vaya a 'Settings → BifrostNetwork Account Token', pegue el token de su panel de control y haga clic en 'Open Browser to Login'.

Resumen del espacio de trabajo

  • Workspace — Browsers (perfiles: nombre, estado, proxy, notas) y Proxies (grupo de proxies guardados).
  • Library — Fingerprints (biblioteca de plantillas de huellas de dispositivos reales).
  • System — Settings (configuración del sistema).

En la parte superior de Browsers verá en tiempo real el total de perfiles, los activos y las plantillas disponibles.

Crear un nuevo perfil

En Browsers, haga clic en '+ New profile' o use 'From template' para aplicar una plantilla optimizada:

Identity (Identidad)

  • Nombre del perfil — Etiqueta de búsqueda (ej.: shop-es-1)
  • Sistema operativo — macOS / Windows / Linux
  • GPU / Modelo de dispositivo — Seleccionado de la biblioteca de huellas
  • User-Agent — Rellenado automáticamente según el equipo seleccionado
  • Núcleos CPU / Memoria RAM (GB) — Especificaciones de hardware emuladas
  • Proxy — Vincular a un proxy guardado o mantener conexión directa

Locale (Configuración regional)

  • Zona horaria — Ajuste automático según la IP del proxy o manual
  • Idioma — Ajuste automático según el proxy o manual

Noise

Noise (Ruido de huella): Controle individualmente el ruido en señales como Canvas, WebGL, Audio, Client rects, Sensores y Fuentes. Incluye lista de bloqueo de puertos de acceso remoto.

Privacy (Privacidad)

  • WebRTC — Auto o manual
  • Do Not Track — Desactivado / Activado
  • Geolocalización — Auto (del proxy) o coordenadas manuales

Media Devices (Dispositivos multimedia)

  • Micrófono / Altavoces / Cámara — Cantidad de dispositivos virtuales reportados
  • Notas — Anotaciones personales

Una vez configurado, haga clic en 'Create profile'.

Biblioteca de huellas

Library → Fingerprints contiene instantáneas reales recopiladas de dispositivos físicos. Haga clic en 'Use →' en cualquier tarjeta para crear un perfil a partir de ella o importe huellas en formato JSON.

Añadir proxies

En Proxies, utilice el 'Generador Rápido de Proxies BifrostNetwork' para importar sus planes contratados directamente sin construir cadenas manualmente:

Campo Función
Seleccionar plan Carga automática de planes activos vinculados a su token
País / Región de destino Seleccione un país o mantenga Any Country para salida aleatoria
Modo de sesión Nueva IP por solicitud o sesión persistente (sticky)
ASN (opcional) Segmentar a un operador o red específica (ej.: AS7018)
Protocolo de proxy SOCKS5 (o HTTP/HTTPS)
Cantidad Número de proxies a generar en lote

Haga clic en 'Generar e importar en lote' para añadirlos inmediatamente a su lista de proxies.

API de Automatización

BifrostBrowser incluye una API HTTP local para control mediante scripts con Playwright, Puppeteer o clientes CDP:

  • Vinculada únicamente a 127.0.0.1 (sin acceso externo).
  • Autenticación mediante JWT Bearer Token (cabecera Authorization: Bearer <token>).
  • Puerto predeterminado: 40325 (indicado en la barra lateral).
GET/POST http://127.0.0.1:40325/...
Authorization: Bearer <token>

Opciones de configuración

Ajuste Función
Account Token Vincula la aplicación con su cuenta Bifrost para sincronización de planes
Default startup page Página inicial al abrir un perfil (por defecto: https://ip.sb)
Proxy geo checker Servicio IP-Geo utilizado por el botón Test
Screen resolution Resolución de la plantilla (recomendado) o resolución real de su pantalla
Automation API Habilitar/deshabilitar la API local, cambiar el puerto y gestionar el token

Resolución de problemas

Síntoma Causa y solución
Aviso 'La aplicación está dañada' en macOS Cuarentena de Gatekeeper en apps sin firmar; ejecute el comando xattr indicado.
No hay planes en el generador rápido Falta vincular el token de cuenta en Settings.
El perfil muestra su IP real al iniciar No se ha vinculado ningún proxy al perfil.
El script de automatización devuelve 401 El token Bearer es incorrecto o la API está deshabilitada.
No se puede conectar a la API de automatización Compruebe que el servicio de API esté activo y reinicie la app tras cambiar el puerto.
10

Próximos pasos