DockerSecurityPlayground

Docker Security Playground — это приложение, которое позволяет:

• Создавать сценарии для изучения сетей и сетевой безопасности, чтобы понимать сетевые протоколы, правила и проблемы безопасности, установив DSP на свой ПК.
• Изучать техники тестирования на проникновение путём симуляции лабораторных сценариев с уязвимостями.
• Управлять набором docker-compose проектов. Основная цель DSP — обучение тестированию на проникновение и сетевой безопасности, но его гибкость позволяет создавать, графически редактировать и управлять (запуск/остановка) всех ваших лабораторных docker-compose проектов.

Установка

Рекомендуемый способ установки DSP — использование виртуальной машины Kali:

• Установите docker и docker-compose
• Установите последнюю стабильную версию nodejs
• Установите dsp

Ниже приведены шаги по установке DSP на виртуальной машине Kali. Выполните аналогичные шаги для других дистрибутивов Linux, но убедитесь, что все требования установлены.

1. Установите требования DSP:

sudo apt update && sudo apt install -y docker.io docker-compose nodejs npm git

Примечание (проблема с ключом Kali в 2025 году).

Если во время установки возникла следующая проблема:

root@kitploit:~

Fetched 34.0 kB in 1s (58.4 kB/s)
Warning: Failed to fetch http://http.kali.org/kali/dists/kali-rolling/InRelease  The following signatures couldn't be verified because the public key is not available: NO_PUBKEY ED65462EC8D5E4C5
Warning: Some index files failed to download. They have been ignored, or old ones used instead.

Вам нужно добавить недостающий ключ:

root@kitploit:~

wget https://http.kali.org/kali/pool/main/k/kali-archive-keyring/kali-archive-keyring_2025.1_all.deb
sudo dpkg -i kali-archive-keyring_2025.1_all.deb
rm kali-archive-keyring_2025.1_all.deb

2. Включите автозапуск docker при загрузке и настройте текущего пользователя на использование docker без sudo:

sudo systemctl enable docker
sudo groupadd docker
sudo usermod -aG docker $USER

3. Выйдите и снова войдите в систему (это необходимо, чтобы текущий пользователь мог использовать docker без sudo) и проверьте, что вы можете использовать docker без sudo:

docker ps

Также проверьте, что docker compose работает:

docker compose --version # или docker-compose --version для старых версий

Также проверьте установку npm и nodejs:

node -v
npm -v

Примечание для пользователей macOS M1

Вы можете запустить DSP на хосте M1, включив Rosetta, но я настоятельно рекомендую создать виртуальную машину Kali с помощью UTM или VMware Fusion, выполнить предыдущие шаги установки и установить пакет binfmt-misc для запуска образов x86 на архитектуре ARM.

sudo apt install binfmt-support qemu-user-static

Перезагрузите машину.

Затем используйте контейнер Tonisiigi, чтобы зарегистрировать все интерпретаторы для разных архитектур:

docker run --privileged --rm tonistiigi/binfmt --install amd64

Убедитесь, что образы docker могут работать на вашей машине:

docker run --rm -it --platform linux/amd64 ubuntu uname -m

4. Теперь вы можете установить DSP:

git clone https://github.com/DockerSecurityPlayground/DSP.git 
cd DSP 
npm install

Когда установка завершена, вы можете запустить DSP:

npm start

DSP будет запущен по адресу "http://localhost:18181".

Примечание по использованию Wireshark на Kali: рекомендую использовать браузер chromium, так как контейнер wireshark использует некоторые кодеки, которые не поддерживаются Firefox на Kali. Вы можете запустить chromium, просто введя "chromium" в терминале.

Первым шагом будет установка всех необходимых папок на текущей машине.

Вы также можете автоматизировать этот шаг установки с помощью переменной окружения:

export DSP_AUTOINSTALL=1 && npm start

Запуск DSP в виртуальной машине — экспонирование на интерфейсе 0.0.0.0

Если вы хотите использовать браузер хост-машины, вы можете экспонировать на интерфейсе 0.0.0.0. Если вы хотите экспонировать на другом интерфейсе, измените переменную окружения DSP_IFACE:

export DSP_IFACE="0.0.0.0"

Теперь вы можете использовать DSP на удалённом интерфейсе.

Очистка DSP

Если что-то пошло не так, вы можете сбросить DSP до заводских настроек с помощью следующей команды:

npm run uninstall

Это удалит всё, и вы сможете начать установку DSP заново.

Официальный репозиторий

DSP_Repo содержит официальные лабораторные работы DSP. Внесите свой вклад в DSP, создавая новые лабораторные работы.

Как я могу поделиться своими лабораторными работами с миром?

Во время установки вы можете создать локальное окружение, не связанное с git, или привязать к приложению личный репозиторий. Это очень удобно, если вы хотите поделиться своей работой с другими людьми. Репозиторий DSP должен соответствовать определённым требованиям, поэтому я создал базовый шаблон репозитория DSP, который вы можете использовать для создания своего личного репозитория. Самый простой способ поделиться лабораторными работами следующий:

