Digita almeno due lettere per cercare in ogni pagina della documentazione.

↑ ↓ per navigare ↵ per aprire esc per chiudere

Usare rdev

Collegare il laptop

Il tuo laptop è l'editor e il browser. Il codice, i servizi e gli agenti restano sul tuo server.

La tua tailnet

Il tuo laptop e il tuo server comunicano attraverso una rete privata Tailscale che appartiene al tuo account Tailscale. rdev non ne fa mai parte. Il programma di installazione collega il tuo server con una chiave del tuo account, e l'app per laptop collega il tuo laptop.

Sincronizzazione dei file

rdev mantiene sincronizzati i file dei tuoi progetti tra il tuo laptop e il tuo server, in entrambe le direzioni. Le cartelle che non hanno bisogno di viaggiare, come node_modules, vendor e l'output di build, sono ignorate fin dall'inizio.

Scegli cosa sincronizzare nel tuo pannello, in Dashboard > il tuo server > Impostazioni:

  • Sincronizza sui laptop: disattivalo per lavorare completamente da remoto. Nulla viene copiato sul laptop; il tuo editor apre i progetti via SSH (ssh rdev, Remote-SSH di VS Code o Cursor, PhpStorm Gateway). Siti e .dev.test continuano a funzionare.
  • Progetti sui laptop: deseleziona un progetto per tenerlo solo sul server. Una copia già presente sul tuo laptop viene lasciata dov'è, quindi eliminala quando non ti serve più. Quando un progetto torna a sincronizzarsi in seguito, la vecchia copia sul laptop viene prima spostata in ~/Code-rdev-old/ e scende la copia del server.
  • Mai sincronizzato: le esclusioni predefinite, ciascuna delle quali puoi disattivare, più i tuoi pattern in una sintassi simile a .gitignore.

I laptop applicano le nuove regole entro pochi minuti. Esegui rdev laptop sync per applicarle subito.

Editor e browser

Usa l'editor che già conosci, come VS Code o PhpStorm, sui file sincronizzati. Apri i tuoi siti nel tuo browser abituale su https://<name>.dev.test; l'app per laptop configura la risoluzione dei nomi e un certificato attendibile per questi indirizzi.

Condivisione dei file

Un terminale sul tuo server non può incollare un file, quindi rdev dà al tuo agente una cartella condivisa. Qualsiasi cosa in ~/rdev-share sul tuo laptop viene copiata in ~/Share/<laptop name> sul server in pochi secondi, anche quando la sincronizzazione dei file è disattivata; ogni laptop ha lì la propria cartella, quindi più laptop possono condividere contemporaneamente. Chiedi al tuo agente di "guardare l'ultimo screenshot" o di "aprire il file che ho appena inviato" e aprirà il più recente. Va bene qualsiasi tipo di file: immagini, PDF, log, esportazioni.

  • Invia appunti nell'app (anche nell'icona della barra dei menu o della tray) invia i file che hai copiato nel Finder, in Esplora file o nel tuo file manager, oppure l'immagine presente negli appunti. Attende che raggiungano il server e mette negli appunti i loro percorsi sul server; incollali nell'agente. In un terminale: rdev laptop share send, oppure rdev laptop share send <files>.
  • Trascina i file sulla finestra dell'app per inviarli allo stesso modo.
  • Nell'altra direzione: i file che il tuo agente mette in ~/Share/<laptop name>/out sul server arrivano in ~/rdev-share/from-server sul tuo laptop. Chiedigli di "mettere il report in out".
  • Salva qui gli screenshot di macOS fa sì che Maiusc-Comando-3, 4 e 5 salvino in ~/rdev-share (rdev laptop share macos). Anche app di screenshot come Shottr o CleanShot possono salvare lì.
  • I file vengono eliminati dopo 7 giorni su entrambi i lati; cambialo in Conserva i file per (giorni) nell'app o con rdev laptop share keep <days> (0 li conserva). I file in una cartella keep non vengono mai eliminati.
  • I file oltre 500 MB non vengono inviati; spostali con scp o rsync. Tutto va direttamente al tuo server e non passa mai da rdev.cloud. Disattiva la condivisione con l'interruttore nell'app o con rdev laptop share off.

Prima della 1.2.0 questa era la cartella degli screenshot: ~/rdev-shots viene spostata in ~/rdev-share e ~/Shots in ~/Share da sole, e ~/Shots continua a funzionare come link.

Laptop supportati

