Labtainers: un framework per laboratori informatici basato su Docker

Labtainers include più di 50 esercizi di laboratorio informatico e strumenti per crearne di propri. Importa una singola VM appliance o installa su un sistema Linux e i tuoi studenti hanno finito con il provisioning e la configurazione amministrativa, per questi e futuri esercizi di laboratorio.

• Ambienti di esecuzione dei laboratori coerenti e provisioning automatizzato tramite container Docker
• Topologie di rete multi-componente su un computer portatile di modeste prestazioni
• Valutazione automatizzata dell'attività e dei progressi degli studenti nei laboratori
• Esercizi di laboratorio individualizzati per scoraggiare la condivisione delle soluzioni

Labtainers fornisce ambienti di esecuzione controllati e coerenti in cui gli studenti svolgono i laboratori interamente all'interno del proprio computer, indipendentemente dalla distribuzione Linux e dai pacchetti installati sul computer dello studente. Labtainers funziona sulla nostra [VM appliance][vm-appliancee], o su qualsiasi Linux con Docker installato. E Labtainers è disponibile come VM basate su cloud, ad esempio su Azure come descritto nella Student Guide.

Consulta la Student Guide per l'installazione e l'utilizzo, e la Instructor Guide per la valutazione degli studenti. Lo sviluppo e la personalizzazione degli esercizi di laboratorio sono descritti nella Designer Guide. Consulta i Papers per ulteriori informazioni sul framework. Il sito web di Labtainers e i download (incluse le VM appliance con Labtainers preinstallato) sono disponibili su https://nps.edu/web/c3o/labtainers.

Distribution created: 09/11/2026 11:33
Revision: v1.4.4n
Commit: 9f1012dc
Branch: master

Content

Distribution and Use

Guide to directories

Support

Release notes

Distribution and Use

Consulta le informazioni sulla licenza e sulla distribuzione nel file docs/license.md.

Guide to directories

• scripts/labtainers-student -- la directory di lavoro per eseguire e testare i laboratori degli studenti. Devi trovarti in quella directory per eseguire i laboratori degli studenti.

• scripts/labtainers-instructor -- la directory di lavoro per eseguire e testare la valutazione automatizzata e visualizzare i risultati degli studenti.

• labs -- File specifici per ciascuno dei laboratori

• setup_scripts -- script per installare Labtainers e Docker e aggiornare Labtainers

• docs -- sorgente latex per labdesigner.pdf e altra documentazione.

• UI -- codice sorgente dell'editor di laboratori Labtainers (Java).

• headless-lite -- script per gestire Docker Workstation e istanze cloud di Labtainers (sistemi che non dispongono di server X11 nativi.)

• scripts/designer -- Strumenti per creare nuovi laboratori e gestire le immagini Docker di base.

• config -- impostazioni di configurazione a livello di sistema (queste non sono le impostazioni di configurazione specifiche dei laboratori.

• distrib -- script di supporto alla distribuzione, ad esempio per pubblicare laboratori sull'hub Docker.

• testsets -- Procedure di test e risultati attesi. (I driver per-lab per SimLab non sono distribuiti).

• pkg-mirrors -- script di utilità per il mirroring interno dei pacchetti NPS al fine di ridurre il prelievo esterno di pacchetti durante i test e la distribuzione.

Support

Usa le segnalazioni di problemi su GitHub, oppure scrivimi a [email protected]

Vedi anche https://my.nps.edu/web/c3o/support1

Release notes

La distribuzione standard di Labtainers non include i file necessari per lo sviluppo di nuovi laboratori. Per quelli, esegui ./update-designer.sh dalla directory labtainer/trunk/setup_scripts.

Lo script di installazione e lo script update-designer.sh impostano variabili d'ambiente, quindi potresti voler effettuare logout/login, o avviare una nuova shell bash prima di usare Labtainers la prima volta.

Jauary 6, 2026

• Corretto bug introdotto nello script di installazione a causa di indentazioni.

December 30, 2025

• Modificato il formato del report checkwork per essere verticale; guida video per headless; percorsi di convenienza

October 15, 2025

• Revisionato il laboratorio packet-introspection per aggiornare il link per il database di geolocalizzazione maxmind e nota sull'uso del database legacy.

April 24, 2025

• Corretto imodule per creare correttamente le directory mancanti secondo la pull request #96

November 22, 2024

• Sostituita la VM di google cloud, questa volta a causa di un guasto di systemd all'interno dei container.

September 23, 2024

• Sostituita la VM di google cloud, che utilizzava la versione sbagliata di Docker

September 10, 2024

• Refuso nella creazione del percorso imodule

July 26, 2024

• Modificato capinout per non usare la funzione clib grantpt, che ora sembra andare in crash quando eseguita da un container.

July 22, 2024

• Aggiunto un container di base per Ubuntu22 e modifiche al framework per supportarlo.

July 5, 2024

• Migrazione a Ubuntu 24 come VM appliance
• Il pacchetto python docker usa una libreria http python difettosa, richiede il downgrade del pacchetto.
• Usa un ambiente python virtuale per evitare il blocco dei pacchetti python da parte di Ubuntu.
• Aggiunto parametro di boot per consentire la condivisione di systemd tra container e VM.
• Reindirizzati i messaggi di errore dall'utility tar difettosa durante gli aggiornamenti.
• Rottura dell'aggiornamento di Ubuntu per i pacchetti msc (vedi update-ubuntu.sh) per le VM versione 18
• Il comando docker-compose è difettoso, usa "docker compose"
• Forzati i permessi del socket in headless labtainers.
• Aggiornato headless Labtainers per usare Ubuntu 24

November 27, 2023

• Aggiunta l'opzione Google Cloud Platform per ubuntu22 su macchina ec2.

September 18, 2023

• L'implementazione della correzione precedente era difettosa.

August 8, 2023

• Gestito il cambiamento al formato json delle immagini DockerHub. Grazie Kees!

April 17, 2023

• Forza l'uso della versione più recente del laboratorio, ad esempio iptables2 invece di iptables. Corretto il completamento con tab per visualizzare solo la più recente. (Issue #77)
• L'installazione del laboratorio CyberCIEGE falliva a causa di una race condition di X11. (Issue #76)
• Nota nel readme di CyberCIEGE per indirizzare gli studenti a salvare i log raccolti nella directory $HOME. (Issue #75)
• Il checkwork del laboratorio Radius riportava erroneamente "radiusd not running", mancava lo script prestop. (Issue #74)
• Labedit corrompeva il file di configurazione di avvio quando veniva usata l'opzione MACVLAN_EXT. (Issue #73)