1. Сделайте форк проекта NS-Unina: https://github.com/NS-unina/DSP_Repo.git
2. Во время установки укажите параметр каталога github, указывающий на ваш форкнутый репозиторий.
3. Теперь создавайте свои лабораторные работы и делитесь ими!

Важно, чтобы все используемые вами образы были доступны другим пользователям, поэтому:

• Вы можете опубликовать их на docker hub, чтобы другие пользователи могли загрузить ваши образы и использовать ваши лабораторные работы.
• Вы можете предоставить docker-файлы в каталоге .docker-images, чтобы пользователи могли использовать build.sh для сборки ваших образов и использования вашего репозитория.

Если вам нужен «частный способ» обмена лабораторными работами, вы должны делиться репозиторием другими способами; на данный момент нет поддержки обмена частными репозиториями.

В DSP вы можете управлять несколькими репозиториями пользователей (вкладка «Репозитории»).

Возможности DSP

• Графический редактор docker-compose
• Управление образами Docker и Dockerfile
• Интеграция с GIT
• Репозиторий DSP с набором сценариев для сетевой безопасности

Есть вопросы?

Если у вас возникла проблема, используйте раздел Issues.

Тесты

Для запуска теста:

mocha test/<test-nodejs-file.js>

Тесты используют метод helper.start() для инициализации тестового окружения:

• Создаётся тестовая конфигурация
• Каталог homedir имитируется, что позволяет использовать внутренний каталог dsp для тестов.

Устранение неполадок

Во время установки DSP

Если во время установки возникла следующая ошибка:

[2020-12-14T10:18:21.854Z]  INFO: DockerSecurityPlayground/1536 on vagrant: [DOCKER ACTIONS - DOWNLOAD IMAGE]
events.js:174
      throw er; // Unhandled 'error' event
      ^

Error: connect EACCES /var/run/docker.sock
    at PipeConnectWrap.afterConnect [as oncomplete] (net.js:1107:14)
Emitted 'error' event at:
    at Socket.socketErrorListener (_http_client.js:401:9)
    at Socket.emit (events.js:198:13)
    at emitErrorNT (internal/streams/destroy.js:91:8)
    at emitErrorAndCloseNT (internal/streams/destroy.js:59:3)
    at process._tickCallback (internal/process/next_tick.js:63:19)

Проверьте две вещи:

1. docker установлен
2. текущий пользователь находится в группе docker

Для проверки:

docker ps

НЕ ИСПОЛЬЗУЙТЕ SUDO, если вы запускаете DSP от обычного пользователя. Если вы получили следующую ошибку:

vagrant@vagrant:~/git/DockerSecurityPlayground$ docker ps
Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Get http://%2Fvar%2Frun%2Fdocker.sock/v1.24/containers/json: dial unix /var/run/docker.sock: connect: permission denied

Вам нужно добавить своего пользователя в группу docker: https://docs.docker.com/engine/install/linux-postinstall/

$ sudo groupadd docker
$ sudo usermod -aG docker $USER

Выйдите и снова войдите.

Теперь вам нужно очистить DSP:

npm run uninstall

И теперь всё должно работать.

Ошибка на macOS

Ошибка ECONNRESET на macOS:

events.js:183
      throw er; // Unhandled 'error' event
      ^

Error: read ECONNRESET
    at _errnoException (util.js:992:11)
    at TCP.onread (net.js:618:25)

На Mac, похоже, есть проблема с некоторым пакетом node, поэтому для её решения выполните:

MacBook-Pro:DockerSecurityPlayground gaetanoperrone$ npm install [email protected] --save-dev --save-exact

Другая информация здесь: http://gitlab.comics.unina.it/NS-Thesis/DockerSecurityPlayground_1/wikis/docker-operation-errors

Внесение вклада

1. Сделайте форк!
2. Создайте свою ветку для функции: git checkout -b my-new-feature
3. Зафиксируйте изменения: git commit -am 'Add some feature'
4. Отправьте в ветку: git push origin my-new-feature
5. Отправьте pull request, мы проверим.

Есть вопросы?

Используйте Issues, чтобы задать всё, что хотите!

Ссылки

• 
• https://github.com/NS-unina/DSP_Repo.git : Репозиторий, созданный для курса сетевой безопасности Саймона Пьетро Романо в Университете Неаполя имени Федерико II

Участники

Спасибо Giuseppe Criscuolo и Alessandro Placido Luise за дизайн логотипа.

Журнал изменений

Перейдите в CHANGELOG.md, чтобы увидеть все изменения версий.

Цитирование этой работы

Если вы используете Docker Security Playground в своей исследовательской деятельности, процитируйте следующую статью, опубликованную IEEE (Institute of Electrical and Electronics Engineers): https://ieeexplore.ieee.org/document/8169747

@INPROCEEDINGS{8169747,
  author={Perrone, G. and Romano, S. P.},
  booktitle={2017 Principles, Systems and Applications of IP Telecommunications (IPTComm)}, 
  title={The Docker Security Playground: A hands-on approach to the study of network security}, 
  year={2017},
  volume={},
  number={},
  pages={1-8},
  keywords={Security;Communication networks;Tools;Containers;Virtualization;Standards},
  doi={10.1109/IPTCOMM.2017.8169747}}

Лицензия

Этот проект находится под лицензией MIT.