Accesso SFTP al gameserver – gestire i file

SFTP è il modo pratico per gestire i file del tuo gameserver fuori dal pannello: modificare configurazioni, caricare plugin o mod, salvare i log e scaricare mondi. Ti servono solo un client adatto, i dati di accesso dal dashboard e un po' di attenzione quando sovrascrivi file importanti.

Cosa fa SFTP per il gameserver

SFTP sta per SSH File Transfer Protocol e trasferisce i file tramite una connessione cifrata. Per i gameserver è particolarmente utile perché non devi fare ogni modifica tramite un file manager nel browser. Cartelle grandi, molti file di plugin o backup locali di solito si gestiscono in modo più chiaro con un client desktop.

È importante distinguere bene: SFTP non è la stessa cosa del classico FTP. Se il tuo client offre più protocolli, scegli esplicitamente SFTP. FileZilla indica SFTP nella documentazione ufficiale come protocollo supportato; WinSCP si descrive ufficialmente come client per trasferimenti di file, anche tramite SFTP. Usa quindi i download ufficiali ed evita installer non ufficiali da siti di terze parti.

Requisiti

Ti servono un gameserver attivo, accesso al tuo dashboard game-serverhosting e un client SFTP sul tuo computer. Inoltre, prima di modifiche rischiose, dovresti creare un backup o almeno scaricare localmente i file interessati. Questo vale soprattutto per mondi, database, configurazioni del server e cartelle dei plugin.

Se stai arrivando da un altro provider, la guida Trasferire un gameserver: da qualsiasi hoster a game-serverhosting ti aiuta con l'ordine corretto di backup, upload e verifica. Per le estensioni specifiche di Minecraft, la guida Installare e gestire plugin Minecraft – Spigot/Paper nel pannello integra i passaggi SFTP con dettagli sui plugin.

Installare un client SFTP

Su Windows, WinSCP è spesso comodo perché interfaccia, integrazione con l'editor e sincronizzazione sono separati in modo chiaro. FileZilla è multipiattaforma e funziona bene se vuoi lavorare in modo simile su Windows, macOS o Linux. Anche Cyberduck è un'opzione se preferisci un'interfaccia semplice.

Stabilire la connessione

Apri il tuo client SFTP e crea una nuova connessione. Trovi i valori nel dashboard del tuo server. Non inviarli a terzi tramite screenshot e salva le password solo su dispositivi di cui ti fidi.

Poi clicca su Connetti. Alla prima connessione, il client potrebbe chiederti una chiave host. Controlla di collegarti all'host corretto e conferma la chiave solo se i dati del server sono giusti. Dopo di solito il client mostra due aree: a sinistra i tuoi file locali, a destra i file sul gameserver.

Struttura tipica delle cartelle

La struttura esatta dipende dal gioco e dal tipo di server usato. Molte configurazioni però seguono una directory container come questa:

/home/container/
├── server.properties     # Config del server
├── plugins/              # Plugin (Paper/Spigot)
├── mods/                 # Mod (Forge/Fabric)
├── world/                # Mondo di gioco
├── logs/                 # Log del server
└── backups/              # Backup

Modifica i file nel modo più mirato possibile. Scarica prima un file di configurazione, modificalo localmente in un editor adatto e poi ricaricalo. Fai attenzione a non cambiare le estensioni dei file. Per esempio, server.properties non deve diventare per sbaglio server.properties.txt.

Attività frequenti

• Modificare una config: scaricare il file → modificarlo → caricarlo
• Installare plugin: caricare il JAR in /plugins/
• Scaricare backup: scaricare la cartella /world/
• Controllare i log: scaricare latest.log

Per plugin o mod dovresti controllare versione del server, loader e dipendenze prima di caricare i file. Un plugin Paper di solito va in /plugins/, una mod Forge o Fabric in /mods/. Dopo l'upload di solito serve un riavvio, così il server carica il nuovo file.

Per i backup dei mondi è consigliabile una procedura chiara: ferma il server, scarica la cartella del mondo, assegna un nome sensato alla copia locale e solo dopo esegui modifiche più grandi. Se il server sta scrivendo durante la copia, un backup può risultare incompleto o incoerente.

Verificare il risultato

