Labtainers

Labtainers: фреймворк киберлабораторий на основе Docker

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

Содержание

Распространение и использование

Руководство по каталогам

Поддержка

Примечания к выпуску

Распространение и использование

Информацию о лицензировании и распространении см. в файле docs/license.md.

Руководство по каталогам

• scripts/labtainers-student -- рабочий каталог для запуска и тестирования студенческих лабораторных работ. Для запуска студенческих лабораторных работ необходимо находиться в этом каталоге.

• scripts/labtainers-instructor -- рабочий каталог для запуска и тестирования автоматизированной оценки и просмотра результатов студентов.

• labs -- файлы, специфичные для каждой лабораторной работы

• setup_scripts -- скрипты для установки Labtainers и Docker и обновления Labtainers

• docs -- исходники latex для labdesigner.pdf и другая документация.

• UI -- исходный код редактора лабораторий Labtainers (Java).

• headless-lite -- скрипты для управления Docker Workstation и облачными экземплярами Labtainers (системами, не имеющими нативных серверов X11).

• scripts/designer -- инструменты для создания новых лабораторий и управления базовыми образами Docker.

• config -- общесистемные настройки конфигурации (это не конфигурационные настройки конкретных лабораторий).

• distrib -- скрипты поддержки распространения, например, для публикации лабораторий в Docker hub.

• testsets -- процедуры тестирования и ожидаемые результаты. (Драйверы SimLab для отдельных лабораторий не распространяются).

• pkg-mirrors -- служебные скрипты для внутреннего зеркалирования пакетов NPS, чтобы сократить внешнюю загрузку пакетов во время тестирования и распространения.

Поддержка

Используйте отчёты о проблемах на GitHub или напишите мне на [email protected]

Также см. https://my.nps.edu/web/c3o/support1

Примечания к выпуску

Стандартный дистрибутив Labtainers не включает файлы, необходимые для разработки новых лабораторий. Для них запустите ./update-designer.sh из каталога labtainer/trunk/setup_scripts.

Скрипт установки и скрипт update-designer.sh устанавливают переменные окружения, поэтому перед первым использованием Labtainers вам, возможно, стоит выйти из системы и войти снова или запустить новый bash shell.

6 января 2026

• Исправлена ошибка, внесённая в скрипт установки из-за отступов.

30 декабря 2025

• Формат отчёта checkwork изменён на вертикальный; видеоруководство для headless; удобные пути

15 октября 2025

• Переработана лаборатория packet-introspection для обновления ссылки на базу геолокации maxmind и отмечено использование устаревшей базы данных.

24 апреля 2025

• Исправлен imodule для корректного создания отсутствующих каталогов согласно pull request #96

22 ноября 2024

• Заменена google cloud VM, на этот раз из-за сбоя systemd внутри контейнеров.

23 сентября 2024

• Заменена google cloud VM, в которой использовалась неправильная версия Docker

10 сентября 2024

• Опечатка при создании пути imodule

26 июля 2024

• Изменён capinout, чтобы не использовать clib-функцию grantpt, которая, судя по всему, теперь падает при запуске из контейнера.

22 июля 2024

• Добавлен базовый контейнер для Ubuntu22 и изменения в фреймворке для его поддержки.

5 июля 2024

• Переход на Ubuntu 24 в качестве VM-образа
• Пакет docker pyhton использует сломанную python http-библиотеку, требуется понижение версии пакета.
• Использование виртуального окружения python, чтобы обойти блокировку python-пакетов в Ubuntu.
• Добавлен параметр загрузки, позволяющий совместно использовать systemd между контейнерами и VM.
• Перенаправление сообщений об ошибках от сломанной утилиты tar при обновлениях.
• Поломка обновления Ubuntu для пакетов msc (см. update-ubuntu.sh) для VM версии 18
• Команда docker-compose сломана, используйте "docker compose"
• Принудительная установка прав на сокет в headless labtainers.
• Обновление headless Labtainers для использования Ubuntu 24

27 ноября 2023

• Добавлена опция Google Cloud Platform для ubuntu22 на машине ec2.

18 сентября 2023

• Предыдущая реализация исправления была ошибочной.

8 августа 2023

• Обработка изменения формата json образов DockerHub. Спасибо, Kees!

17 апреля 2023

