Il server
dentro l'editor.The server
inside the editor.

Perché l'ho scrittoWhy I wrote it

Da anni sposto file su server remoti mentre sviluppo, e da anni la stessa scena: apri il file con un client FTP, lo modifichi in un editor diverso da quello che stai usando per il progetto, salvi, ricarichi. Oppure installi una delle estensioni per VS Code che fanno la stessa cosa, e scopri che la password del server di produzione è finita in chiaro dentro un file JSON nella cartella del progetto, a un «git add .» di distanza dal repository.

For years I've been moving files onto remote servers while developing, and for years it's been the same scene: you open the file with an FTP client, edit it in an editor that isn't the one you're using for the project, save, reload. Or you install one of the VS Code extensions that do the same thing, and discover that your production password ended up in clear text inside a JSON file in the project folder, one "git add ." away from the repository.

Ho scritto Remote SFTP/FTP per togliermi questo problema, e visto che funziona lo metto a disposizione gratuitamente.

I wrote Remote SFTP/FTP to get that problem off my desk, and since it works, I'm giving it away for free.

Il server diventa parte dell'editorThe server becomes part of the editor

L'idea è semplice. Configuri la connessione una volta, SFTP su SSH oppure FTP e FTPS, e nella barra laterale compare l'albero delle cartelle remote. Clicchi un file, si apre. Lo modifichi, premi Salva, e il file viene riscritto sul server. Non c'è nessuna copia locale che dopo due giorni non sai più se è più aggiornata di quella remota, e non c'è nessuna sincronizzazione da lanciare e da ricordarsi. Una cartella remota può anche diventare la radice del workspace, e a quel punto ci lavori esattamente come su un progetto sul tuo disco.

The idea is simple. You configure the connection once, SFTP over SSH or FTP and FTPS, and the remote folder tree appears in the sidebar. You click a file, it opens. You edit it, hit Save, and the file is written back to the server. There's no local copy that two days later you can't tell is newer or older than the remote one, and there's no sync job to launch and remember. A remote folder can even become the workspace root, and from there you work on it exactly like a project on your own disk.

Terminale, ricerca, trascinamentoTerminal, search, drag and drop

Sulle connessioni SSH c'è anche il terminale remoto, e qui c'è un dettaglio a cui tengo: la shell si apre sulla stessa connessione già aperta per i file. Nessun secondo login, nessuna seconda password. Se lanci il comando da una cartella dell'albero, la shell parte già lì dentro.

On SSH connections there's also the remote terminal, and here's a detail I care about: the shell opens on the same connection already used for the files. No second login, no second password. If you launch the command from a folder in the tree, the shell starts right there.

La funzione che uso di più, però, è la ricerca. Cercare una stringa dentro un progetto su un server remoto è di solito una scocciatura: o scarichi tutto, o entri in SSH e ti arrangi con grep. Qui scegli da quale cartella partire e cosa cercare, e se l'account SSH ha una shell la ricerca viene eseguita direttamente sul server con grep e find. In rete passa solo l'elenco dei risultati, non i file. Clicchi un risultato e il file si apre alla riga giusta. Sulle connessioni FTP, dove una shell non esiste, l'estensione scandaglia le cartelle dal client: più lenta, ma funziona.

The feature I use most, though, is search. Looking for a string inside a project on a remote server is usually a chore: either you download everything, or you log in over SSH and make do with grep. Here you pick which folder to start from and what to look for, and if the SSH account has a shell the search runs directly on the server with grep and find. Only the list of results crosses the network, not the files. You click a result and the file opens at the right line. On FTP connections, where no shell exists, the extension scans the folders from the client: slower, but it works.

Sotto l'albero delle connessioni c'è anche una struttura del file aperto: classi, funzioni e metodi, con un clic per saltarci dentro. Funziona anche sui file remoti il cui linguaggio non ha un language server attivo, grazie a una lettura testuale di riserva.