Dopo una modifica, controlla prima che l'upload sia stato completato del tutto. Molti client SFTP mostrano trasferimenti non riusciti in una coda o in una scheda errori. Poi, se necessario, riavvia il gameserver e controlla i log. In Minecraft latest.log è spesso il primo punto da guardare; in altri giochi ci sono file di log specifici nella rispettiva directory del server.

Poi testa nel gioco o nel pannello se la modifica è davvero attiva. Un file caricato da solo non significa ancora che sia stato letto dal server. Conta che l'avvio proceda senza errori e che la funzione desiderata sia visibile.

Consigli per lavorare pulito

• Drag & Drop: trasferire file facilmente con drag & drop
• Doppio clic: aprire i file direttamente nell'editor
• Sincronizzare: alcuni client offrono la sincronizzazione delle cartelle
• Auth con chiave: chiavi SSH invece della password per più sicurezza

Lavora comunque in modo controllato: la sincronizzazione può trasferire rapidamente errori locali sul server. Se sostituisci molti file, controlla prima la cartella di destinazione e la direzione della sincronizzazione. Per i file di configurazione, una copia locale prima di ogni modifica è utile.

Troubleshooting

Se la connessione fallisce, controlla prima protocollo, host, porta, nome utente e password. Un errore frequente è scegliere per sbaglio FTP invece di SFTP o inserire la porta sbagliata. La porta standard usata in molte configurazioni Pterodactyl è 2022; decisivi però sono sempre i valori del tuo dashboard.

Se l'upload si interrompe, la connessione locale potrebbe essere instabile o la cartella di destinazione potrebbe mancare. Ripeti il trasferimento e controlla se il client ha caricato un file solo in parte. Nel dubbio elimina il file di destinazione incompleto e ricaricalo.

Se il server non si avvia dopo una modifica, rimetti il file dell'ultima versione funzionante oppure rimuovi il plugin o la mod caricati per ultimi. Poi controlla i log. Per il lavoro di base da terminale sui file del server, ti aiuta anche la guida Comandi Linux per gameserver – I comandi terminale più importanti.

Verifica, limiti e ritorno sicuro

La guida “Accesso SFTP al gameserver – gestire i file” vale per il tipo di server descritto nell'articolo e per lo stato delle versioni visibile al momento della verifica. Nomi dei menu, versioni disponibili, compatibilità di mod o plugin e risorse richieste possono cambiare dopo gli aggiornamenti. Quindi non trasferire valori senza controllarli su un'altra versione di gioco, loader o server.

Prima di modificare mondo, salvataggio, configurazione o estensioni, crea un backup dei file interessati. Poi cambia solo un passaggio coerente alla volta e verificalo con la stessa versione di client e server con cui vuoi giocare più tardi.

Un singolo test riuscito non è una garanzia di prestazioni o disponibilità. Dimensione del mondo, mod, plugin, numero di giocatori, percorso di rete e carico simultaneo possono cambiare il risultato. Documenta versione, modifica e risultato del test, così potrai capire eventuali differenze successive.

FAQ

SFTP è più sicuro di FTP?

Sì, SFTP trasferisce i file tramite una connessione cifrata. Resta comunque importante proteggere i dati di accesso, usare solo client affidabili e non salvare password su dispositivi condivisi.

Quale client SFTP dovrei usare?

Scegli il client con cui riesci a lavorare in modo affidabile. FileZilla è multipiattaforma, WinSCP è molto popolare su Windows, Cyberduck funziona su macOS e Windows. Scarica il client direttamente dal sito ufficiale.

Devo fermare il gameserver prima di ogni upload?

Non per ogni file. Per log o semplici download di solito non è necessario. Per cartelle dei mondi, database, mod, plugin o configurazioni centrali, uno stop o un riavvio può avere senso a seconda della modifica, così nessun file viene scritto nello stesso momento.

Perché non vedo nel gioco la modifica che ho caricato?

Possibili motivi sono un riavvio mancante, una cartella di destinazione sbagliata, una versione di plugin o mod incompatibile oppure un errore nella configurazione. Controlla prima l'upload, poi i log del server e infine il percorso esatto.

Posso scaricare backup completi via SFTP?

Sì, puoi scaricare cartelle come /world/ o directory di backup esistenti. Per backup coerenti del mondo di gioco dovresti prima fermare il server oppure usare la funzione di backup del tuo pannello, se è disponibile per il tuo server.