Proxy MITM HTTP/HTTPS/SOCKS5 ad alte prestazioni in Rust con intercettazione TLS, riscrittura delle richieste basata su regole, cattura del traffico, breakpoint, sandbox di script e replay delle richieste tramite Web UI.

Windows PowerShell:

Lo script installa sempre la CLI e su macOS / Windows installa automaticamente l'App desktop della stessa versione; le piattaforme come Linux per cui non è ancora disponibile un pacchetto desktop restano CLI-only. Se serve solo la CLI, è possibile usare --no-desktop (Bash / Git Bash) o BIFROST_INSTALL_AUTO_DESKTOP=0 (Bash / PowerShell) per saltare la parte desktop. Lo script installa inoltre e considera attendibile il certificato CA, installa tutte le Bifrost AI skills e avvia Bifrost come servizio in background; al termine dell'installazione è possibile accedere direttamente al pannello di amministrazione. Gli script di installazione Bash e PowerShell rilevano automaticamente la connessione diretta a GitHub e i mirror integrati, usando con priorità l'indirizzo di download della release più veloce disponibile; in reti limitate è anche possibile specificare il mirror preferito tramite BIFROST_GITHUB_MIRROR. Lo script PowerShell di Windows aggiunge la directory di installazione alla sessione corrente e alla Path utente di Windows; lo script Git Bash su Windows scrive in modo sincronizzato anche nella Path utente di Windows, così una nuova finestra PowerShell/CMD può eseguire direttamente bifrost.

Installazione di una versione specifica

macOS / Linux / Git Bash:

Windows PowerShell:

Metodo 2: installazione tramite npm

Ulteriori metodi di installazione: docs/getting-started.md

Verifica del proxy:

Dopo l'avvio, accedi al pannello di amministrazione:

Verifica della disponibilità del dispositivo

Prima di configurare il proxy su un telefono, un tablet o un altro computer, apri preferibilmente Settings -> Certificate -> Availability Check nella Web UI. Seleziona l'IP della rete locale del computer corrente per generare un codice QR o un link; accedendovi dal dispositivo di destinazione verranno controllate automaticamente tre cose:

• Se il dispositivo è già autorizzato dal controllo di accesso del proxy Bifrost.
• Se il dispositivo può accedere alla porta di probe di Bifrost.
• Se il browser corrente considera già attendibile il certificato HTTPS emesso dalla CA di Bifrost.

Se la verifica ha esito positivo, la pagina mostrerà l'indirizzo proxy <IP rete locale>:<porta> cliccabile e copiabile, e sarà anche possibile aprire il codice QR del proxy per proseguire la configurazione. Se la verifica fallisce, la pagina indicherà i passi successivi in base a iOS/Android: installare la CA, su iOS accedere a Impostazioni > Generali > Info > Impostazioni attendibilità certificati e attivare la piena attendibilità, oppure approvare dal pannello di amministrazione l'accesso proxy di quel dispositivo.

Integrazione con l'AI

ASR Daily Agent supporta la suddivisione di un report giornaliero in più domande di ricerca indipendenti, ciascuna delle quali viene avviata come sessione separata da ChatGPT Web. Per il fan-out della ricerca è possibile configurare opzionalmente chatgpt_project_url; una volta configurato, le nuove sessioni verranno archiviate nel ChatGPT Project specificato, continuando comunque a usare in modo forzato la modalità Chat e il modello Pro:

Per la composizione completa degli Agent, il manifest di ricerca e i limiti di errore, vedi design/asr-daily-agent-pipeline.md.

Caratteristiche

• Kernel proxy ad alte prestazioni: basato su Tokio + Hyper, supporta alta concorrenza e riutilizzo delle connessioni
• Supporto multi-protocollo: HTTP/1.1, HTTP/2, HTTP/3, HTTPS, SOCKS5, WebSocket, SSE, gRPC
• Capacità di intercettazione TLS: supporta la generazione di certificati CA, l'emissione dinamica di certificati per dominio, la scelta di intercettazione/pass-through in base alle regole, e consente di abilitare esplicitamente certificati non sicuri per una singola regola HTTPS upstream
• Motore di regole: supporta routing, riscrittura di richieste/risposte, injection, ritardo, limitazione di velocità, Mock, elaborazione tramite script
• Interfaccia di gestione: Web UI integrata, supporta modifica delle regole, visualizzazione del traffico, gestione degli script, replay delle richieste
• Breakpoint: supporta la sospensione nella Web UI delle HTTP request/response che corrispondono alle regole breakpoint://request / breakpoint://response, con possibilità di modificare headers/body e proseguire; vedi docs/breakpoint.md
• Avvisi di rischio risorse: la pagina Performance e /_bifrost/api/system/memory mostrano l'occupazione dei writer dei file body/ws e lo stato di avviso in prossimità del limite di handle
• Sandbox per script: basata su QuickJS, supporta reqScript, resScript, decode

