Proxy MITM HTTP/HTTPS/SOCKS5 haute performance en Rust avec interception TLS, réécriture de requêtes basée sur des règles, capture de trafic, points d'arrêt, bac à sable de scripts et rejeu de requêtes via une interface Web.

macOS / Linux / Git Bash :

Windows PowerShell :

Ce script installe toujours le CLI et installe automatiquement l'application de bureau de la même version sur macOS / Windows ; les plateformes comme Linux, pour lesquelles aucun paquet d'installation de bureau n'est encore fourni, restent en CLI uniquement. Si seul le CLI est nécessaire, utilisez --no-desktop (Bash / Git Bash) ou BIFROST_INSTALL_AUTO_DESKTOP=0 (Bash / PowerShell) pour ignorer le bureau. Le script installe ensuite également et fait confiance au certificat CA, installe tous les skills IA de Bifrost, et démarre Bifrost en tant que service en arrière-plan ; une fois l'installation terminée, vous pouvez accéder directement à l'interface d'administration. Les scripts d'installation Bash et PowerShell détectent automatiquement la connexion directe à GitHub et les miroirs intégrés, en privilégiant l'adresse de téléchargement de release la plus rapide disponible ; dans les réseaux restreints, vous pouvez également spécifier un miroir prioritaire via BIFROST_GITHUB_MIRROR. Le script Windows PowerShell ajoute le répertoire d'installation à la session courante et au Path utilisateur Windows ; le script Git Bash, sous Windows, écrit également dans le Path utilisateur Windows, de sorte qu'un nouveau PowerShell/CMD ouvert peut exécuter directement bifrost.

Installer une version spécifique

macOS / Linux / Git Bash :

Windows PowerShell :

Méthode 2 : installation via npm

Autres méthodes d'installation : docs/getting-started.md

Vérifier le proxy :

Accéder à l'interface d'administration après le démarrage :

Vérification de disponibilité des appareils

Avant de configurer le proxy sur un téléphone, une tablette ou un autre ordinateur, ouvrez en priorité Settings -> Certificate -> Availability Check dans l'interface Web. Après avoir sélectionné l'IP du réseau local de l'ordinateur actuel, générez un QR code ou un lien, puis accédez-y depuis l'appareil cible pour vérifier automatiquement trois choses :

• Si cet appareil est autorisé par le contrôle d'accès du proxy Bifrost.
• Si l'appareil peut accéder au port de sonde de Bifrost.
• Si le navigateur actuel fait déjà confiance au certificat HTTPS émis par la CA Bifrost.

Une fois la vérification réussie, la page affiche l'adresse proxy <IP réseau local>:<port> cliquable pour copie, et vous pouvez également ouvrir le QR code du proxy pour poursuivre la configuration. En cas d'échec, la page indique les étapes suivantes selon iOS/Android : installer la CA, sous iOS accéder à Réglages > Général > Informations sur l'appareil > Réglages de confiance des certificats pour activer la confiance totale, ou approuver l'accès proxy de cet appareil depuis l'interface d'administration.

Intégration avec l'IA

ASR Daily Agent prend en charge la division d'un rapport quotidien en plusieurs questions de recherche indépendantes, chacune créant une session distincte via ChatGPT Web. Le fan-out de recherche peut optionnellement configurer chatgpt_project_url ; une fois configuré, les nouvelles sessions sont archivées dans le ChatGPT Project spécifié, tout en imposant toujours le mode Chat et le modèle Pro :

Pour la composition complète de l'Agent, le manifeste de recherche et les limites d'échec, voir design/asr-daily-agent-pipeline.md.

Description des fonctionnalités

• Noyau proxy haute performance : basé sur Tokio + Hyper, prend en charge la haute concurrence et la réutilisation de connexions
• Prise en charge multi-protocoles : HTTP/1.1, HTTP/2, HTTP/3, HTTPS, SOCKS5, WebSocket, SSE, gRPC
• Capacité d'interception TLS : prend en charge la génération de certificats CA, l'émission dynamique de certificats par domaine, la sélection de l'interception/transmission selon les règles, et l'autorisation explicite des certificats non sécurisés pour une règle HTTPS amont individuelle
• Moteur de règles : prend en charge le routage, la réécriture requête/réponse, l'injection, la latence, la limitation de débit, le Mock, le traitement par script
• Interface d'administration : interface Web intégrée, prend en charge l'édition de règles, la visualisation du trafic, la gestion des scripts, le rejeu de requêtes
• Breakpoint : prend en charge la mise en pause, dans l'interface Web, des requêtes/réponses HTTP correspondant aux règles breakpoint://request / breakpoint://response, avec édition des headers/body puis reprise ; voir docs/breakpoint.md
• Alertes de risque de ressources : la page Performance et /_bifrost/api/system/memory affichent l'occupation des writers de fichiers body/ws et l'état d'alerte en cas d'approche de la limite de descripteurs
• Sandbox de scripts : basé sur QuickJS, prend en charge reqScript, resScript, decode

