Proxy MITM HTTP/HTTPS/SOCKS5 de alto rendimiento en Rust con interceptación TLS, reescritura de solicitudes basada en reglas, captura de tráfico, puntos de interrupción, sandbox de scripts y repetición de solicitudes mediante interfaz web.

Windows PowerShell:

Este script siempre instala el CLI y, en macOS / Windows, instala automáticamente la App de escritorio de la misma versión; en plataformas como Linux, donde aún no se ofrece paquete de instalación de escritorio, permanece solo como CLI. Si solo necesitas el CLI, puedes usar --no-desktop (Bash / Git Bash) o BIFROST_INSTALL_AUTO_DESKTOP=0 (Bash / PowerShell) para omitir el escritorio. Después, el script también instala y confía en el certificado CA, instala todas las skills de Bifrost AI y arranca Bifrost como servicio en segundo plano; una vez completada la instalación, puedes acceder directamente al panel de administración. Los scripts de instalación de Bash y PowerShell detectan automáticamente la conexión directa a GitHub y las fuentes espejo integradas, priorizando la dirección de descarga de release más rápida disponible; en redes restringidas también puedes especificar el espejo prioritario mediante BIFROST_GITHUB_MIRROR. El script de Windows PowerShell añade el directorio de instalación a la sesión actual y al Path del usuario de Windows; el script de Git Bash también escribe en el Path del usuario de Windows en Windows, de modo que un PowerShell/CMD recién abierto puede ejecutar bifrost directamente.

Instalar una versión específica

macOS / Linux / Git Bash:

Windows PowerShell:

Método 2: instalación mediante npm

Más métodos de instalación: docs/getting-started.md

Comprobar el proxy:

Accede al panel de administración tras el arranque:

Comprobación de disponibilidad del dispositivo

Antes de configurar el proxy en un móvil, tablet u otro ordenador, abre preferentemente Settings -> Certificate -> Availability Check en la Web UI. Tras seleccionar la IP de red local del ordenador actual, genera un código QR o un enlace; al acceder desde el dispositivo de destino se comprueban automáticamente tres cosas:

• Si el dispositivo está permitido por el control de acceso del proxy de Bifrost.
• Si el dispositivo puede acceder al puerto de sondeo de Bifrost.
• Si el navegador actual ya confía en el certificado HTTPS emitido por la CA de Bifrost.

Si la comprobación pasa, la página muestra la dirección de proxy <IP de red local>:<puerto> que se puede copiar con un clic, y también puedes abrir el código QR del proxy para continuar la configuración. Si la comprobación falla, la página indica los siguientes pasos según iOS/Android: instalar la CA, en iOS entrar en Ajustes > General > Información > Ajustes de confianza de certificados y activar la confianza total, o aprobar el acceso proxy de ese dispositivo desde el panel de administración.

Integración con IA

ASR Daily Agent permite dividir un informe diario en múltiples preguntas de investigación independientes y crear sesiones por separado mediante ChatGPT Web. El fan-out de investigación admite la configuración opcional chatgpt_project_url; una vez configurada, las nuevas sesiones se archivan en el ChatGPT Project especificado, a la vez que se sigue forzando el uso del modo Chat y el modelo Pro:

Para ver la combinación completa de Agent, el manifest de investigación y los límites de fallo, consulta design/asr-daily-agent-pipeline.md.

Características

• Núcleo proxy de alto rendimiento: basado en Tokio + Hyper, admite alta concurrencia y reutilización de conexiones
• Compatibilidad multiprotocolo: HTTP/1.1, HTTP/2, HTTP/3, HTTPS, SOCKS5, WebSocket, SSE, gRPC
• Capacidad de interceptación TLS: admite generación de certificados CA, emisión dinámica de certificados por dominio, selección de interceptación/reenvío según reglas, y permite explícitamente certificados inseguros para una regla HTTPS de upstream individual
• Motor de reglas: admite enrutamiento, reescritura de solicitud/respuesta, inyección, retardo, limitación de velocidad, Mock y procesamiento mediante scripts
• Interfaz de administración: Web UI integrada, admite edición de reglas, visualización de tráfico, gestión de scripts y repetición de solicitudes
• Breakpoint: permite pausar en la Web UI las solicitudes/respuestas HTTP que coincidan con las reglas breakpoint://request / breakpoint://response, editar headers/body y continuar; consulta docs/breakpoint.md
• Alertas de riesgo de recursos: la página Performance y /_bifrost/api/system/memory muestran el uso de los writer de archivos body/ws y el estado de alerta al acercarse al límite de descriptores
• Sandbox de scripts: basado en QuickJS, admite reqScript, resScript, decode

