Servire un’applicazione locale limitata
Servire un’applicazione locale limitata — Creare una chat AI locale. Ascoltare solo su loopback; Salvare server.mjs; Provare servizio e percorsi mancanti. Esercitazione pratica: Prove del laboratorio.
Versione demo. I materiali sono in fase di revisione editoriale.
Argomenti trattati
- Ascoltare solo su loopback
- Salvare server.mjs
- Provare servizio e percorsi mancanti
Ascoltare solo su loopback
Avvia su 127.0.0.1:3000. Il confine locale è esplicito, ma non autentica contro ogni processo sulla stessa macchina.
Il browser mostra messaggi, il server valida richieste e Ollama genera testo. Separa i ruoli per impedire al browser di scegliere endpoint arbitrari o leggere file server. Usa domande sintetiche sul laboratorio. La risposta è testo generato, non consiglio verificato. Il confine locale riduce trasferimenti esterni ma non protegge da tutti gli utenti locali, estensioni o integrazioni configurate.
Salvare server.mjs
Il server espone due soli percorsi statici e health. Crea app.js vuoto fino alla lezione client; un file mancante deve produrre errore.
L’allowlist rifiuta volutamente query e percorsi sconosciuti, limitando l’esempio e impedendo percorsi filesystem arbitrari. Se aggiungi parsing URL o cartelle risorse, scrivi test espliciti invece di eliminare l’allowlist per risolvere un singolo file mancante.
Crea i file indicati in una cartella ed esegui Node da lì. Modello ed endpoint sono fissati sul server. Prima dello streaming valida input e stato upstream; dopo l’avvio comunica errori nel flusso o con stato interrotto visibile. Distingui limiti di byte, messaggi e contesto: controllano risorse diverse. Provali separatamente conservando la richiesta che riproduce il rifiuto.
import http from 'node:http';
import {readFile} from 'node:fs/promises';
const files={'/':['index.html','text/html; charset=utf-8'],'/app.js':['app.js','text/javascript; charset=utf-8']};
http.createServer(async(req,res)=>{try{
if(req.method==='GET'&&req.url==='/health'){res.writeHead(200,{'Content-Type':'text/plain'});return res.end('ok');}
// Insert the POST /api/chat branch here in the next lesson.
const item=req.method==='GET'?files[req.url]:null;if(!item){res.writeHead(404);return res.end('Not found');}
const data=await readFile(item[0]);res.writeHead(200,{'Content-Type':item[1],'X-Content-Type-Options':'nosniff'});res.end(data);
}catch{if(!res.headersSent)res.writeHead(500);res.end('Local server error');}}).listen(3000,'127.0.0.1');
// Terminal: node server.mjs
Provare servizio e percorsi mancanti
Apri health e home, poi un file inesistente. Health verifica il server applicativo, non il modello. Controlla Ollama separatamente.
Prova risposta riuscita, servizio fermo, interruzione e input eccessivo. Mantieni il testo incompleto come parziale. La cronologia vive nella memoria dell’interfaccia e può essere svuotata; ciò non cancella log del sistema o backup esterni. Prima di pubblicare aggiungi autenticazione, autorizzazione, TLS, quote, conservazione e monitoraggio. Una demo locale, anche gradevole, non dimostra l’esistenza di tali controlli.
curl -i http://127.0.0.1:3000/health
curl -i http://127.0.0.1:3000/missing
curl -sS http://127.0.0.1:11434/api/tags
Esercitazione pratica
Prove del laboratorio
Vai alla lezione