Labtainers

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

Дистрибутив создан: 01/06/2026 12:28
Ревизия: v1.4.4i
Коммит: 4f868e24
Ветка: 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 устанавливают переменные окружения, поэтому вы можете выйти из системы/войти снова или запустить новую оболочку bash перед первым использованием Labtainers.

6 января 2026 г.

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

30 декабря 2025 г.

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

15 октября 2025 г.

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

24 апреля 2025 г.

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

22 ноября 2024 г.

• Заменена облачная виртуальная машина Google Cloud, на этот раз из-за сбоя systemd внутри контейнеров.

23 сентября 2024 г.

• Заменена облачная виртуальная машина Google Cloud, которая использовала неправильную версию Docker

10 сентября 2024 г.

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

26 июля 2024 г.

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

22 июля 2024 г.

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

5 июля 2024 г.

• Переход на Ubuntu 24 в качестве виртуальной машины
• Пакет Docker python использует сломанную библиотеку http Python, требуется понижение версии пакета.
• Использование виртуального окружения Python для обхода блокировки пакетов Python в Ubuntu.
• Добавлен параметр загрузки для разрешения совместного использования systemd между контейнерами и виртуальной машиной.
• Перенаправление сообщений об ошибках от сломанной утилиты tar при обновлениях.
• Сбой обновления Ubuntu для пакетов msc (см. update-ubuntu.sh) для версий 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. Исправлено автодополнение по табуляции для отображения только последней версии. (Проблема #77)
• Установка лабораторной работы CyberCIEGE завершалась ошибкой из-за состояния гонки X11. (Проблема #76)
• Примечание в readme CyberCIEGE с указанием студентам сохранять собранные логи в домашней директории $HOME. (Проблема #75)
• Проверка лабораторной работы Radius некорректно сообщала "radiusd не запущен", отсутствовал скрипт prestop. (Проблема #74)
• Редактор labedit повредил файл конфигурации запуска при использовании опции MACVLAN_EXT. (Проблема #73)

1 февраля 2023 г.

• История bash для нестандартных пользователей не сохранялась. 26 января 2023 г.
• Изменены скрипты powershell для gcloud для использования выбранной зоны для указания имён виртуальных машин. 4 января 2023 г.
• Контейнеры, использующие systemd, выходили из строя на более новых версиях systemd, присутствующих в Ubuntu 22
• Добавлен параметр --zone в скрипты Google Cloud, со значением, полученным из скрипта set_defaults. 21 декабря 2022 г.
• Исправлены критерии xforge results, чтобы не требовалась информация о пути, и добавлена проверка, был ли выполнен POST для редактирования профиля. Также исправлен http-сервер атакующего для запуска из домашней директории. 19 декабря 2022 г.
• Добавлена лабораторная работа strace для знакомства с трассировкой системных вызовов.
• Значение DISPLAY X11 было неверным, если в каталоге /tmp/.X11-unix было несколько устройств.
• Использование python/bash/sh/etc без аргументов приводило к сбою capinout. 9 декабря 2022 г.
• Изменён скрипт создания виртуальной машины Azure для использования предварительно собранного образа виртуальной машины Labtainer из галереи сообщества Azure.
• Терминалы на облачных виртуальных машинах выходят из строя по неизвестным причинам во время запуска или при щелчке правой кнопкой мыши по терминалу. Попытка решения путём запуска/остановки терминала. 5 декабря 2022 г.
• При сборе артефактов включать изменённые файлы из каталогов нестандартных пользователей, например, их истории bash.
• Изменена веб-оценка для отображения новых файлов "other user".
• Включены файлы из .local/bin каждого контейнера в артефакты. Предназначено для предоставления инструктору через веб-оценку.
• В лабораторной работе ACL включён файл /shared_data/bob/fun в результаты для справки инструктора.
• При обнаружении "sh" или "bash" из командной строки пропускать их при разборе заданной команды, как это делается с "time" или "sudo".
• В лабораторной работе tcpip не удавалось выполнить ssh на сервер во время последующих сеансов, каталог /run/sshd не восстанавливался. 16 ноября 2022 г.
• Исправлен путь к руководству Snort в лабораторной работе 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. Проблема #63

4 августа 2022 г.

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

18 июля 2022 г.

• Создание контейнеров на основе Ubuntu20 завершалось сбоем внутри IModules. Проблема #61.

23 марта 2022 г.

• Исправлен путь к каталогу блокировки tap; вызывал сбой лабораторных работ, использующих сетевые tap
• Обновлён компьютер netmon в plc-traffic для наличия 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 с предоставлением ресурсов для каждого студента. Azure не рекомендует совместное использование ресурсов.

24 января 2022 г.

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

19 января 2022 г.

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

3 января 2022 г.

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

23 ноября 2021 г.

• Отключены всплывающие ошибки Ubuntu на тестовой виртуальной машине.
• Исправлена обработка различных форматов переменной 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 до 1 МБ

17 сентября 2021 г.

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

14 сентября 2021 г.

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

3 августа 2021 г.

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

19 июля 2021 г.

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

5 июля 2021 г.

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

1 июля 2021 г.

• Поддержка установки headless Labtainers на macOS через пакеты.
• Автоматическая оценка лабораторной работы 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 для создания Labpack.
• Проверка ошибок для каталога /sbin при использовании ubuntu20 — ранее приводила к молчаливой фатальной ошибке.
• Новая лабораторная работа network-basics

5 мая 2021 г.

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

28 апреля 2021 г.

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

13 апреля 2021 г.

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

9 апреля 2021 г.

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

7 апреля 2021 г.

• Лабораторная работа ldap не работала после перехода на Ubuntu 20. Проблема связана с кешем nscd для pwd. Переход на 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: добавлена настройка реестра в новую панель глобальной конфигурации лабораторной работы.

10 марта 2021 г.

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

4 февраля 2021 г.

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

19 января 2021 г.

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

21 декабря 2020 г.

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

4 декабря 2020 г.

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

1 декабря 2020 г.

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

13 октября 2020 г.

• Headless-конфигурации для запуска на Docker Desktop на Mac и Windows
• Поддержка headless-сервера, файл cloud-config для облачных развёртываний
• Тестовая поддержка headless-конфигураций
• Принудительное ожидание mynotify до выполнения rc.local при загрузке
• Улучшение службы mynotify для объединения вывода в одну временную метку
• Python3 для скрипта stopgrade
• SimLab теперь использует docker top вместо system 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
• Логика реестра была сломана, тестовые системы не использовали тестовый реестр, добавлена документация разработчика.
• Добавлены базовые файлы juiceshop и owasp для лабораторных работ по веб-безопасности на основе OWASP
• Удалены лишние sudo из check_nets
• Добавлена директива документации CHECK_OK для автоматической оценки
• Изменён check_nets для исправления проблем iptables и маршрутизации, если это указано.

12 августа 2020 г.

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

28 июля 2020

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

21 июля 2020

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

15 июня 2020

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

21 мая 2020

• Перемещены все репозитории в реестр Docker Hub labtainers
• Поддержка точек монтирования, определенных в 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
• Добавлена предварительная поддержка компонента сетевого 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 объединено в руководство разработчика лабораторных работ.
• Дополнительная поддержка IModule.

27 января 2020

• Внедрена начальная поддержка IModule (лабораторные работы, разработанные преподавателем). См. 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 (или тех, например, старая ВМ с версией 3.5.2, которая нарушает совместимость random.seed).
  • Добавлен псевдоним rebuild для rebuild.py, который при необходимости выберет python2.
• Страницы руководств для лабораторных работ на основе Centos не работали; используется mandb в базовом Docker-файле
• Маска подсети для сети DMZ в dmz-lab была неправильной (обнаружено 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

• Исправление в лабораторной работе Acl прав доступа к bobstuff.txt. Использован явный 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 и gateway было нарушено.

14 ноября 2018

• Удаление /run/nologin из архивной машины в backups2 — требуется общее решение для этой проблемы nologin

5 ноября 2018

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

22 октября 2018

• Разрешение verydodgy.com в лабораторной работе macs-hash не работало после перезапуска лабораторной работы
• Функция уведомления не работала при отсутствии 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
• Добавление имитации виртуальной системы управления GRFICS ICS

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 для упражнения по брандмауэру приложений ПЛК и белому списку.

25 июля 2018

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

24 июля 2018

• Добавление лабораторной работы по SSH-агенту (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 env для root
• Исправление обработки зависимостей сборки вывода svn status
• Добавление лабораторной работы radius
• Ошибка в SimLab append исправлена
• Использование svn, где это уместно, для изменения имен файлов с помощью new_lab_setup.py

19 июня 2018

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

14 июня 2018

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

15 июня 2018

• Преобразование текстовых инструкций в формате plain text, отображавшихся в xterm, в 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 для управления Labtainer'ами из Docker-контейнера.

25 мая 2018

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

21 мая 2018

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

18 мая 2018

• Маскирование сигнального сообщения от exec_wrap, чтобы сообщение об ошибке segv выглядело правильно.
• Capinout иногда терял stdout, при смерти команды проверять stdout команды.
• Исправление оценки 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, необходимого для получения places.sqlite Firefox.
• Объединение базы данных 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-файлов массовой загрузки Sakai для извлечения отдельно представленных отчетов и суммирования пропущенных отправлений.
• Добавление проверок электронной почты, предоставленной пользователем, чтобы убедиться, что это печатаемые символы.
• При оценивании, если предоставленный пользователем адрес электронной почты не совпадает с именем zip-файла, продолжить оценивание результатов, но включить примечание в таблицу, отражающее обман. Требовать восстановления в случаях, когда студент вводит мусор для адреса электронной почты.
• Изменение оценивания telnetlab для игнорирования вывода tcpdump в поисках паролей — исправление capinout приводит к правильной посимвольной передаче на сервер.
• Исправление опечатки в install-docker.sh и использование sudo для изменения настройки DNS docker в этом скрипте.

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.
• Исправление недавней ошибки, препятствовавшей сбору файлов документации от студентов.
• Изменение 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 во время выполнения, а не при сборке образа.
• Добавлен раздел в руководство разработчика по отладке автоматизированной оценки.
• Неверный регистр в именах файлов отчетов.
• Ненужная функция chown приводила к сбоям instructor.py.
• Поддержка автоматизированного тестирования лабораторных работ (см. SimLab и smoketest).
• Перенос testsets и distrib в trunk.

5 апреля 2018 года

• Изменён профиль Firefox для удаления сообщения «вы давно не использовали Firefox...».
• Удалены ненужные извлечения из реестра — получение дат образов через API Docker Hub.

28 марта 2018 года

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

26 марта 2018 года

• Поддержка многопользовательских режимов (см. руководство разработчика).
• Удалена зависимость сборки от файлов 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 года

• Не требовать имя лабораторной работы при использовании 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 как базовый контейнер, очищены Dockerfile.

30 января 2018 года

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

24 января 2018 года

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