Labtainers: uma estrutura de laboratório cibernético baseada em Docker

Os Labtainers incluem mais de 50 exercícios de laboratório cibernético e ferramentas para construir os seus próprios. Importe uma única VM appliance ou instale num sistema Linux e os seus alunos ficam dispensados do provisionamento e da configuração administrativa, para estes e futuros exercícios de laboratório.

• Ambientes de execução de laboratório consistentes e provisionamento automatizado através de contentores Docker
• Topologias de rede com múltiplos componentes num portátil de desempenho modesto
• Avaliação automatizada da atividade e do progresso dos alunos no laboratório
• Exercícios de laboratório individualizados para desencorajar a partilha de soluções

Os Labtainers proporcionam ambientes de execução controlados e consistentes nos quais os alunos realizam os laboratórios inteiramente dentro dos limites do seu computador, independentemente da distribuição Linux e dos pacotes instalados no computador do aluno. Os Labtainers são executados na nossa [VM appliance][vm-appliancee], ou em qualquer Linux com Docker instalado. E os Labtainers estão disponíveis como VMs baseadas na cloud, por exemplo, no Azure, conforme descrito no Student Guide.

Consulte o Student Guide para instalação e utilização, e o Instructor Guide para avaliação dos alunos. O desenvolvimento e a personalização de exercícios de laboratório são descritos no Designer Guide. Consulte os Papers para informações adicionais sobre a estrutura. O site dos Labtainers e os downloads (incluindo VM appliances com os Labtainers pré-instalados) estão em 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

Consulte as informações de licenciamento e distribuição no docs/license.md file.

Guide to directories

• scripts/labtainers-student -- o diretório de trabalho para executar e testar laboratórios de alunos. Tem de estar nesse diretório para executar laboratórios de alunos.

• scripts/labtainers-instructor -- o diretório de trabalho para executar e testar avaliação automatizada e visualizar os resultados dos alunos.

• labs -- Ficheiros específicos de cada um dos laboratórios

• setup_scripts -- scripts para instalar os Labtainers e o Docker e atualizar os Labtainers

• docs -- código-fonte latex para o labdesigner.pdf, e outra documentação.

• UI -- código-fonte do editor de laboratórios Labtainers (Java).

• headless-lite -- scripts para gerir o Docker Workstation e instâncias na cloud dos Labtainers (sistemas que não têm servidores X11 nativos.)

• scripts/designer -- Ferramentas para construir novos laboratórios e gerir imagens Docker base.

• config -- definições de configuração de todo o sistema (estas não são as definições de configuração específicas de cada laboratório.

• distrib -- scripts de suporte à distribuição, por exemplo, para publicar laboratórios no Docker hub.

• testsets -- Procedimentos de teste e resultados esperados. (Os controladores por laboratório para o SimLab não são distribuídos).

• pkg-mirrors -- scripts utilitários para espelhamento interno de pacotes do NPS, para reduzir a obtenção externa de pacotes durante testes e distribuição.

Support

Utilize os relatórios de problemas do GitHub, ou envie-me um email para [email protected]

Consulte também https://my.nps.edu/web/c3o/support1

Release notes

A distribuição padrão dos Labtainers não inclui os ficheiros necessários para o desenvolvimento de novos laboratórios. Para esses, execute ./update-designer.sh a partir do diretório labtainer/trunk/setup_scripts.

O script de instalação e o script update-designer.sh definem variáveis de ambiente, por isso pode querer terminar sessão/iniciar sessão, ou iniciar uma nova shell bash antes de utilizar os Labtainers pela primeira vez.

Jauary 6, 2026

• Corrigido bug introduzido no script de instalação devido a indentação.

December 30, 2025

• Formato do relatório checkwork modificado para vertical; guia em vídeo para headless; caminhos de conveniência

October 15, 2025

• Laboratório packet-introspection revisto para atualizar a ligação para a base de dados de geolocalização maxmind e notar a utilização da base de dados legacy.

April 24, 2025

• Corrigido o imodule para criar corretamente os diretórios em falta, conforme o pull request #96

November 22, 2024

• Substituída a VM do google cloud, desta vez devido a uma falha do systemd dentro dos contentores.

September 23, 2024

• Substituída a VM do google cloud, que estava a usar a versão errada do Docker

September 10, 2024

• Gralha na criação do caminho do imodule

July 26, 2024

• Modificado o capinout para não usar a função clib grantpt, que agora parece falhar quando executada a partir de um contentor.

July 22, 2024

• Adicionado um contentor base para Ubuntu22 e alterações à estrutura para o suportar.

July 5, 2024

• Migração para Ubuntu 24 como VM appliance
• O pacote docker pyhton usa uma biblioteca http python avariada, requer downgrade do pacote.
• Utilizar ambiente python virtual para evitar o bloqueio de pacotes python do Ubuntu.
• Adicionar parâmetro de arranque para permitir a partilha de systemd entre contentores e a VM.
• Redirecionar mensagens de erro da ferramenta tar avariada nas atualizações.
• Quebra da atualização do Ubuntu para pacotes msc (ver update-ubuntu.sh) para VMs versão 18
• O comando docker-compose está avariado, use "docker compose"
• Forçar permissões de socket em labtainers headless.
• Atualizar os Labtainers headless para usar Ubuntu 24

November 27, 2023

• Adicionada opção Google Cloud Platform para ubuntu22 na máquina ec2.

September 18, 2023

• A implementação da correção anterior estava defeituosa.

August 8, 2023

• Lidar com a alteração ao formato json da imagem DockerHub. Obrigado Kees!

April 17, 2023

• Forçar a utilização da versão mais recente do laboratório, por exemplo, iptables2 em vez de iptables. Corrigir a conclusão com tab para mostrar apenas a mais recente. (Issue #77)
• A instalação do laboratório CyberCIEGE estava a falhar devido a uma condição de corrida do X11. (Issue #76)
• Nota no readme do CyberCIEGE para orientar os alunos a guardar os logs recolhidos no diretório $HOME. (Issue #75)
• O checkwork do laboratório Radius estava a reportar incorretamente "radiusd not running", faltava o script prestop. (Issue #74)
• O Labedit corrompia o ficheiro de configuração de arranque quando a opção MACVLAN_EXT era usada. (Issue #73)