Inizializzazione dello sviluppo

Dopo aver clonato il repository, esegui una volta l'inizializzazione dei Git hook:

Questo scrive nel repository corrente la configurazione locale core.hooksPath=.githooks; anche se sulla macchina è configurato un hooksPath globale, i successivi git commit eseguiranno con priorità il .githooks/pre-commit interno al repository. Il pre-commit predefinito controlla il formato dell'area di lavoro, il formato Tauri del desktop e cargo clippy --workspace --all-targets --all-features -- -D warnings.

Non sei abituato alla CLI? Vuoi usare l'App desktop?

Il desktop è adatto all'acquisizione quotidiana dei pacchetti, alla visualizzazione del traffico, alla modifica delle regole e all'aggiornamento di Bifrost, senza dover prima memorizzare i comandi CLI:

1. Apri GitHub Releases.
2. Seleziona Assets della versione più recente.
3. Su macOS scarica il .dmg corrispondente al tuo chip: per Apple Silicon scegli aarch64-apple-darwin, per Intel Mac scegli x86_64-apple-darwin.
4. Su Windows scarica il .msi: per un normale computer x64 scegli x86_64-pc-windows-msvc, per un dispositivo ARM scegli aarch64-pc-windows-msvc.
5. Su macOS apri il .dmg e trascina Bifrost.app in Applications; su Windows fai doppio clic sul .msi e segui la procedura guidata.
6. Dopo aver avviato Bifrost, attendi che il desktop completi l'avvio del backend proxy integrato; al primo avvio verrà controllata e installata in modo asincrono la CA di Bifrost.

Se desideri che anche il desktop installi le capacità da riga di comando, apri Settings nel desktop e fai clic su Install CLI & Skills in Desktop Proxy Core. Per il tutorial dettagliato vedi docs/desktop.md.

Riepilogo dell'uso di base

Comandi comuni:

Note aggiuntive sui comandi di ricerca:

• bifrost search è equivalente a bifrost traffic search
• traffic list e la ricerca sono per impostazione predefinita in ordine decrescente per ora della richiesta, e a parità di timestamp in ordine decrescente per numero; le corrispondenze più recenti hanno priorità, --limit è 50 per impostazione predefinita, e --max-results della ricerca sovrascrive esplicitamente --limit
• Il filtro di base supporta --method, --host, --path, --status, --protocol; path è una sottostringa letterale, % e _ non sono considerati wildcard
• --req-json/--res-json supportano la radice $, i percorsi puntati, gli indici di array e [*]; percorsi non validi, espressioni di valore come tempo, header e nomi di include generano direttamente un errore
• --latest 5m indica gli ultimi 5 minuti, non prende un solo elemento; l'output strutturato senza parole chiave può usare direttamente le condizioni di filtro, senza entrare nella TUI
• traffic get --ids ID1,ID2 usa NDJSON per impostazione predefinita; con --format json-pretty esplicito restituisce il formato {"results":[...]}
• L'ambito di ricerca supporta --url, --req-header, --res-header, --req-body, --res-body
• Alias compatibili: --headers cerca contemporaneamente negli header di richiesta e risposta, --body cerca contemporaneamente nel body di richiesta e risposta

Esempi di regole:

I valori inline su singola riga di reqHeaders:// e resHeaders:// possono separare più Header con &; se il valore di un Header contiene letteralmente &, usa la scrittura con oggetto JSON o con blocco Values con un Header per riga.

Default è la regola globale predefinita creata automaticamente da Bifrost, sempre abilitata e in cima alla lista. Non può essere eliminata, disabilitata, rinominata o sincronizzata in remoto, ma il suo contenuto è modificabile; è adatta a contenere configurazioni condivise da tutte le porte, come DNS unificati, header comuni e fallback TLS. Vedi docs/rule.md.

Indice della documentazione

• Panoramica della documentazione: docs/README.md
• Panoramica del progetto: docs/overview.md
• Installazione e avvio: docs/getting-started.md
• Comandi dettagliati della CLI: docs/cli.md
• Installazione e build della versione desktop: docs/desktop.md
• Sintassi delle regole: docs/rule.md
• Descrizione degli operatori: docs/operation.md
• Modalità di corrispondenza: docs/pattern.md
• Manuale dei protocolli delle regole: docs/rules/README.md
• Modulo Scripts e sviluppo degli script: docs/scripts.md
• Istruzioni per l'uso di Values: docs/values.md
• Istruzioni per il replay delle richieste: docs/replay.md
• Manuale d'uso di Breakpoint: docs/breakpoint.md
• Struttura del progetto e descrizione dei moduli: docs/architecture.md
• Istruzioni per l'installazione di Agent Skill: docs/agent-skill.md