Initialisation du développement

Après avoir cloné le dépôt, exécutez une fois l'initialisation des hooks Git :

Cela écrit le core.hooksPath=.githooks local pour le dépôt courant ; même si un hooksPath global est configuré sur la machine, les git commit suivants exécuteront en priorité le .githooks/pre-commit du dépôt. Le pre-commit par défaut vérifie le format de l'espace de travail, le format Tauri du bureau, ainsi que cargo clippy --workspace --all-targets --all-features -- -D warnings.

Vous n'êtes pas à l'aise avec le CLI ? Vous souhaitez utiliser l'application de bureau ?

Le bureau convient à la capture quotidienne, à la visualisation du trafic, à l'édition de règles et à la mise à jour de Bifrost, sans avoir à mémoriser d'abord les commandes CLI :

1. Ouvrez GitHub Releases.
2. Sélectionnez les Assets de la dernière version.
3. Sous macOS, téléchargez le .dmg correspondant à votre puce : aarch64-apple-darwin pour Apple Silicon, x86_64-apple-darwin pour Intel Mac.
4. Sous Windows, téléchargez le .msi : x86_64-pc-windows-msvc pour un ordinateur x64 classique, aarch64-pc-windows-msvc pour un appareil ARM.
5. Sous macOS, ouvrez le .dmg puis glissez Bifrost.app dans Applications ; sous Windows, double-cliquez sur le .msi et suivez l'assistant d'installation.
6. Après avoir lancé Bifrost, attendez que le bureau termine le démarrage du backend proxy intégré ; au premier lancement, la CA Bifrost est vérifiée et installée de manière asynchrone.

Si vous souhaitez également installer les capacités en ligne de commande pour le bureau, ouvrez Settings dans le bureau et cliquez sur Install CLI & Skills dans Desktop Proxy Core. Pour un tutoriel détaillé, voir docs/desktop.md.

Résumé de l'utilisation de base

Commandes courantes :

Compléments sur les commandes de recherche :

• bifrost search est équivalent à bifrost traffic search
• traffic list et la recherche trient par défaut par ordre décroissant de l'heure de requête, puis par ordre décroissant du numéro en cas d'horodatage identique ; la correspondance la plus récente est prioritaire, --limit vaut 50 par défaut, et --max-results de la recherche remplace explicitement --limit
• Le filtrage de base prend en charge --method, --host, --path, --status, --protocol ; path est une sous-chaîne littérale, % et _ ne sont pas des caractères génériques
• --req-json/--res-json prend en charge la racine $, les chemins pointés, les indices de tableau et [*] ; les chemins invalides, les expressions de valeurs comme le temps ou les headers, et les noms d'include provoquent une erreur directe
• --latest 5m signifie les 5 dernières minutes, et non une seule entrée ; la sortie structurée sans mot-clé peut utiliser directement les conditions de filtrage, sans entrer dans la TUI
• traffic get --ids ID1,ID2 produit par défaut du NDJSON ; --format json-pretty explicite renvoie un {"results":[...]} formaté
• La portée de recherche prend en charge --url, --req-header, --res-header, --req-body, --res-body
• Alias compatibles : --headers recherche simultanément les en-têtes de requête et de réponse, --body recherche simultanément le corps de requête et de réponse

Exemples de règles :

Les valeurs en ligne sur une seule ligne de reqHeaders:// et resHeaders:// peuvent séparer plusieurs Headers par & ; si la valeur d'un Header contient elle-même un & littéral, utilisez un objet JSON ou l'écriture Values avec un Header par ligne.

Default est la règle globale par défaut créée automatiquement par Bifrost, toujours activée et placée en tête de liste. Elle ne peut pas être supprimée, désactivée, renommée ou synchronisée vers un dépôt distant, mais son contenu est modifiable ; elle convient aux configurations partagées par tous les ports, comme un DNS unifié, des headers génériques ou un repli TLS. Voir docs/rule.md.

Index de la documentation

• Vue d'ensemble de la documentation : docs/README.md
• Présentation du projet : docs/overview.md
• Installation et démarrage : docs/getting-started.md
• Commandes détaillées du CLI : docs/cli.md
• Installation et compilation de la version bureau : docs/desktop.md
• Syntaxe des règles : docs/rule.md
• Description des opérateurs : docs/operation.md
• Modes de correspondance : docs/pattern.md
• Manuel des protocoles de règles : docs/rules/README.md
• Module Scripts et développement de scripts : docs/scripts.md
• Guide d'utilisation des Values : docs/values.md
• Description du rejeu de requêtes : docs/replay.md
• Manuel d'utilisation de Breakpoint : docs/breakpoint.md
• Structure du projet et description des modules : docs/architecture.md
• Instructions d'installation d'Agent Skill : docs/agent-skill.md