Inicialización de desarrollo

Tras clonar el repositorio, ejecuta una vez la inicialización de los Git hooks:

Esto escribe en el repositorio actual el core.hooksPath=.githooks local; incluso si la máquina tiene configurado un hooksPath global, los git commit posteriores ejecutarán con prioridad el .githooks/pre-commit del repositorio. El pre-commit predeterminado comprueba el formato del área de trabajo, el formato de Tauri del escritorio y cargo clippy --workspace --all-targets --all-features -- -D warnings.

¿No te acostumbras al CLI? ¿Quieres usar la App de escritorio?

El escritorio es adecuado para la captura diaria de paquetes, la visualización de tráfico, la edición de reglas y la actualización de Bifrost, sin necesidad de memorizar primero los comandos del CLI:

1. Abre GitHub Releases.
2. Selecciona Assets de la última versión.
3. En macOS descarga el .dmg que coincida con tu chip: para Apple Silicon elige aarch64-apple-darwin, para Intel Mac elige x86_64-apple-darwin.
4. En Windows descarga el .msi: para un ordenador x64 normal elige x86_64-pc-windows-msvc, para dispositivos ARM elige aarch64-pc-windows-msvc.
5. En macOS abre el .dmg y arrastra Bifrost.app a Applications; en Windows haz doble clic en el .msi y sigue el asistente de instalación.
6. Tras iniciar Bifrost, espera a que el escritorio complete el arranque del backend proxy integrado; en el primer inicio se comprobará e instalará de forma asíncrona la CA de Bifrost.

Si quieres que el escritorio también instale las capacidades de línea de comandos, abre Settings en el escritorio y haz clic en Install CLI & Skills dentro de Desktop Proxy Core. Para el tutorial detallado, consulta docs/desktop.md.

Resumen de uso básico

Comandos habituales:

Notas adicionales sobre los comandos de búsqueda:

• bifrost search es equivalente a bifrost traffic search
• traffic list y la búsqueda se ordenan por defecto por hora de solicitud descendente, y con la misma marca de tiempo por número de secuencia descendente; las coincidencias más recientes tienen prioridad, --limit es 50 por defecto, y el --max-results de la búsqueda sobrescribe explícitamente --limit
• El filtrado básico admite --method, --host, --path, --status, --protocol; path es una subcadena literal, % y _ no actúan como comodines
• --req-json/--res-json admiten la raíz $, rutas con puntos, índices de array y [*]; las rutas no válidas, las expresiones de valor como tiempo o header y los nombres de include provocan error directamente
• --latest 5m significa los últimos 5 minutos, no tomar solo un registro; la salida estructurada sin palabra clave puede usar directamente las condiciones de filtrado, sin entrar en la TUI
• traffic get --ids ID1,ID2 usa NDJSON por defecto; --format json-pretty explícito devuelve el {"results":[...]} formateado
• El ámbito de búsqueda admite --url, --req-header, --res-header, --req-body, --res-body
• Alias compatibles: --headers busca a la vez en las cabeceras de solicitud y de respuesta, --body busca a la vez en el cuerpo de solicitud y de respuesta

Ejemplos de reglas:

En el valor en línea de una sola línea de reqHeaders:// y resHeaders:// se pueden separar varios Header con &; si el valor del Header contiene literalmente &, usa un objeto JSON o la forma de bloque Values con un Header por línea.

Default es la regla global predeterminada que Bifrost crea automáticamente, siempre está activada y aparece fijada al principio de la lista. No se puede eliminar, desactivar, renombrar ni sincronizar con el remoto, pero su contenido sí se puede editar; es adecuada para colocar configuraciones compartidas por todos los puertos, como DNS unificado, headers genéricos o respaldo TLS. Consulta docs/rule.md.

Índice de documentación

• Visión general de la documentación: docs/README.md
• Visión general del proyecto: docs/overview.md
• Instalación y arranque: docs/getting-started.md
• Comandos detallados del CLI: docs/cli.md
• Instalación y compilación de la versión de escritorio: docs/desktop.md
• Sintaxis de reglas: docs/rule.md
• Descripción de operadores: docs/operation.md
• Patrones de coincidencia: docs/pattern.md
• Manual de protocolos de reglas: docs/rules/README.md
• Módulo Scripts y desarrollo de scripts: docs/scripts.md
• Instrucciones de uso de Values: docs/values.md
• Instrucciones de repetición de solicitudes: docs/replay.md
• Manual de uso de Breakpoint: docs/breakpoint.md
• Estructura del proyecto y descripción de módulos: docs/architecture.md
• Instrucciones de instalación de Agent Skill: docs/agent-skill.md