• Принудительное использование последней версии лаборатории, например, iptables2 вместо iptables. Исправлено автодополнение по Tab, чтобы отображалась только последняя версия. (Issue #77)
• Установка лаборатории CyberCIEGE падала из-за состояния гонки X11. (Issue #76)
• Примечание в readme CyberCIEGE, чтобы направить студентов сохранять собранные логи в каталог $HOME. (Issue #75)
• Проверка работы лаборатории Radius некорректно сообщала "radiusd not running", отсутствовал скрипт prestop. (Issue #74)
• Labedit повреждал файл начальной конфигурации при использовании опции MACVLAN_EXT. (Issue #73)

1 февраля 2023

• История Bash для пользователей, отличных от пользователя по умолчанию, не сохранялась. 26 января 2023
• Изменены скрипты powershell для gcloud, чтобы использовать выбранную зону для уточнения имён VM. 4 января 2023
• Контейнеры, использующие systemd, падали на более новом systemd, присутствующем в Ubuntu 22
• Добавлен параметр --zone в скрипты google cloud, значение берётся из скрипта set_defaults. 21 декабря 2022
• Исправлены критерии результатов xforge, чтобы не ожидать pathname, и добавлена проверка, был ли отправлен POST для редактирования профиля. Также исправлен http-сервер атакующего для запуска из домашнего каталога. 19 декабря 2022
• Добавлена лаборатория strace для знакомства с трассировкой системных вызовов.
• Значение X11 DISPLAY было некорректным при наличии нескольких устройств в каталоге /tmp/.X11-unix.
• Использование python/bash/sh/etc без аргументов приводило к падению capinout. 9 декабря 2022
• Изменён скрипт создания Azure vm, чтобы использовать предварительно собранный образ Labtainer VM из Azure Community Gallery.
• Терминалы на облачных VM падают по неизвестным причинам во время запуска или при щелчке правой кнопкой мыши по терминалу. Попытка решить проблему путём запуска/остановки терминала. 5 декабря 2022
• При сборе артефактов включать изменённые файлы из каталогов пользователей, отличных от пользователя по умолчанию, например, их истории bash.
• Изменена веб-оценка для отображения новых файлов "other user".
• Включать файлы из .local/bin в каждом контейнере в артефакты. Предназначено для предоставления их инструктору через веб-оценку.
• В лаборатории ACL включить файл /shared_data/bob/fun в результаты для справки инструктором.
• Перехватывать использование "sh" или "bash" из командной строки и пропускать при разборе заданной команды, например, как это делается с "time" или "sudo".
• В лаборатории tcpip не удавалось выполнить ssh на сервер во время последующих сессий лаборатории, каталог /run/sshd не создавался заново. 16 ноября 2022
• Исправлен путь к Snort Manual в лаборатории snort.
• В руководстве ossec исправлен путь к manage_agents 12 октября 2022
• Google cloud: удалён фоновый оператор из команды gnome-terminal, всё ещё падает при щелчке правой кнопкой, но, похоже, стабильно работает после запуска newterm.sh. 10 октября 2022
• Исправлен Google cloud newterm.sh; расширен загрузочный диск до 30G. 20 сентября 2022
• Указаны идентификатор пользователя и пароль для лаборатории TCP/IP в руководстве лаборатории. 30 августа 2022
• Использовать имя сокета X11 при установке DISPLAY из .profile контейнера 9 августа 2022
• Исправлено имя функции processValueMax в grader. Issue #63

4 августа 2022

• Программа labedit была пересобрана с неправильным JDK, что не позволяло старым JRE запускать labedit

18 июля 2022

• Создание контейнеров на базе Ubuntu20 падало внутри IModules. Issue #61.

23 марта 2022

• Исправлен путь к каталогу блокировки tap; это вызывало сбой лабораторий, использующих сетевые taps
• Обновлён компьютер plc-traffic netmon, чтобы иметь openjfx, необходимый для нового grassmarlin в java-окружении
• Ускорен запуск лаборатории за счёт отказа от chown -R, который очень медленный в docker.
• Ещё одна попытка избежать удаления ссылки X11 в каталоге /tmp контейнера.
• Исправлен подсчёт посещённых сайтов в webtrack и удалена цель live-headers, этот инструмент больше недоступен. Уточнены некоторые шаги руководства лаборатории.

2 марта 2022

• Добавлена новая лаборатория ssh-tunnel (спасибо GWD!)
• Исправлен сбой labedit, связанный с отражением значения X11, установленного new_lab_setup
• Добавлена опция не параметризовать контейнер

23 февраля 2022

• labedit повреждал start.config после добавления новых контейнеров
• Некорректный путь к руководству студента в файле README для студентов; динамическое изменение для облачных конфигураций
• Некорректное расширение в update-labtainer.sh
• Улучшения руководства Msc
• Обновлена лаборатория ghidra для включения версии 10.1.2 Ghidra

15 февраля 2022

• Возврат поддержки Azure cloud к провижинингу для каждого студента. Azure не поощряет совместное использование ресурсов.

24 января 2022

• Azure cloud теперь использует образ, хранящийся в Azure blob, вместо провижининга для каждого студента.
• Добавлена поддержка Google Cloud.

19 января 2022

• Представлены Labtainers в облаке Azure. Подробности использования см. в Student Guide.

3 января 2022

• Переработана лаборатория setuid-env для добавления лучшей оценки; тестирование simlab и предотвращение sighup в дочернем процессе printenv.
• Исправлена директива подсчёта целей оценки, чтобы исключать значения тега результата false.
• Не требовать labname при использовании gradelab -a с grader, запущенным с опцией debug.
• Переработан capinout (зеркалирование stdin/stdout) для обработки осиротения дочерних процессов команды, улучшена документация и обработка ошибок.
• Добавлено отображение индикаторов прогресса загрузки образов docker при первом запуске лаборатории.
• Обратная связь с пользователем о прогрессе инициализации контейнера.
• В лаборатории pcap-lib отсутствовал файл notify, необходимый для автоматизированной оценки; Удалён лишний шаг из Lab Manual.

23 ноября 2021

• Отключены всплывающие ошибки ubuntu на тестовой VM.
• Исправлена обработка различных форматов переменной DISPLAY.

22 октября 2021

• Переработано руководство лаборатории tcpip, чтобы отметить, что успешная syn-flood атака невозможна. Исправлена её автоматизированная оценка и добавлены скрипты SimLab.
• Изменено расширение файла артефакта с zip на lab, и добавлена преамбула, чтобы запутать GUI-файловые менеджеры. Студенты открывали zip и отправляли его содержимое.
• Опция -r для gradelab сделана по умолчанию, добавлена опция -c для кумулятивного использования grader.
• Изменён refresh_mirror, чтобы ссылаться на локальную дату выпуска и избежать частых запросов к DockerHub. Каждый такой запрос считается загрузкой образа, а они теперь пытаются монетизировать это.

30 сентября 2021

• Изменено руководство и оценка лаборатории bufoverflow, чтобы не ожидать успеха при включённом ASLR, оценивается, была ли она запущена.
• Обработка ошибок для веб-grader в случаях, когда у студента отсутствуют результаты.
• Вывод предупреждения при запуске устаревшей лаборатории.
• Изменена оценка formatstring для удаления неиспользуемого описания "_leaked_secret" и уточнения значения leaked_no_scanf.
• Также изменена оценка formatstring, чтобы разрешить любое имя для уязвимого исполняемого файла.

29 сентября 2021

• Обработка ошибок Gradelab, сокращение случаев падения из-за плохих zip-файлов.
• Ограничение файлов артефактов stdout до 1MB

17 сентября 2021

• В руководстве лаборатории Ghidra был неправильный IP-адрес, она не была пересобрана из исходников.

14 сентября 2021

• Примеры лабораторий для LDAP и Mariadb с использованием SSL. Предназначены как шаблоны для новых лабораторий.
• Обработка формата логов Mariadb
• Добавлены параметры для каждого контейнера для ограничения использования CPU или привязки контейнера к набору CPU.
• Создание Labpack теперь доступно через GUI (makepackui).
• Автодополнение по Tab для команд labtainer, labpack и gradelab.
• Новая лаборатория параллельных вычислений ``parallel'' с использованием MPI.

3 августа 2021

• Добавлена опция конфигурации "WAIT_FOR", заставляющая контейнер отложить параметризацию до завершения параметризации другим контейнером.
• Поддержка форматов логов Mariadb при разборе результатов
• Удалена поддержка использования Docker Desktop на Mac и Windows. Этот продукт слишком нестабилен для нашей поддержки.
• Подавление сообщений stderr, когда пользователь использует встроенные команды bash, такие как "which".
• Исправления ошибок в программах makepack/labpack.

19 июля 2021

• Добавлена лаборатория DNS для знакомства с протоколом и конфигурацией DNS.
• Переработан образ VirtualBox appliance, чтобы запускаться с правильным скриптом обновления.
• Параметр nameserver из resolv.conf вынесен из поля конфигурации lab_gw в отдельное значение.
• Команда IModule падала, если запускалась до запуска каких-либо лабораторий.

5 июля 2021

• Ошибки в управлении переменной окружения DISPLAY ломали GUI-приложения на Docker Desktop.

1 июля 2021

• Поддержка установки пакета headless Labtainers на Mac.
• Автоматизированная оценка лаборатории routing-basics падала из-за отсутствия файлов treataslocal
• Исправлены опечатки и неправильные адреса в лаборатории routing-basics, и исправлена автоматизированная оценка.
• Оценка pcapanalysis падала.

10 июня 2021

• Все PDF-руководства лабораторий теперь находятся в репозитории github
• Инструкции vpnlab и vpnlab2 преобразованы в PDF-руководства лабораторий.

25 мая 2021

• Добавлены ключевые слова для поиска в каждую лабораторию. Использование см. в "labtainer -h".
• Расширена лаборатория routing-basics и руководство лаборатории
• Удалена лаборатория routing-basics2, теперь она избыточна.
• sudo на некоторых контейнерах падал, потому что имена хостов удаляют подчёркивания, что приводило к несоответствию с файлом hosts. Исправлено дополнительной записью в файле hosts с именем контейнера без подчёркивания.
• Новая функция Labpack для упаковки коллекции лабораторий и инструмент makepack для создания Labpacks.
• Проверка ошибок для каталога /sbin при использовании ubuntu20 -- иначе это было бы молчаливым фатальным сбоем.
• Новая лаборатория network-basics

5 мая 2021

• Представлена новая лаборатория users для знакомства с управлением пользователями/группами
• Подавление сообщений хоста Apparmor в syslog контейнера centos

28 апреля 2021

• В новых образах base2 отсутствовали man-страницы. Использован unminimize для их восстановления в базовом образе.
• Представлена лаборатория OSSEC host-based IDS.

13 апреля 2021

• Лаборатория CyberCIEGE падала, потому что сокет X11 не был перемещён до запуска Wine через fixlocal.

9 апреля 2021

• Новая обучающая лаборатория gdb-cpp для использования GDB на простой программе на C++.
• Исключения с плавающей точкой раскрывали использование exec_wrap.sh для зеркалирования stdin/stdout.

7 апреля 2021

• Лаборатория ldap падала при переносе на Ubuntu 20. Проблема прослежена до проблемы с кэшем pwd в nscd. Лаборатория ldap перенесена на Ubuntu 20

23 марта 2021

• Параметризация с RANDOM не включала верхнюю границу.
• Добавлен необязательный параметр шага в RANDOM, например, для обеспечения границ слов.
• Лаборатория db-access: добавлен mysql-workbench на компьютер базы данных.
• Новая лаборатория overrun для иллюстрации обращений к памяти за пределами границ структур данных c.
• Новая лаборатория printf для знакомства с обращениями к памяти, выполняемыми функцией printf.

19 марта 2021

• gradelab игнорирует ошибку makdirs, проблема с Windows rmtree на общих папках.
• gradelab обрабатывает пробелы в именах zip-файлов студентов.
• gradelab обрабатывает имена zip-файлов из Moodle, включая загрузки сборок.

12 марта 2021

• UI labedit: Удалён старый образ wireshark из списка базовых образов.
• UI labedit: Увеличены некоторые размеры шрифтов.
• Веб-интерфейс grader не отображал руководства лабораторий, если имя руководства не соответствует соглашениям об именовании.

11 марта 2021

• UI labedit: добавлена настройка registry в новой глобальной панели конфигурации лаборатории.

10 марта 2021

• Исправления UI labedit, чтобы не собирать при синтаксической ошибке в лаборатории
• Исправление индикатора "Lab running" в UI labedit для отражения текущей лаборатории.

8 марта 2021

• Устаревшее использование HOST_HOME_XFER, все лаборатории используют каталог согласно файлу labtainer.config.
• Добавлен комментарий с документацией к start.config для REGISTRY и BASE_REGISTRY

5 марта 2021

• Обработка ошибок в веб-интерфейсе gradelab при отсутствии результатов.
• Добавление precheck в labedit, исправления ошибок msc.

26 февраля 2021

• В лаборатории dmz-example были ошибки в маршрутизации и настройке dnsmasq на некоторых компонентах.

18 февраля 2021

• UI пересобирал образы, потому что обновлял времена файлов без причины
• Очистка кода UI для удаления некоторых избыточных копий данных.

14 февраля 2021

• Добавлена опция локальной сборки в UI
• Создан пустой faux_init для баз centos6.

11 февраля 2021

• Исправлена обработка редактирования файлов в UI. Переработан макет и удалены неиспользуемые поля.
• Добавлена базовая конфигурация ubuntu20 base2 вместе с ssh2, network2 и wireshark2
• Новый wireshark решает проблему чёрных/шумных окон.
• Отображение /tmp/.X11-unix на /var/tmp и создание ссылки. Необходимо для ubuntu20 (удалялся /tmp?) и может исправить другие.

4 февраля 2021

• Добавлена опция SIZE для артефактов результатов
• Упрощена оценка и параметризация wireshark-intro и добавлено PDF-руководство лаборатории.
• Предоставление значений списка параметров скрипту pregrade.sh в виде переменных окружения
• включение X11 на grader
• помещение update-designer.sh в путь пользователя.

19 января 2021

• Изменено управление датой/ревизией README для обновления файла в исходном репозитории.
• Представлен GUI для создания/редактирования лабораторий -- см. команду labedit.

21 декабря 2020

• Функция gradelab падала, когда zip-файлы копировались из общей папки VirtualBox.
• Обновлён Instructor Guide для описания управления zip-файлами студентов на хост-компьютерах.

4 декабря 2020

• Переход распространения tar на артефакты релизов GitHub
• Удалён отдельный tar-файл designer, используется tarball git-репозитория.
• Тестирование веб-функций grader для анализа артефактов студенческих лабораторий
• Очистка логов от полного smoketest и удаление контейнера grader в команде removelab.

1 декабря 2020

• Оценка лаборатории iptables2 полагалась на то, что случайные порты "unknown" для nmap.
• Использование каталога sync для задержки запуска smoketests до запуска лаборатории.
• Начало интеграции элементов UI Lab designer.

13 октября 2020

• Headless-конфигурации для работы на Docker Desktop на Mac и Windows
• Поддержка headless-сервера, файл cloud-config для облачных развёртываний
• Поддержка тестирования headless-конфигураций
• Принудительное ожидание mynotify до запуска rc.local при загрузке
• Улучшение способности службы mynotify объединять вывод в единую временную метку
• Python3 для скрипта stopgrade
• SimLab теперь использует docker top вместо системного ps

26 сентября 2020

• Очистка скриптов stoplab для игнорирования контейнеров, не относящихся к лабораториям
• Добавлена лаборатория контроля доступа к базе данных db-access для контролируемого совместного использования mysql db.

17 сентября 2020

• Лаборатория macs-hash не могла запустить Leafpad из-за настройки X11.
• Логирование Grader перенаправлялось в неправильный лог-файл, теперь захватывает ошибки из instructor.py
• Копирование instructor.log из grader в каталог логов хоста при наличии ошибки.

28 августа 2020

• Исправлен скрипт установки для использования python3-pip и исправлены сломанные скрипты: getinfo.py и pull-all.py
• Логика Registry была сломана, тестовые системы не использовали тестовый registry, добавлена документация по разработке.
• Добавлены базовые файлы juiceshop и owasp для лабораторий веб-безопасности на основе OWASP
• Удалены ненужные sudos из check_nets
• Добавлена директива документации CHECK_OK для автоматизированной оценки
• Изменён check_nets для исправления проблем с iptables и маршрутизацией, если так указано.

12 августа 2020

• Добавлен таймаут в скрипты prestop
• Добавлены quiz и checkwork в dmz-lab
• Перезапуск dmz-lab без опции -r ломал маршрутизацию из ISP.
• Разрешение нескольких файлов для результатов time_delim.6 августа 2020 г.
• Ошибка в обработке ошибок при отсутствии сокета X11
• Запятые в вопросах викторины приводили к ошибкам синтаксического анализа
• Добавлены викторина и checkwork в лабораторию iptables2

28 июля 2020 г.

• Добавлена поддержка викторин -- это обучающие викторины, а не оценочные. См. руководство для разработчика.
• Добавлена оценка текущего состояния для использования с командой checkwork.

21 июля 2020 г.

• Добавлен testsets/bin в путь разработчика
• Исправления и пояснения в руководстве разработчика для шагов IModule.
• Добавлен тип результата RANGE_REGEX для определения временных диапазонов с использованием регулярных выражений на записях журнала.
• Проверка наличия сокета X11, если он необходим при запуске лаборатории.
• Добавлен базовый образ для mysql
• Обработка форматов временных меток журнала mysql при разборе результатов.

15 июня 2020 г.

• Новый базовый образ, содержащий открытый маршрутизатор Bird
• Добавлена лаборатория bird-bgp по протоколу граничного шлюза (Border Gateway Protocol).
• Добавлен bird-ospf -- протокол маршрутизации OSPF (Open Shortest Path First).
• Улучшена обработка изменений DNS, внешний доступ из некоторых контейнеров был заблокирован на некоторых сайтах.
• Добавлен раздел в руководство инструктора по использованию Labtainers в средах без доступа к Интернету.

21 мая 2020 г.

• Все репозитории перемещены в реестр labtainers на Docker Hub
• Поддержка монтирований, определённых в start.config, для обеспечения постоянной установки программного обеспечения
• Лаборатория ida изменена для использования постоянной установки IDA -- новое имя ida2
• Добавлена лаборатория cgc для исследования более 200 уязвимых сервисов из DARPA Cyber Grand Challenge
• Добавлена команда type_string в SimLab
• Добавлена лаборатория netflow для использования анализа сетевого трафика NetFlow
• Добавлены 64-битные версии лабораторий bufoverflow и formatstring

9 апреля 2020 г.

• Оценщик не проходил оценку условий CONTAINS и FILE_REGX при использовании подстановочных знаков для выбора файлов.
• Добавлены подсказки по использованию hexedit в лаборатории symlab.
• Добавлен оператор hash_equal и hash-goals.py в автоматизированную оценку, чтобы избежать публикации ожидаемых ответов в файлах конфигурации.
• Автоматизированная оценка для лаборатории pcap-lib.

7 апреля 2020 г.

• Журналы перемещены в $LABTAINER_DIR/logs
• Прочие исправления для обеспечения пересборок и тестов с использованием Jenkins, включая использование уникальных временных каталогов для сборок
• Функции поддержки сборки перемещены из labutils в build.py
• Добавлена лаборатория pcap-lib для разработки программ анализа трафика на основе библиотеки PCAP

13 марта 2020 г.

• Добавлена лаборатория plc-traffic для использования GrassMarlin с трафиком, генерируемым во время лаборатории.
• Введена возможность добавления "tap"-контейнеров для сбора PCAP из выбранных сетей.
• Обновлена документация GNS3 для внешнего доступа к контейнерам и использования dummy_hcd для имитации USB-накопителей.
• Шаблон kali изменён для использования faux_init вместо попыток использования systemd.
• Перемещение дистрибутивов (tar-файлов) на box.com
• Изменено использование netstat в SimLab, чтобы не выполнять поиск в DNS.

26 февраля 2020 г.

• Если команда labtainer не находит лабораторию, предлагается запустить update-labtainer.sh
• Добавлена предварительная поддержка компонента сетевого ответвления (network tap) для просмотра всего сетевого трафика.
• Скрипт для загрузки образов лабораторий для подготовки виртуальных машин, которые будут использоваться без Интернета.
• Предоставлены имя пользователя и пароль для лаборатории nmap-discovery.

18 февраля 2020 г.

• Переменная окружения DISPLAY наследуется от хоста (например, виртуальной машины) вместо предположения :0

14 февраля 2020 г.

• Добавлено вводное упражнение по обратной разработке программного обеспечения с помощью Ghidra.

11 февраля 2020 г.

• Обновлены руководства с описанием удалённого доступа к контейнерам в средах GNS3
• Скрытие выбранных компонентов и связей в GNS3.
• Рисунки в руководстве лаборатории webtrack не были видны; опечатки в этом руководстве и в nmap-ssh

6 февраля 2020 г.

• Введена функция удалённого управления контейнерами, например, отправка файлов.
• Добавлена функция среды GNS3 для имитации подключения USB-накопителя.
• Улучшена обработка ошибок сборки Docker.

3 февраля 2020 г.

• В лаборатории metasploit служба postgresql не работала на жертве.
• Содержимое руководства IModule объединено с руководством Lab Designer.
• Дополнительная поддержка IModule.

27 января 2020 г.

• Введена начальная поддержка IModules (лаборатории, разработанные инструктором). См. docs/imodules.pdf.
• Исправлена сломанная переменная окружения LABTAINER_DIR в update-labtainer
• Исправлен режим доступа к файлу accounting.txt в лаборатории ACL (стал rw-r-r). Используется явный chmod в fixlocal.sh.

14 января 2020 г.

• Фреймворк и gradelab портированы на Python3 (существующие лаборатории на Python2 не изменятся)
  • Использование обратно совместимых опций random.seed
  • Обход несовместимого randint для возврата старых значений
  • Продолжение поддержки python2 для платформ, где нет python3 (или таких, как старый VM-образ, включающий python 3.5.2, что нарушает совместимость random.seed).
  • Добавлен псевдоним rebuild для rebuild.py, который выберет python2 при необходимости.
• Лаборатории на базе Centos: страницы руководства не работали; используется mandb в базовом docker-файле
• Маска подсети dmz-lab для сети DMZ была неверной (обнаружено python3); как и IP-адрес внутреннего шлюза в руководстве лаборатории
• ghex удалён из лабораторий centos -- больше не поддерживается легко в centos 7
• Лаборатория file-deletion должна быть выполнена без перезагрузки виртуальной машины, отмечено в руководстве лаборатории.
• Добавлен переключатель NO_GW в start.config для отключения шлюзов по умолчанию на контейнерах.
• Лаборатория Metasploit: вызывает сбой хост-виртуальной машины при запуске с привилегиями; длительные задержки при su, если включён systemd; поэтому запускается без systemd. Удалено использование базы данных из руководства лаборатории, настроено использование нового переключателя no_gw
• Обновлены заголовки файлов для лицензирования/условий; добавлен объединённый файл лицензии.
• Изменён publish.py для использования по умолчанию тестового реестра, используйте -d для принудительного использования default_registry
• Пересмотрены процедуры контроля версий для использования отдельного тестового реестра для каждой ветки и использования ветки premaster для финального тестирования релиза.

9 октября 2019 г.

• Удалён dnsmasq из компонента dns в dmz-lab. Вызывал сбой bind на некоторых установках.

8 октября 2019 г.

• Синтаксическая ошибка в настройке тестового реестра; информация для разработчика лабораторий о больших файлах; загрузка файлов bigexternal.txt

30 сентября 2019 г.

• Получение из реестра DockerHub снова не удаётся у некоторых пользователей. Игнорируется html-префикс к json.

20 сентября 2019 г.

• Оценка onewayhash должна допускать операции hmac над файлом по выбору студента.

5 сентября 2019 г.

• Пересборка лаборатории metasploit, metasploit-framework проявлял ошибку. И файл "treataslocal" лабораторий был пропущен при переносе из svn. Исправлена опечатка в руководстве лаборатории metasploit.

30 августа 2019 г.

• Отменена проверка существования каталогов контейнеров, они не всегда существуют.

29 августа 2019 г.

• Загрузка образов лабораторий из docker hub не удалась из-за изменения в github или curl? Перехват перенаправления на cloudflare. Добавление поддержки GNS3. Исправление dnssec в dmz-lab.

11 июля 2019 г.

• Автоматизированная оценка для контейнеров CentOS6, исправление проблемы с памятью firefox, поддержка произвольных аргументов docker create в файле start.config.

6 июня 2019 г.

• Введена база Centos6, но пока без поддержки автоматизированной оценки

23 мая 2019 г.

• Автоматизированная оценка setuid-env не удалась из-за опечаток в разделителях полей.

8 мая 2019 г.

• Исправления в руководстве лаборатории Capabilities

2 мая 2019 г.

• Исправление прав доступа к bobstuff.txt в лаборатории Acl. Используется явный chmod в fixlocal.sh
• Пересмотрено руководство студента для уточнения использования stop и опции -r в тексте руководства.

9 марта 2019 г.

• Функция checkwork повторно использовала контейнеры, тем самым не позволяя студентам устранять артефакты от предыдущей лабораторной работы.
• Добавлено приложение к лаборатории symkey с описанием формата изображений BMP.

22 февраля 2019 г.

• HTTP-сервер не запускался в лабораториях vpn и vpn2. Автоматизированная оценка удалена из этих лабораторий до переработки.

7 января 2019 г.

• Исправлена автоматизированная оценка gdblesson, чтобы она хотя бы работала.

27 января 2019 г.

• Исправлено руководство лаборатории routing-basics2 и исправлена маршрутизация для обеспечения внешнего доступа к внутреннему веб-серверу.

29 декабря 2018 г.

• Исправлена routing-basics2, те же проблемы, что и в routing-basics, плюс неверный IP-адрес в resolv.conf шлюза

5 декабря 2018 г.

• Исправлена лаборатория routing-basics, разрешение DNS на компонентах isp и gatway было нарушено.

14 ноября 2018 г.

• Удалён /run/nologin с машины archive в backups2 -- нужно общее решение этой проблемы с nologin

5 ноября 2018 г.

• Изменена конфигурация aid.conf по умолчанию в лаборатории file-integrity для отслеживания изменений метаданных, а не времени модификации файлов

22 октября 2018 г.

• Разрешение verydodgy.com в лаборатории macs-hash не удалось при перезапуске лаборатории
• Функция Notify не сработала, если notify_cb.sh отсутствует

12 октября 2018 г.

• Установлен ulimit на размер файла, ограничение 1G

10 октября 2018 г.

• Принудительный сбор параметризованных файлов
• Явное включение leafpad и ghex в базовую конфигурацию centos-xtra и пересборка зависимых образов.

28 сентября 2018 г.

• Исправлены режимы доступа к общему файлу в лаборатории ACL
• Уточнён вопрос в pass-crack
• Изменён сбор артефактов для игнорирования файлов старше начала лаборатории.
• Добавлена лаборатория алгоритмов квантовых вычислений

12 сентября 2018 г.

• Исправлены синтаксические ошибки оценки setuid-env
• Исправлена синтаксическая ошибка в примерах правил брандмауэра iptables2
• Пересборка лабораторий centos, производные lamp переведены на использование lamp.xtr для waitparam и принудительного ожидания httpd завершения этого процесса.

7 сентября 2018 г.

• Добавлен CyberCIEGE в качестве лаборатории
• Отображение информации read_pre.txt перед загрузкой образов и возможность отказаться.

5 сентября 2018 г.

• Восстановлена обработка массовой загрузки sakai в функции gradelab.
• Удалены неиспользуемые скрипты инструктора.

4 сентября 2018 г.

• Разрешено несколько IP-адресов на сетевой интерфейс
• Добавлен базовый образ для Wine
• Добавлена виртуальная симуляция ICS GRFICS

23 августа 2018 г.

• Добавлена лаборатория GrassMarlin (обнаружение сетей ICS)

23 августа 2018 г.

• Добавлена лаборатория GrassMarlin (обнаружение сетей ICS)

21 августа 2018 г.

• Ещё одно исправление проблем аутентификации AWS (DockerHub использует AWS).
• Исправлен new_lab_setup.py для использования git вместо svn.
• Лаборатория plc-forensics разделена на базовую и продвинутую (plc-forensics-adv)

17 августа 2018 г.

• Переход на git и GitHub в качестве авторитетного репозитория.

15 августа 2018 г.

• Изменена оценка лаборатории plc-forensics для большей универсальности; пересмотрено руководство лаборатории для отражения wireshark на Labtainer.

15 августа 2018 г.

• Добавлена команда "checkwork", позволяющая студентам просматривать результаты автоматизированной оценки их лабораторной работы.
• Включено журналирование отбрасывания пакетов iptables в лабораториях iptables2 и iptables-ics.
• Удалены устаревшие экземпляры is_true и is_false из goal.config
• Исправлена логическая оценка для обработки "NOT foo", ожидалось больше операндов.

9 августа 2018 г.

• Поддержка замены параметров в файлах results.config
• Добавлен тип результата TIME_DELIM для results.config
• Переработана лаборатория iptables, удалены скрытые команды nmap, введена пользовательская служба

7 августа 2018 г.

• Добавлена ссылка на руководство студента в каталоге labtainer-student
• Добавлена ссылка на руководство студента на рабочих столах виртуальных машин
• Исправления в iptables-ics для избежания длительной задержки при завершении; и исправления регрессионных тестов
• Добавлено примечание в руководства, предлагающее студентам использовать браузер виртуальной машины для передачи zip-файла артефактов инструктору.

1 августа 2018 г.

• Использование универсального образа Docker для автоматизированной оценки; прекращено создание образов "instructor" для каждой лаборатории.

30 июля 2018 г.

• Документирована необходимость разблокировки waitparam.service (путём создания каталога флага) если скрипт fixlocal.sh должен запустить службу, для которой waitparam является предварительным условием.
• Добавлена лаборатория plc-app для упражнения по брандмауэру и белым спискам приложений PLC.

25 июля 2018 г.

• Добавлен оператор string_contains в обработку целей
• Изменена оценка лаборатории formatstring для учёта утечки секрета, который не всегда находится в конце отображаемой строки.

24 июля 2018 г.

• Добавлена лаборатория SSH Agent (ssh-agent)

20 июля 2018 г.

• Поддержка офлайн-сборки, опциональный пропуск всей загрузки образов
• Восстановлено восстановление репозиториев apt/yum в шаблонах Dockerfile.
• Обработка URL перенаправления при получении blob из реестра Docker для избежания ошибок аутентификации (не полагаться на curl --location).

12 июля 2018 г.

• Добавлена функция prestop для выполнения заданных разработчиком скриптов на выбранных компонентах перед завершением лаборатории.
• Исправлено именование хостов в лаборатории ssl, это нарушало автоматизированную оценку.
• Исправлено начальное состояние dmz-lab для разрешения DNS-запросов из внутренней сети.
• Обработка FILE\REGEX неправильно обрабатывала многострочные поиски.
• Версия фреймворка, полученная из недавно пересобранных образов, имела неверное значение по умолчанию.

10 июля 2018 г.

• Добавлена лаборатория LDAP
• Завершён переход на образы Ubuntu на основе systemd, удалены неиспользуемые файлы
• Перемещён tar-файл lab_sys в отдельный временный каталог каждого контейнера для параллелизма.

6 июля 2018 г.

• Все базовые образы Ubuntu заменены версиями на основе systemd
• Образы контейнеров Labtainer в реестре теперь помечены ID базового образа и имеют метки, отражающие базовый образ.
• Данная установка будет загружать и использовать образы, совместимые с имеющимися у неё базовыми образами.
• Если вы используете образ виртуальной машины, возможно, вы захотите заменить его более новым образом виртуальной машины с нашего сайта.
• Новые лаборатории не будут работать без загрузки более новых базовых образов; что может привести к хранению вашей виртуальной машиной нескольких версий больших базовых образов (> 500 МБ каждый).
• Терялись артефакты от процессов, которые выполнялись при остановке лаборатории -- процессы capinout не завершались должным образом.

27 июня 2018 г.

• Добавлена поддержка образов Ubuntu systemd
• Удалена старая копия SimLab.py из labtainer-student/bin
• Источники apt и yum перемещены в /var/tmp
• Уточнены различия между использованием "boolean" и "count_greater" в оценках
• Расширена Add-HOST в start.config для включения всех компонентов в сети.
• Добавлена опция в new_lab_setup.py для добавления контейнера на основе копии существующего контейнера.

21 июня 2018 г.

• Установлена переменная окружения DISPLAY для root
• Исправлена обработка зависимостей сборки при выводе статуса svn
• Добавлена лаборатория radius
• Исправлена ошибка в append в SimLab
• Использование svn, где это уместно, для изменения имён файлов с помощью new_lab_setup.py

19 июня 2018 г.

• Сохранён порядок контейнеров, определённых в start.conf, при создании терминала с несколькими вкладками
• Уточнено руководство разработчика для указания пути к файлам конфигурации оценки.
• Удалён запрос инструктору предоставить email
• Испорчена проверка ошибок при тестировании номера версии
• Включены временные метки запусков лабораторий и повторных запусков в json оценки
• Добавлена лаборатория SSL, включающая двустороннюю аутентификацию и создание сертификатов.

14 июня 2018 г.

• Добавлена диагностика параметризации, выяснение причины, почему некоторые установки, похоже, терпят неудачу на этом.
• Если контейнер уже создан, убедиться, что он параметризован, иначе прервать работу, чтобы избежать повреждённых или недоделанных контейнеров.
• Исправлен номер версии программы для использования svn HEAD

15 июня 2018 г.

• Преобразование инструкций в виде простого текста, появлявшихся в xterms, в pdf-файл.
• Исправлена ошибка в обработке версий образов, которые ещё не были загружены.
• Обнаружение появления контейнера, который был создан, но не параметризован, и предложение пользователю перезапустить лабораторию с опцией "-r".
• Добавлена утилита разработчика: rm_svn.py, чтобы удалённые файлы вызывали пересборку образа.

13 июня 2018 г.

• Установка xterm в системах Ubuntu 18
• Обход поломки в новых версиях обработки вкладок gnome-terminal

11 июня 2018 г.

• Добавлена проверка версий для сравнения образов с фреймворком.
• Уточнены различные руководства лабораторий

2 июня 2018 г.

• При установке на Ubuntu 18 используется docker.io вместо docker-ce
• capinout вызывал сбой, когда за отслеживаемой командой "sudo su" следует команда непривилегированного пользователя.
• Настройки маршрутизации и resolv.conf перемещены в /etc/rc.local вместо fixlocal.sh, чтобы они сохранялись между запусками и остановками контейнеров.

31 мая 2018 г.

• Обход ошибки Docker, вызывавшей перенос текста в терминале без перевода строки.
• Расширена COMMAND_COUNT для учёта конвейеров
• Создана новая версия лаборатории backups, включающая резервное копирование на удалённый сервер и резервное копирование всего раздела.
• Изменены инструкции sshlab для использования утилиты ssh-copy-id
• Удалён файл /run/nologin из parameterize.sh для разрешения входа по ssh на CentOS

30 мая 2018 г.

• Расширен new_lab_setup.py для возможности определения используемого базового образа
• Создана новая версия centos-log, включающая централизованное журналирование.
• Проверка оценки не принимала опцию "time_not_during".
• Начата интеграция Labtainer Master для управления Labtainers из контейнера Docker.

25 мая 2018 г.

• Удалены 10-секундные задержки из различных служб. Это задерживало ответы xinetd, нарушая автоматизированные тесты.
• Исправлена оценка лаборатории snort, чтобы требовалось только "CONFIDENTIAL" в оповещении. Удалены неиспользуемые файлы из лаборатории.
• Время завершения программы не записывалось, если программа выполнялась при остановке лаборатории.

21 мая 2018 г.

• Исправлена оценка retlibc для удаления дублирующейся цели, она не проходила автоматизированную оценку
• Удалены копии mynotify.py из отдельных лабораторий и шаблона лаборатории, он был частью lab_sys/sbin, но не был обновлён для отражения исправлений, сделанных для лаборатории acl.

18 мая 2018 г.

• Маскировка сигнального сообщения от exec_wrap, чтобы сообщение об ошибке segv выглядело правильно.
• capinout иногда терял stdout, проверка stdout команды при завершении cmd.
• Исправлена оценка formatstring для перехвата сообщения о segmentation fault.
• Добавлена функция type_function в SimLab для ввода stdout скрипта (см. formatstring simlab).
• Удалено ограничение SimLab на комбинирование одинарных/двойных кавычек.
• Добавлена директива window_wait в SimLab для паузы до тех пор, пока окно с заданным заголовком не будет найдено.
• Изменена лаборатория plc для изменения заголовков на терминале физического мира для отражения статуса, это также облегчает тестирование.
• Исправлена ссылка в руководстве лаборатории bufoverflow.

15 мая 2018 г.

• Добавлено приложение об использовании инструмента SimLab для имитации выполнения лабораторий пользователем для регрессионного тестирования и разработки лабораторий.
• Добавлена функция wait_net в SimLab для паузы до завершения выбранных сетевых соединений.
• Изменена автоматизированная оценка acl для использования FILE_REGEX для многострочного сопоставления.
• Тест SimLab для лаборатории xsite.

11 мая 2018 г.

• Добавлен файл "noskip" для принудительного сбора файлов, иначе находящихся в home.tar, необходим для извлечения Firefox places.sqlite.
• Объединение базы данных sqlite с буфером упреждающей записи перед извлечением.
• Исправления в руководстве лаборатории symkeylab
• Дополнения к оценке для symkeylab и pubkey
• Улучшения инструмента simlab: поддержка include, исправление именования окон.

9 мая 2018 г.

• Исправлена параметризация лаборатории file-deletion. Исправлена ошибка в её руководстве.
• Замена использования shell=True в скриптах python для уменьшения числа процессов и возможности отслеживания PID
• Очистка руководств для backups, pass-crack и macs-hash.

8 мая 2018 г.

• Обработка состояния гонки для предотвращения выполнения gnome-terminal своей команды docker до того, как терминал инструкций xterm выполнит свою команду.
• Не отображать ошибки, когда инструктор останавливает лабораторию, запущенную с "-d".
• Изменена оценка nmap-ssh для лучшего отражения цели лаборатории.
• Несколько исправлений документации и скриптов, предложенных olberger на github.

7 мая 2018 г.

• Использование программы capinout на основе C вместо старого capinout.sh для захвата stdin и stdout. См. trunk/src-tool/capinout. Удалены ограничения, связанные с использованием ctrl-C для прерывания отслеживаемых программ и отображением паролей в telnet и ssh.
• Включена поддержка обработки zip-файлов массовой загрузки saki для извлечения отдельно отправленных отчётов и суммирования отсутствующих отправок.
• Добавлены проверки предоставленного пользователем email для обеспечения печатных символов.
• Во время оценки, если предоставленный пользователем email не совпадает с именем zip-файла, продолжить оценку результатов, но включить примечание в таблицу, отражающее списывание. Требуется для восстановления после случаев, когда студент вводит мусор в качестве адреса email.
• Изменена оценка telnetlab, чтобы не смотреть вывод tcpdump для паролей -- исправление capinout приводит к правильной передаче по одному символу за раз на сервер.
• Исправлена опечатка в install-docker.sh и использование sudo для изменения настройки docker dns в этом скрипте.

26 апреля 2018 г.

• Переход на использование "labtainer" для запуска лаборатории и "stoplab" для её остановки.
• Добавлена опция --version в команду labtainer.
• Добавлены типы результатов log_ts и log_range и операторы целей time_not_during. Переработана оценка centos-log и sys-log для использования этих функций.
• labsys.tar помещён в /var/tmp вместо /tmp, иногда удалялся до распаковки
• Запуск X-приложений от имени root не удаётся после перезагрузки виртуальной машины.
• Добавлены страницы руководства "User Command" в лаборатории на базе CentOS
• Исправлена недавняя ошибка, препятствовавшая сбору файлов docs у студентов
• Изменены smoke-тесты для сравнения только строки результата, специфичной для студента, без пробелов20 апреля 2018 г.
• Служба denyhosts не запускается с первого раза, запуск перенесён в student_startup.sh.
• Перенести все службы faux_init после параметризации -- rsyslog не запускался при второй загрузке контейнера. 19 апреля 2018 г.
• Лаборатория acl не смогла должным образом оценить выполнение шага с троянским конём.
• Собирать студенческие документы по умолчанию.
• Лаборатория denyhost изменилась, отражая тот факт, что denyhosts (или tcp wrappers?) теперь изменяет iptables. Кроме того, служба denyhosts в некоторых случаях не запускалась.
• При обновлении Labtainers не перезаписывать файлы, которые новее, чем в архиве -- сохранять студенческие отчёты по лабораториям.

12 апреля 2018 г.

• Добавить документацию о назначении целей лаборатории и отображать её инструктору, когда инструктор запускает лабораторию.
• Исправить использование функции precheck, когда программа находится в treataslocal, передавать capintout.sh полный путь к программе.
• Копировать файлы instr_config во время выполнения, а не во время сборки образа.
• Добавить раздел Designer Guide по отладке автоматизированной оценки.
• Неверный регистр в именах файлов отчётов по лабораториям.
• Ненужная функция chown иногда приводила к сбою instructor.py.
• Поддержка автоматизированного тестирования лабораторий (см. SimLab и smoketest).
• Переместить testsets и distrib в trunk

5 апреля 2018 г.

• Пересмотреть профиль Firefox, чтобы убрать сообщение "you've not use firefox in a while...".
• Убрать ненужные обращения к registry -- получать даты образов через API docker hub.

28 марта 2018 г.

• Использовать явный tar вместо "docker cp" для системных файлов (Docker не следует по ссылкам.)
• Исправить лабораторию backups: использовать отдельную файловую систему и обновить руководство.

26 марта 2018 г.

• Поддержка многопользовательских режимов (см. Lab Designer User Guide).
• Удалена зависимость сборки от файлов lab_bin и lab_sys. Теперь они копируются во время параметризации лаборатории.
• Переместить capinout.sh в /sbin, чтобы он находился при работе от имени root.

21 марта 2018 г.

• Добавить CLONE, чтобы разрешить несколько экземпляров одного и того же контейнера, например, для лабораторий, совместно используемых несколькими одновременными студентами.
• Адаптировать лабораторию kali-test, чтобы привести пример macvlan и CLONE
• Копировать скрипт capinout.sh в /sbin, чтобы root мог его найти после sudo su.

15 марта 2018 г.

• Поддержка сетей macvlan для связи с внешними хостами
• Добавить базовый образ Kali linux и образ Metasploitable 2 (см. kali-test)

8 марта 2018 г.

• Не требовать labname при использовании stop.py
• Перехватывать ошибки, вызванные посторонними сетями, и советовать пользователю, как исправить
• Добавить поддержку использования локальных репозиториев apt и yum в NPS

21 февраля 2018 г.

• Добавить dmz-lab
• Изменить "checklocal" на "precheck", отражая, что он выполняется перед командой.
• Развязать отчётность о событиях inotify и использование precheck.sh, позволить спискам событий inotify включать необязательное имя выходного файла.
• Расширить bash-хук на операции root, очищать этот bash_history.
• Разрешить параметризацию полей start.config, например, для случайных IP-адресов
• Поддержка мониторинга служб, запущенных через systemctl или /etc/init.d
• Ввести квалификаторы временных разделителей для организации файла журнала с отметками времени в диапазоны, разделённые некоторым интересующим изменением конфигурации (см. dmz-lab)

5 февраля 2018 г.

• Булевы значения из файлов results.config теперь рассматриваются как значения целей
• Добавить поддержку регулярных выражений для идентификации результатов артефактов.
• Поддержка альтернативных реестров Docker, включая локальный тестовый реестр для тестирования
• Различные исправления в лабораториях и руководствах к лабораториям
• Хук мониторинга capinout не убивал дочерние процессы при выходе.
• Убивать отслеживаемые процессы перед сбором артефактов
• Добавить labtainer.wireshark в качестве базового контейнера, очистить dockerfiles

30 января 2018 г.

• Добавить лабораторию snort
• Интегрировать отметки времени файлов журналов, например, из syslogs, в результаты с отметками времени.
• Удалить неопределённые значения результатов из промежуточных json-файлов результатов с отметками времени.
• Изменить операцию оценки цели time_during, чтобы связывать отметки времени с результирующим значением цели.

24 января 2018 г.

• Использование вкладок в окнах приводило к сбою на стороне инструктора, использование двойных кавычек.
• Игнорировать файлы в каталогах _tar (кроме .tar) при определении зависимостей сборки.