Below the connections tree there's also an outline of the open file: classes, functions and methods, one click to jump into them. It works on remote files whose language has no active language server too, thanks to a fallback textual scan.

C'è poi tutta la parte di trascinamento. File e cartelle dal gestore file del sistema verso una cartella remota per caricarli, elementi dentro l'albero remoto per spostarli sul server senza far transitare i dati dal tuo computer, e persino fra due connessioni diverse per copiare da un server a un altro: in quel caso i dati passano da un flusso all'altro senza toccare né il disco né la memoria, quindi un file da qualche centinaio di megabyte non è un problema.

Then there's the whole drag and drop side. Files and folders from your system file manager onto a remote folder to upload them, items inside the remote tree to move them on the server without the data travelling through your computer, and even between two different connections to copy from one server to another: in that case the data goes from one stream into the other without touching disk or memory, so a few-hundred-megabyte file is not a problem.

Se usi già altri strumentiIf you already use other tools

Non devi riconfigurare niente a mano: c'è un comando che legge le connessioni dal tuo ~/.ssh/config, dai file sftp.json dei progetti e da un'altra estensione diffusa, ti mostra cosa ha trovato e importa quelle che scegli, unendo i doppioni. Le password e le passphrase che trova finiscono nel portachiavi, non nella configurazione.

You don't have to reconfigure anything by hand: there's a command that reads connections from your ~/.ssh/config, from the projects' sftp.json files and from another widespread extension, shows you what it found and imports the ones you pick, merging duplicates. Passwords and passphrases it finds go into the keychain, not into the configuration.

Sono supportati anche i server raggiungibili solo attraverso un bastione, e se la connessione cade l'operazione in corso viene ripresa da sola: un salvataggio o un trasferimento sopravvivono a un buco di rete senza finestre d'errore.

Servers reachable only through a bastion are supported too, and if the connection drops the operation in flight is retried on its own: a save or a transfer survives a network blip with no error dialogs.

Le tre cose di cui vado più fieroThe three things I'm proudest of

Non si vedono, ed è per quelle che l'ho scritto.You can't see them, and they're the reason I wrote it.

Qualche limite, detto subitoA few limits, said up front

• È provata su macOS e Linux; su Windows no.
• It's tested on macOS and Linux; not on Windows.
• I file oltre 16 megabyte non si aprono nell'editor: è un vincolo di VS Code, che riceve i file remoti in un blocco unico. Per quelli conviene usare il download.
• Files over 16 megabytes don't open in the editor: that's a VS Code constraint, it receives remote files as a single block. For those, use the download instead.
• Il terminale SSH aperto non sopravvive a una caduta di connessione e va riaperto.
• An open SSH terminal does not survive a dropped connection and has to be reopened.
• La ricerca nel contenuto su FTP, come dicevo, è più lenta.
• Content search over FTP, as I said, is slower.

Come si installaHow to install

Su macOS e Linux la procedura è la stessa, perché non è un'applicazione del sistema operativo: vive dentro VS Code. Non c'è nessun installer da scaricare, e non serve altro software. Cambia solo il tasto: Cmd sul Mac, Ctrl su Linux. On macOS and Linux the procedure is the same, because this isn't an operating system application: it lives inside VS Code. There's no installer to download, and no other software needed. Only the key changes: Cmd on the Mac, Ctrl on Linux.

LicenzaLicence

Gratuita per qualunque uso, anche commerciale e in azienda, senza registrazione e senza limiti di tempo o di postazioni. Non è open source. L'unica cosa che chiedo è di non ridistribuire il file altrove: linkate questa pagina, così chi la installa ha sempre la versione corrente.

Free for any use, commercial and inside companies included, with no registration and no limits on time or seats. It is not open source. The only thing I ask is that you don't redistribute the file elsewhere: link this page, so whoever installs it always gets the current version.

Se la provate e trovate qualcosa che non va, scrivetemi.

If you try it and something doesn't work, write to me.