L'app per laptop e rdev laptop funzionano su macOS (Apple silicon e Intel), Linux (x64 e ARM64) e Windows 10 e 11 (x64 e ARM64); scarica l'app dalla pagina di download. Su Linux puoi installarla invece con un solo comando, che usa il .deb su Debian e Ubuntu, l'.rpm su Fedora e l'AppImage altrove, ad esempio su Arch e CachyOS: curl -fsSL https://rdev.cloud/install | sh -s -- app. L'AppImage va in ~/.local/bin e compare nel menu delle applicazioni; l'app mantiene quella voce puntata al file se lo sposti (1.4.4 o successiva). Se scarichi tu il .deb, installalo da /tmp (sudo apt install /tmp/rdev-linux-arm64.deb, oppure -x64); dalla tua cartella home apt funziona comunque, ma segnala che il suo utente sandbox non può leggere il file. Su Linux, rdev instrada *.dev.test al tuo server tramite systemd-resolved, che la maggior parte delle distribuzioni usa. Se è disattivato o mascherato, come in alcune immagini di macchine virtuali, rdev laptop connect lo segnala e mostra come attivarlo: sudo systemctl unmask systemd-resolved && sudo systemctl enable --now systemd-resolved, poi sudo ln -sf /run/systemd/resolve/stub-resolv.conf /etc/resolv.conf, e collegati di nuovo. Quando NetworkManager tiene un proprio /etc/resolv.conf accanto a un systemd-resolved in esecuzione (Tailscale segnala allora che sono "wired together incorrectly"), le richieste non raggiungono mai la route di rdev; rdev laptop connect e rdev laptop status lo segnalano (1.4.4 o successiva), e lo stesso comando ln -sf lo risolve. rdev aggiunge il proprio certificato ai certificati attendibili del sistema su Debian, Ubuntu, Fedora, openSUSE, Arch e CachyOS; prima della 1.4.4 la connessione si fermava lì su Arch e CachyOS.

Collegare passo dopo passo

  1. Installa Tailscale sul tuo laptop e accedi con lo stesso account Tailscale usato dal tuo server. Su Linux puoi saltarlo: se Tailscale manca, rdev laptop connect lo installa dal repository ufficiale di Tailscale e avvia l'accesso, che completi nel browser.
  2. Installa rdev sul tuo laptop e collegalo. Esegui questo in un terminale come utente normale e inserisci la password del laptop quando richiesta; serve per installare rdev, considerare attendibile il certificato e configurare la risoluzione dei nomi:
curl -fsSL https://rdev.cloud/install | sh -s -- laptop

Installa il comando rdev ed esegue rdev laptop connect, che trova il tuo server nella tua tailnet, aggiunge una voce rdev alla tua configurazione SSH, considera attendibile il certificato del tuo ambiente, instrada *.dev.test al tuo server e inizia a sincronizzare la tua cartella ~/Code con ~/Code sul server.

Non installi nient'altro prima. Se lo strumento di sincronizzazione manca, rdev installa una copia fissata e verificata con checksum in ~/.local/share/rdev/bin; uno che hai già viene usato così com'è. Su Linux installa anche gli strumenti per gli appunti usati per gli screenshot (wl-clipboard, xclip) e certutil, che mette il certificato in Chrome, con il tuo gestore di pacchetti, con la stessa richiesta di password. Se hai dato al server un altro nome durante l'installazione, aggiungi --server <name>; per sincronizzare un'altra cartella, aggiungi --code-dir <folder>. Esegui di nuovo rdev laptop connect ogni volta che vuoi rifare la configurazione.

Prima di chiedere la password, rdev laptop connect controlla la cartella che sta per sincronizzare. Si ferma e suggerisce --code-dir <cartella> se un'altra sessione di sincronizzazione sincronizza già quella cartella o una che la contiene (sincronizzarla anche con rdev copierebbe tutto tra tre macchine); eseguilo con --force o scegli Sincronizza comunque nell'app per sincronizzarla lo stesso. Anche una cartella oltre i 5 GB si collega, con una nota che la prima sincronizzazione richiede tempo (rdev 1.1.10 o successivo; prima si fermava).

Su un Mac che instrada già dev.test altrove, ad esempio a un altro server di sviluppo, rdev mette da parte quell'impostazione e la ripristina quando ti scolleghi o disinstalli.

Su Windows il comando curl qui sopra non si applica: installa l'app dalla pagina di download e connettiti da lì. Dall'app per laptop 1.4.2 in poi, l'app installa anche il comando rdev in %USERPROFILE%\.local\share\rdev\bin e aggiunge quella cartella al tuo PATH; apri un nuovo terminale per usarlo. Non richiede diritti di amministratore e si aggiorna con l'app.

Se l'app continua a mostrare Check connection mentre i file si sincronizzano e rdev laptop status dice *.dev.test resolves to …, not the server, guarda la pagina DNS della console di amministrazione di Tailscale. Una voce di split DNS per dev.test che punta a un'altra macchina, come un vecchio server, ha la precedenza su Windows sull'impostazione di rdev. Rimuovila oppure fai in modo che punti al tuo server.

