r2web

Caratteristiche

• Basato su browser: Nessuna installazione locale richiesta
• Cross-platform: Funziona su qualsiasi dispositivo con un browser moderno (poiché i browser più vecchi non supportano WASI/WASM)
• Interfaccia terminale: Interagisci con r2 tramite un terminale familiare.
• Scorciatoie da tastiera: Naviga rapidamente usando alcune scorciatoie GUI note (come Ctrl+G per seek).
• Ricerca: Possibilità di cercare in output di comandi di grandi dimensioni.
• Versioni personalizzate di r2: Usa qualsiasi versione di r2 desideri.
• Pulsanti rapidi: Pulsanti per comandi comuni come pd, px, iz.

Come funziona

r2web utilizza:

• React+TypeScript+Vite
• xterm.js per l'interfaccia del terminale
• Wasmer per eseguire WASM
• r2wasm per la build WASM di radare2

Sviluppo

Per eseguire localmente:

dovrai eseguire un server API proxy molto piccolo per aggirare la politica CORS del browser, per farlo esegui:

che eseguirà un server proxy locale su http://localhost:3000/wasm, che verrà utilizzato per recuperare il file wasm dalle release di GitHub.

Oppure puoi eseguire sia il server di sviluppo che il proxy contemporaneamente usando:

Per compilare per la produzione:

Per impostazione predefinita, la build presuppone che la tua app sia servita dal percorso root (/). Se distribuisci in una sottodirectory (es. example.com/online), imposta la variabile d'ambiente VITE_BASE_URL:

[!NOTE] Il server proxy è richiesto solo per supportare più versioni (più vecchie) di radare2. Se ti interessa solo l'ultima versione, puoi saltare il server proxy.

Oppure salta la configurazione e provalo dal vivo.

[!TIP]

1. Se non hai bun installato, puoi usare npm o yarn o qualsiasi altro gestore di pacchetti che hai installato. Sostituisci semplicemente bun con npm o yarn (o qualsiasi altro gestore di pacchetti) nei comandi precedenti.

2. Quando apri i file compilati direttamente dal tuo file system (usando il protocollo file://), potresti riscontrare errori CORS. È consigliato l'hosting statico con un server HTTP appropriato (come GitHub Pages, Netlify, Vercel, ecc.) o avviare un server locale.

FAQ

D: Perché non riesco a salvare i file?

La funzionalità di salvataggio è supportata a partire dalla versione 6.0.3 di r2. Le versioni precedenti avevano una limitazione sul lato r2-wasm che è stata risolta.

D: Perché la vista Grafico non si carica?

La vista Grafico richiede r2 versione 6.0.9 o superiore per funzionare correttamente.

D: Quali browser sono supportati?

Sebbene miriamo a un'ampia compatibilità, ci sono attualmente problemi noti con Firefox. Per l'esperienza più stabile, consigliamo di utilizzare browser basati su Chromium (come Chrome, Edge o Brave).

D: Come viene gestito il binario di radare2?

Il binario viene scaricato automaticamente al primo caricamento e memorizzato nella cache locale per uso futuro. Se preferisci non conservarlo, all'avvio durante la selezione della versione è disponibile un'opzione per disabilitare la cache.

Contribuire

I contributi sono i benvenuti! Apri un issue o invia una pull request. Per mantenere il progetto allineato ai suoi obiettivi principali, tieni a mente le seguenti linee guida:

• Evita boilerplate UI: Questo progetto è costruito sulla filosofia dell'auto-integrazione. Evita di aggiungere librerie UI esterne (es. Tailwind CSS, shadcn/ui) o boilerplate pesanti.
• Riduci al minimo le dipendenze: Miriamo a mantenere il codebase leggero. Quando possibile, cerca di implementare logica e stile utilizzando strumenti nativi piuttosto che aggiungere nuovi pacchetti.

Licenza

Questo progetto è concesso in licenza MIT. Consulta il file LICENSE per i dettagli.

• La licenza di radare2 si trova qui.

Progetti simili

• r2wasm - Progetto dimostrativo ufficiale di r2wasm
• radare2 online - Versione online di radare2 [attualmente non funzionante]