Viene mostrato il Markdown grezzo: non è stato possibile caricare il visualizzatore.
## Obiettivo
Trasformare il tuo computer in un piccolo server web, aprire la sua pagina in un browser e guardare il server annotare ogni richiesta che riceve. Vedrai con i tuoi occhi la richiesta e la risposta della lezione.
## Obiettivi
- Avviare un piccolo server web sul tuo computer e aprirlo in un browser.
- Leggere una riga di log di un server e dire cosa significa ogni parte.
- Spiegare cos'è un `404` e vederne uno accadere.
## Prerequisiti
- [La lezione di questo modulo](lesson.it.md).
- Sai aprire un terminale e spostarti tra le cartelle ([modulo 02](../02-terminal-basics/README.it.md)).
- **Python 3**. Controlla digitando `python3 --version` (macOS e Linux) o `python --version` (Windows) in un terminale. Dovrebbe stampare qualcosa come `Python 3.12.3`; va bene qualsiasi versione 3.x.
- Un browser web e un editor di testo semplice (Blocco note, TextEdit in modalità testo semplice, gedit, VS Code…).
> [!WARNING]
> Il server che avvii è raggiungibile solo dal **tuo computer**, grazie a `--bind 127.0.0.1`. Non togliere quell'opzione e ferma il server (Passo 5) quando hai finito. Windows potrebbe chiederti se consentire a Python di passare attraverso il firewall; con questa opzione puoi scegliere senza rischi **Annulla** o **Nega**.
## Architettura
<figure class="diagram" style="--dg-w: 1000px"><svg xmlns="http://www.w3.org/2000/svg" class="dg" viewBox="0 0 1000 380" width="1000" height="380" role="img" aria-labelledby="webserver-lab-architecture-it-title webserver-lab-architecture-it-desc" font-family="Inter, system-ui, -apple-system, Segoe UI, Roboto, sans-serif" xml:lang="it">
<title id="webserver-lab-architecture-it-title">Configurazione del laboratorio: un server web e un browser sullo stesso computer</title>
<desc id="webserver-lab-architecture-it-desc">Tutto avviene dentro una zona, il tuo computer. Un browser con l'indirizzo http://127.0.0.1:8000 invia una richiesta, freccia 1, a un server web Python avviato con python3 -m http.server 8000 --bind 127.0.0.1. Il server legge il file index.html dalla cartella ~/my-website e lo restituisce come risposta, freccia 2. Nel terminale in cui il server è in esecuzione compare una riga di log per ogni richiesta, per esempio GET barra con stato 200 e GET barra x con stato 404. Una nota dice che 127.0.0.1 significa questo computer, quindi nessun altro può raggiungere il server.</desc>
<rect class="dg-bg" x="0.5" y="0.5" width="999" height="379" rx="16" fill="#ffffff" stroke="#e3e3dd"/>
<g class="dg-l1"><rect class="dg-tint" x="20" y="20" width="960" height="340" rx="16" fill="#f0f6f9" stroke="#9ac3d9" stroke-width="1.2" stroke-dasharray="6 5"/>
<g class="dg-icon" transform="translate(36 33) scale(0.7500)" fill="none" stroke="#0369a1" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M20 16V7a2 2 0 0 0-2-2H6a2 2 0 0 0-2 2v9m16 0H4m16 0 1.28 2.55a1 1 0 0 1-.9 1.45H3.62a1 1 0 0 1-.9-1.45L4 16"/></g>
<text x="62" y="47" font-size="13" class="dg-ink" fill="#0369a1" font-weight="700">Il tuo computer</text></g>
<rect class="dg-card" x="44" y="70" width="290" height="150" rx="12" fill="#ffffff" stroke="#cfcfc8"/>
<g class="dg-l1"><g class="dg-icon" transform="translate(60 86) scale(1.2500)" fill="none" stroke="#0369a1" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><path d="M12 2a14.5 14.5 0 0 0 0 20 14.5 14.5 0 0 0 0-20"/><path d="M2 12h20"/></g></g>
<g class="dg-l1"><text x="102" y="107" font-size="15" class="dg-ink" fill="#0369a1" font-weight="700">Il tuo browser</text></g>
<text x="62" y="138" font-size="13" class="dg-muted" fill="#5c5c68" font-weight="500">Barra degli indirizzi:</text>
<text x="62" y="168" font-size="14" class="dg-text" fill="#17171c" font-weight="600" font-family="JetBrains Mono, ui-monospace, Menlo, Consolas, monospace">http://127.0.0.1:8000</text>
<rect class="dg-card" x="500" y="70" width="460" height="150" rx="12" fill="#ffffff" stroke="#cfcfc8"/>
<g class="dg-l2"><g class="dg-icon" transform="translate(516 86) scale(1.2500)" fill="none" stroke="#15803d" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><rect width="20" height="8" x="2" y="2" rx="2"/><rect width="20" height="8" x="2" y="14" rx="2"/><path d="M6 6h.01"/><path d="M6 18h.01"/></g></g>
<g class="dg-l2"><text x="558" y="107" font-size="15" class="dg-ink" fill="#15803d" font-weight="700">Server web Python</text></g>
<text x="518" y="138" font-size="13" class="dg-muted" fill="#5c5c68" font-weight="500">Avviato con:</text>
<text x="518" y="168" font-size="14" class="dg-text" fill="#17171c" font-weight="600" font-family="JetBrains Mono, ui-monospace, Menlo, Consolas, monospace">python3 -m http.server 8000 --bind 127.0.0.1</text>
<rect class="dg-card" x="688" y="238" width="272" height="104" rx="12" fill="#ffffff" stroke="#cfcfc8"/>
<g class="dg-l3"><g class="dg-icon" transform="translate(704 254) scale(1.2500)" fill="none" stroke="#b45309" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M20 20a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 1-1.69-.9L9.6 3.9A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2Z"/></g></g>
<g class="dg-l3"><text x="746" y="275" font-size="14" class="dg-ink" fill="#b45309" font-weight="700">~/my-website</text></g>
<text x="706" y="306" font-size="13" class="dg-muted" fill="#5c5c68" font-weight="500">index.html</text>
<text x="706" y="326" font-size="13" class="dg-muted" fill="#5c5c68" font-weight="500">il file che il server invia</text>
<g class="dg-l3"><path class="dg-stroke" d="M830 222V234" stroke="#b45309" stroke-width="2.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/></g>
<g class="dg-l3"><path class="dg-stroke" d="M824 229l6 8 6-8" stroke="#b45309" stroke-width="2.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/></g>
<text x="842" y="233" font-size="11.5" class="dg-muted" fill="#5c5c68" font-weight="600">legge</text>
<g class="dg-l1"><path class="dg-stroke" d="M338 112H486" stroke="#0369a1" stroke-width="2.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/></g>
<g class="dg-l1"><path class="dg-stroke" d="M481 106l8 6-8 6" stroke="#0369a1" stroke-width="2.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/></g>
<g class="dg-l1"><rect class="dg-bg-plain" x="369.58" y="82" width="88.84" height="24" rx="12" fill="#ffffff"/><text x="414" y="98.5" font-size="11.5" class="dg-ink" fill="#0369a1" font-weight="600" text-anchor="middle">1 richiesta</text></g>
<g class="dg-l2"><path class="dg-stroke" d="M496 180H348" stroke="#15803d" stroke-width="2.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/></g>
<g class="dg-l2"><path class="dg-stroke" d="M353 174l-8 6 8 6" stroke="#15803d" stroke-width="2.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/></g>
<g class="dg-l2"><rect class="dg-bg-plain" x="378.8" y="186" width="82.4" height="24" rx="12" fill="#ffffff"/><text x="420" y="202.5" font-size="11.5" class="dg-ink" fill="#15803d" font-weight="600" text-anchor="middle">2 risposta</text></g>
<rect class="dg-card" x="44" y="238" width="620" height="104" rx="12" fill="#17171c" stroke="#17171c"/>
<text x="62" y="262" font-size="12" class="dg-muted" fill="#b8b8c4" font-weight="700">Qui compare una riga per ogni richiesta</text>
<text x="62" y="290" font-size="12.5" class="dg-text" fill="#e8e8ee" font-weight="500" font-family="JetBrains Mono, ui-monospace, Menlo, Consolas, monospace">127.0.0.1 - - "GET / HTTP/1.1" 200 -</text>
<text x="62" y="312" font-size="12.5" class="dg-text" fill="#e8e8ee" font-weight="500" font-family="JetBrains Mono, ui-monospace, Menlo, Consolas, monospace">127.0.0.1 - - "GET /x HTTP/1.1" 404 -</text>
<text x="960" y="52" font-size="12" class="dg-muted" fill="#5c5c68" font-weight="600" text-anchor="end">127.0.0.1 significa "questo computer": nessun altro può raggiungere il tuo server</text>
</svg></figure>
*Figura 1. Il browser è il client, il programma Python è il server e il terminale mostra una riga per ogni richiesta.*
## Passaggi
### Passo 1 — Crea una cartella con una pagina web (8 min)
Un server web ha bisogno di file da servire. Crei una cartella chiamata `my-website` e ci metti una pagina.
Nel terminale, crea la cartella ed entraci:
```bash
mkdir ~/my-website
cd ~/my-website
```
In Windows PowerShell le stesse due righe funzionano così come sono.
`mkdir` crea una cartella, `~` è la tua cartella personale e `cd` ci entra. Ora apri il tuo editor di testo e crea in questa cartella un file chiamato **`index.html`** con esattamente questo contenuto:
```html
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Il mio primo sito web</title>
</head>
<body>
<h1>Ciao dal mio server!</h1>
<p>Questa pagina è un file sul mio computer.</p>
</body>
</html>
```
Questo è HTML. `<h1>` indica un titolo grande e `<p>` un paragrafo. Il testo in `<title>` compare nella scheda del browser. Salva il file, assicurandoti che il nome sia `index.html` e non `index.html.txt` (Windows nasconde le estensioni per impostazione predefinita; nel Blocco note, "Salva come" deve essere "Tutti i file").
Controlla che il file sia lì:
```bash
ls
```
In Windows PowerShell funziona anche `ls`.
Output atteso:
```text
index.html
```
Perché `index.html`? Quando qualcuno chiede `/` a un server web, il server cerca un file con questo nome. È la home page predefinita.
### Passo 2 — Avvia il server (5 min)
Sempre in `~/my-website`, esegui:
```bash
python3 -m http.server 8000 --bind 127.0.0.1
```
In Windows usa `python` al posto di `python3` (o `py` se `python` non viene trovato).
Output atteso:
```text
Serving HTTP on 127.0.0.1 port 8000 (http://127.0.0.1:8000/) ...
```
Riga per riga, il comando significa:
- `python3 -m http.server` avvia un piccolo server web fornito con Python. Serve i file della cartella in cui ti trovi.
- `8000` è la **porta**, il numero della porta (la lezione ha spiegato le porte).
- `--bind 127.0.0.1` lo fa ascoltare solo su `127.0.0.1`, l'indirizzo che significa sempre "questo computer".
Il terminale ora sembra "bloccato": non compare nessun nuovo prompt. È normale. Il server è in esecuzione e aspetta richieste, e questa finestra del terminale è il posto in cui riferisce. Lasciala aperta.
> [!NOTE]
> Se vedi `OSError: [Errno 98] Address already in use` (in Windows, un messaggio sull'indirizzo già in uso), un altro programma usa già la porta 8000. Scegli un'altra porta, per esempio `8001`, e usala ovunque questo laboratorio dica 8000.
### Passo 3 — Visita la pagina e leggi il log (8 min)
Apri il tuo browser web e digita questo indirizzo nella barra degli indirizzi:
```text
http://127.0.0.1:8000
```
Dovresti vedere una pagina con il titolo grande "Ciao dal mio server!" e la scheda intitolata "Il mio primo sito web". Hai appena usato il tuo computer sia come client (il browser) sia come server (Python).
Ora guarda il terminale. Sono comparse nuove righe. La data e l'ora sul tuo schermo saranno diverse, e il browser potrebbe mostrare anche una seconda riga per `/favicon.ico`, la piccola icona della scheda che chiede sempre:
```text
127.0.0.1 - - [07/Nov/2026 21:48:34] "GET / HTTP/1.1" 200 -
```
Leggila da sinistra a destra:
| Parte | Significato |
|---|---|
| `127.0.0.1` | Chi ha chiesto: l'indirizzo del client. Qui è il tuo computer. |
| `- -` | Due campi che i server possono riempire con dati di accesso. Qui non sono usati. |
| `[07/Nov/2026 21:48:34]` | Quando è arrivata la richiesta. La tua mostrerà la data e l'ora attuali. |
| `"GET / HTTP/1.1"` | La richiesta: il metodo `GET` ("mandami questo"), il percorso `/` (la home page) e la versione di HTTP. |
| `200` | Il codice di stato: OK, il server ha trovato il file e l'ha inviato. |
| `-` | La dimensione della risposta, che questo semplice server lascia vuota. |
Pensaci prima di aprire la risposta: non hai mai digitato `index.html` nell'indirizzo, quindi perché il server l'ha inviato?
<details>
<summary>Mostra la risposta</summary>
Il percorso nella richiesta era solo `/`. Un server web risponde a `/` con la pagina predefinita della cartella, che si chiama `index.html`. Potresti anche digitare `http://127.0.0.1:8000/index.html` e ottenere la stessa pagina. Ricarica quell'indirizzo e guarda il log: compare una nuova riga `GET /index.html`.
</details>
### Passo 4 — Cambia la pagina, poi chiedi una pagina che non esiste (6 min)
Il server non tiene la pagina in memoria: legge il file ogni volta. Quindi puoi cambiare la pagina senza riavviare nulla.
Apri `index.html` nel tuo editor, cambia il testo dentro `<p>…</p>` con qualcosa di nuovo, per esempio `Ho appena modificato questa pagina!`, e salva. Torna al browser e **ricaricalo** (F5, o Cmd+R su un Mac). Compare il nuovo testo. Nel terminale è comparsa una nuova riga `GET / ... 200`.
Ora chiedi un file che non esiste. Nella barra degli indirizzi digita:
```text
http://127.0.0.1:8000/about.html
```
Il browser mostra una pagina di errore, "Error response: Error code: 404, Message: File not found". Guarda il terminale:
```text
127.0.0.1 - - [07/Nov/2026 21:48:34] code 404, message File not found
127.0.0.1 - - [07/Nov/2026 21:48:34] "GET /about.html HTTP/1.1" 404 -
```
Cosa è cambiato rispetto alla prima riga di log, e un 404 significa che il server è rotto?
<details>
<summary>Mostra la risposta</summary>
Il percorso ora è `/about.html` e il codice di stato è `404` invece di `200`. Un 404 **non** significa che il server sia rotto: il server funziona benissimo e ha risposto, dicendo "non ho alcun file a quel percorso". In questo caso il file non esiste in `~/my-website`. Come sfida puoi creare `about.html` e ricaricare; il 404 diventa un 200.
</details>
### Passo 5 — Ferma il server (3 min)
Vai al terminale in cui è in esecuzione il server e premi **Ctrl+C** (tieni premuto il tasto Ctrl e premi C).
Output atteso:
```text
Keyboard interrupt received, exiting.
```
Il prompt ritorna. Ora vai al browser e ricarica la pagina: mostra un errore come "Impossibile connettersi" o "Impossibile raggiungere il sito". Nessuno ascolta più sulla porta 8000, quindi la richiesta non riceve alcuna risposta. È diverso da un 404, in cui il server risponde.
## Verifica
Hai completato il laboratorio se:
- Il browser ha mostrato la tua pagina "Ciao dal mio server!" su `http://127.0.0.1:8000` mentre il server era in esecuzione.
- Il terminale ha mostrato una riga di log che termina con `200` per essa e una riga che termina con `404` per la pagina mancante.
- Dopo Ctrl+C, il browser non è più riuscito a connettersi.
## Risoluzione dei problemi
| Sintomo | Causa probabile | Soluzione |
|---|---|---|
| `python3: command not found` | Python non è installato, o in Windows si chiama `python` | Installa Python 3 da python.org e, in Windows, digita `python` o `py` al posto di `python3` |
| `Address already in use` | Un altro programma usa la porta 8000, oppure il server è già in esecuzione in un altro terminale | Ferma l'altro, o usa un'altra porta come `8001` nel comando e nell'indirizzo |
| Il browser mostra "Directory listing for /" o un 404 per `/` | Hai avviato il server nella cartella sbagliata, oppure il file non si chiama `index.html` | Premi Ctrl+C, esegui `cd ~/my-website`, controlla con `ls` che `index.html` sia elencato e riavvia |
| Le modifiche non compaiono | La pagina è in cache o il file non è stato salvato | Salva il file, poi forza il ricaricamento (Ctrl+F5, o Cmd+Maiusc+R su un Mac) |
| `index.html.txt` nell'elenco | L'editor ha aggiunto `.txt` | Salva di nuovo come "Tutti i file" con il nome `index.html` |
## Sfida (facoltativa)
1. Aggiungi una seconda pagina, `about.html`, con il tuo nome in un titolo, e crea un link da `index.html` con `<a href="about.html">Chi sono</a>`. Clicca sul link e trova la riga corrispondente nel log.
2. Ferma il server e avvialo sulla porta 9000. Quale indirizzo devi digitare ora nel browser?
## Pulizia
Il laboratorio ha creato una cartella e nient'altro. Assicurati che il server sia fermo (Ctrl+C), poi rimuovi la cartella.
In macOS o Linux:
```bash
cd ~
rm -r ~/my-website
```
In Windows PowerShell:
```text
cd ~
Remove-Item -Recurse ~/my-website
```
## Cosa hai imparato
- Qualsiasi computer diventa un server quando esegue un programma che risponde a richieste; il tuo l'ha fatto con un solo comando.
- Una richiesta ha un metodo e un percorso, e la risposta di un server inizia con un codice di stato: `200` per il successo, `404` per "qui non c'è nulla".
- Il server legge i file da una cartella, e `index.html` è la pagina predefinita di una cartella.
- Associare il server a `127.0.0.1` mantiene un server di prova privato sul tuo computer, e Ctrl+C lo ferma.