Controlla la connessione in qualsiasi momento con rdev laptop status. rdev laptop disconnect ferma la sincronizzazione e rimuove le impostazioni; i tuoi file restano su entrambi i lati.

Rimuovere rdev dal tuo laptop

rdev laptop uninstall

Si scollega, smette di considerare attendibile il certificato del tuo ambiente e rimuove il comando rdev, le sue impostazioni e gli strumenti che ha installato. La tua cartella sincronizzata e ~/rdev-share restano. Anche lo strumento di sincronizzazione installato da rdev resta finché altre sessioni di sincronizzazione lo usano. Chiede la password del laptop una volta e richiede rdev 0.2.0-beta.21 o successivo.

Il tuo laptop deve poter accedere al server: il programma di installazione copia le chiavi SSH che potevano accedere al server quando hai installato. Per aggiungere un altro laptop, aggiungi la sua chiave pubblica nella pagina del tuo server nel pannello in Chiavi SSH (una per riga, quindi più computer in una volta; quando ne aggiungi una, puoi darle un nome come Laptop di lavoro, altrimenti viene mostrato il nome alla fine della chiave); il server la fa entrare in pochi secondi. Serve rdev 0.2.0-beta.33 o successivo; prima, metti la chiave in /opt/rdev/home/.ssh/authorized_keys sul server. Se rdev laptop connect dice di non riuscire ad accedere, è questo che manca.

Una volta collegato, apri un terminale sul server con ssh rdev e avvia lì il tuo agente; apri i tuoi siti nel browser su https://<folder>.dev.test. rdev open <progetto> apre un terminale sul server direttamente nella cartella di un progetto, nella tua sessione persistente; senza nome elenca i progetti (rdev 1.1.11 o successivo).

L'app per Mac

Preferisci cliccare a digitare? Scarica l'app rdev per Mac (Apple silicon e Intel, firmata e notarizzata da Apple), trascinala in Applicazioni e aprila. Mostra se il tuo laptop è collegato, si collega e scollega con un solo pulsante e apre un terminale sul tuo server. Esegue la stessa configurazione di rdev laptop connect, quindi ti serve Tailscale (passaggio 1) ma non il comando; l'app installa da sola lo strumento di sincronizzazione. Prima di collegare puoi cambiare la cartella in cui si sincronizzano i tuoi progetti (~/Code per impostazione predefinita), la versione dell'app di --code-dir.

Al primo avvio l'app ti guida passo passo e le sue schede si aprono solo quando ogni passaggio è riuscito: accedi con il tuo account rdev, verifica che Tailscale sia installato e connesso, scegli il server dal tuo account, fai entrare questo portatile (l'app aggiunge da sola la sua chiave SSH al server, creandone una se manca), scegli con Sfoglia… la cartella in cui si sincronizzano i progetti e connettiti. In seguito, Cambia server nella scheda Sites configura di nuovo il portatile per un altro server. Quando il suo server non c'è più, non è raggiungibile o non è più nel tuo account, l'app lo segnala e propone Configura di nuovo. In entrambi i casi i file restano dove sono. Quando il comando rdev è più vecchio dell'app, About mostra Esegui nel Terminale, che apre il terminale con il comando di aggiornamento.

L'app ha sette schede:

  • Siti: i tuoi progetti come link https://<name>.dev.test, un terminale sul server e i tuoi file condivisi. Ogni sito ha Open in Terminal, che apre un terminale nella cartella di quel progetto sul server. La scheda Sites ha anche i pulsanti Mail e Dumps che aprono le pagine delle email e dei dump catturati. C'è anche un pulsante Web terminal che apre il terminale web. C'è anche un pulsante Errors che apre il tracciamento degli errori.
  • Sincronizzazione: le stesse impostazioni del tuo pannello (sincronizzazione attiva o disattivata, progetti su questo laptop, esclusioni). Salvando, le applica subito su questo laptop.
  • Env: leggi e modifica il .env di un progetto sul server. L'app lavora sulla connessione SSH, quindi mostra i valori attuali, e questi non passano mai da rdev.cloud.
  • Gotify: se le tue notifiche vanno a un server Gotify, l'app lo ascolta e mostra ogni messaggio come notifica del desktop con un suono. Inserisci l'indirizzo del server e un token client (Gotify Clients); aggiungi un token applicazione (Gotify Apps) per inviare un messaggio di prova. I token restano su questo laptop.
  • Integrazioni: l'accesso Git del tuo server: la sua chiave, quanti account GitHub, GitLab, Bitbucket e di altro tipo vuoi (ciascuno con la propria chiave SSH o un token), gli host in attesa di essere considerati attendibili e una verifica dell'accesso. I token vanno al server via SSH, mai tramite rdev.cloud.
  • Impostazioni: l'app terminale che apre Terminale sul server (qualsiasi installata, come Terminal, iTerm2 o Warp; mantenuta finché non la cambi), l'icona della barra dei menu (monocromatica, che segue una barra dei menu chiara o scura, oppure l'icona colorata dell'app), la sincronizzazione degli screenshot e il tuo account: scegli Accedi con rdev.cloud, conferma la tua password nel browser, verifica che mostri lo stesso codice e approva. Le app collegate sono elencate, e possono essere scollegate, in Impostazioni > App collegate nel tuo pannello.
  • Informazioni: le versioni dell'app e del comando rdev, e l'ultima app su rdev.cloud.

