Libretto d'uso e manutenzione
del sito mezzi.fossatiinterni.it

§ 1Il principio di funzionamento

Sul server c'è una cartella. Quello che ci metti dentro compare su internet, all'istante, senza riavviare niente, senza premere «pubblica», senza aspettare l'approvazione di nessuno. Tutto qui. Il resto del libretto serve a dirlo in modo più lungo.

§ 2Dati di accesso

§ 3La prima connessione

La prima volta il programma ti avvisa che non conosce il server e ti chiede se ti fidi. È una domanda seria, anche se è scritta in modo da farti premere «Sì» senza pensarci. Prima di rispondere controlla che l'impronta (fingerprint) mostrata sia questa:

ED25519  SHA256:41f6O6UJ7aBciaAeLkxT8eKb33OUoiTvDNB1Wp6GaYs
RSA      SHA256:ZROZUssbGqrJZ+sIF2KtDh+4L8vyxG6MFud0nZOmac4

Basta che coincida una delle due: quale ti mostra dipende dal programma. Se coincide, accetta e spunta «memorizza». Se non coincide, non accettare e vai al § 8, ultima riga.

§ 4Metodo A — FileZilla (Windows, Mac, Linux)

Si scarica da filezilla-project.org scegliendo FileZilla Client. Durante l'installazione leggi le schermate: ogni tanto l'installer propone software «in omaggio». Un antivirus di cui non sapevi di aver bisogno non serve.

1. File → Gestore siti → Nuovo sito. Chiamalo «mezzi», o «il mio sito», o come vuoi: lui non si offende.
2. Protocollo: SFTP – SSH File Transfer Protocol.
3. Host: mezzi.fossatiinterni.it · Porta: 22.
4. Tipo di accesso: File chiave · Utente: root.
5. File chiave: Sfoglia… e scegli la tua chiave privata, quella senza .pub. Se è in formato OpenSSH, FileZilla propone di convertirla in .ppk: accetta e salvala accanto all'originale.
6. Scheda Avanzate → Cartella remota predefinita: /home/dockers/nginx/data/mezzi. Così ti apre direttamente lì e riduci di molto le occasioni di girare per il server.
7. Connetti. Al primo collegamento guarda il § 3.
8. Trascina i file dalla colonna di sinistra (il tuo computer) a quella di destra (il server). Fatto.

§ 5Metodo B — WinSCP (solo Windows)

1. Scarica da winscp.net e installa.
2. Nuova sessione · Protocollo: SFTP · Host: mezzi.fossatiinterni.it · Porta: 22 · Utente: root · password vuota.
3. Avanzate… → SSH → Autenticazione → File chiave privata: scegli la tua chiave. Se non è .ppk WinSCP propone di convertirla: di' di sì.
4. Avanzate… → Ambiente → Directory → Directory remota: /home/dockers/nginx/data/mezzi.
5. Salva, poi Accedi. Il resto è un trascina-e-rilascia, come per FileZilla.

§ 6Metodo C — Il terminale

Per le occasioni in cui vuoi far vedere a qualcuno che sai usare il terminale. Da Mac, Linux o il PowerShell di Windows 10/11:

sftp root@mezzi.fossatiinterni.it
# se la chiave non è quella predefinita:
sftp -i ~/.ssh/la-mia-chiave root@mezzi.fossatiinterni.it

sftp> cd /home/dockers/nginx/data/mezzi
sftp> put listino.pdf          # un file
sftp> put -r foto              # una cartella intera
sftp> ls                       # controlla che sia arrivato
sftp> bye

Oppure in un colpo solo, senza entrare:

scp -r cartella-del-sito/* root@mezzi.fossatiinterni.it:/home/dockers/nginx/data/mezzi/

Il trucco che ti fa risparmiare un sacco di battute: aggiungi questo al file ~/.ssh/config (su Windows: C:\Users\<tu>\.ssh\config)

Host mezzi
    HostName mezzi.fossatiinterni.it
    User root
    IdentityFile ~/.ssh/la-mia-chiave

e da quel momento basta sftp mezzi oppure scp file.pdf mezzi:/home/dockers/nginx/data/mezzi/. Ti tornerà utile anche al paragrafo successivo.

§ 6-bisMetodo D — Delegare a Claude (il metodo che userai davvero)

Lo sappiamo tutti e due: hai letto i § 4–6 in diagonale, solo per poter dire di averli letti. Va bene così. Anche questo libretto l'ha scritto Claude, e qualcuno l'ha firmato lo stesso.

Perché funzioni servono tre cose:

1. Claude con le mani. La chat di claude.ai nel browser non può collegarsi al server: sa spiegare, ma non può fare. Ti serve Claude Code, nel terminale o nell'app desktop, aperto nella cartella dove tieni i file del sito.
2. L'alias mezzi nel ~/.ssh/config (vedi § 6). Così Claude non deve cercare la tua chiave nel disco, attività che ha l'aria di essere più eccitante di quanto sia.
3. Istruzioni precise. Claude è diligente, ma ha accesso root come te. Un «sistemami il sito» detto a un assistente zelante con i poteri di root è il modo moderno di dire «arrangiati».

Ecco un prompt già pronto. Copialo, cambia i nomi dei file e incollalo:

Carica il file listino.pdf e la cartella foto/ sul mio sito, via scp,
nella cartella mezzi:/home/dockers/nginx/data/mezzi/
Regole:
- sul server lavora SOLO dentro /home/dockers/nginx/data/mezzi/
- non cancellare, rinominare o modificare nient'altro
- non riavviare servizi e non toccare configurazioni
- i file devono avere permessi 644, le cartelle 755
Alla fine controlla con curl che https://mezzi.fossatiinterni.it/listino.pdf
risponda 200 e dimmi gli indirizzi pubblici dei file caricati.

§ 7Regole della casa

7.1 · Nomi dei file

Il server gira su Linux, e Linux distingue Foto.JPG da foto.jpg. Niente spazi, niente accenti, niente parentesi.

7.2 · La pagina principale

index.html è la pagina che si apre su mezzi.fossatiinterni.it: in questo momento è questo libretto. Se carichi un tuo index.html lo sostituisci, ed è giusto così: una copia del libretto resta su /istruzioni.html, che ti conviene non sovrascrivere.

Una cartella senza index.html risponde 403 Forbidden e non mostra l'elenco dei file. È voluto: nessuno deve poter curiosare tra le tue cose, nemmeno tu dal browser.

7.3 · Tutto quello che carichi è pubblico

Chiunque abbia l'indirizzo vede il file. Se un nome è difficile da indovinare la probabilità si abbassa, ma non è una protezione. Quindi niente buste paga, contratti, listini riservati ai rivenditori e foto della cena aziendale.

7.4 · Non serve riavviare niente

Appena il trasferimento finisce, il file è online. Se nel browser vedi ancora la versione vecchia non è colpa del server, è il browser che si ricorda: Ctrl+F5 su Windows, Cmd+Shift+R su Mac.

§ 8Guasti e rimedi