Il terminale integrato

Terminal on the server apre il terminale integrato di rdev: una finestra a sé che puoi ridimensionare, ingrandire o portare a schermo intero, e che si riapre con l'ultima dimensione. Accede con ssh rdev e si unisce alla sessione persistente del tuo server, quindi chiudere la finestra o perdere la rete non ferma mai un agente; se la connessione cade, si ricollega da solo e torni dove eri rimasto.

  • Copia e incolla: Cmd-C e Cmd-V su macOS, Ctrl-Shift-C e Ctrl-Shift-V su Linux e Windows. Il testo copiato sul server, per esempio in vim, finisce negli appunti del tuo portatile. Con gli screenshot attivi, incollare un'immagine la invia al server e ne incolla il percorso, pronto per il tuo agente.
  • Shift-Invio inizia una nuova riga nel prompt di Claude Code.
  • Cerca con Cmd-F (Ctrl-Shift-F su Linux e Windows); cambia la dimensione del testo con Cmd e +, − o 0 (Ctrl su Linux e Windows).
  • I link si aprono nel browser, compresi i siti https://<nome>.dev.test. Quando la finestra è in secondo piano e il terminale suona il campanello, per esempio quando un agente ha bisogno di te, ricevi una notifica.
  • Open in an external terminal apre la stessa sessione in un'app di terminale: il pulsante accanto a Terminal on the server, il menu dell'icona nella barra dei menu o Cmd-Shift-O (Ctrl-Shift-O) nel terminale integrato. Per rendere predefinita un'app di terminale, sceglila in Settings. External terminal in Settings sceglie quale app usa; all'inizio è l'app di terminale scelta prima o, su Mac, Terminale.

L'app controlla la presenza di una versione più recente all'avvio, ogni sei ore e quando apri Informazioni. Quando c'è, una barra sopra le schede lo segnala: scegli Aggiorna, e l'app la scarica, ne verifica la firma, la installa e si riavvia (su Linux il .deb e l'.rpm chiedono la tua password; su Windows il programma di installazione parte da solo). L'aggiornamento nell'app richiede la 0.2.0-beta.34 o successiva; installa a mano una volta le versioni più vecchie. Il comando rdev sul portatile si aggiorna a parte: esegui di nuovo il comando di installazione, curl -fsSL https://rdev.cloud/install | sh -s -- laptop. Su Windows arriva con l'app e si aggiorna con essa. Quando il comando è più vecchio dell'app, About mostra quel comando con un pulsante per copiarlo.

Chiudere la finestra mantiene rdev nella barra dei menu e lo toglie dal Dock e da Cmd-Tab; Esci nel menu dell'icona della barra dei menu, o Cmd-Q, lo chiude.

In Settings (app per laptop 1.4.3 o successiva), Open at login avvia rdev in background quando accedi, direttamente nella barra dei menu o nell'area di notifica, e Keep running when the window is closed (attiva per impostazione predefinita) decide se chiudere la finestra lo mantiene lì o lo chiude. Quando è attiva, la sincronizzazione dei file e le notifiche continuano a funzionare a finestra chiusa. GNOME mostra le icone della barra di sistema solo con l'estensione AppIndicator (Ubuntu ce l'ha); senza di essa, una finestra chiusa non lascia alcuna icona su cui cliccare, quindi riapri rdev dal menu delle applicazioni. L'app avvisa di questo in Settings (app per laptop 1.4.4 o successiva). L'apertura all'accesso non richiede diritti di amministratore: rdev aggiunge un elemento di login solo per il tuo utente (un launch agent su macOS, una voce di autostart su Linux, una voce Run nel registro del tuo utente su Windows).

L'app applica inoltre le regole di sincronizzazione del pannello ogni cinque minuti mentre è in esecuzione.

Firefox mantiene un proprio elenco di certificati. Su Linux, rdev aggiunge il suo certificato a Chrome e a ogni profilo Firefox che trova, compreso il Firefox snap fornito da Ubuntu e quello Flatpak (rdev 0.2.0-beta.34 o successivo); riavvia poi Firefox. Per un profilo Firefox creato in seguito, o su macOS e Windows, importa ~/.config/rdev/ca.pem in Impostazioni > Privacy e sicurezza > Certificati.