DockerSecurityPlayground

Docker Security Playground 是一款应用程序，允许您：

• 创建网络和网络安全场景，以便通过在自己的 PC 上安装 DSP 来理解网络协议、规则和安全问题。
• 通过模拟漏洞实验室场景学习渗透测试技术
• 管理一组 docker-compose 项目。DSP 的主要目标是学习渗透测试和网络安全，但其灵活性允许您创建、图形编辑和管理运行/停止所有的docker-compose 实验室。

安装

推荐的 DSP 安装工作流程是使用 Kali 虚拟机：

• 安装 docker 和 docker-compose
• 安装最新的稳定版 nodejs
• 安装 dsp

以下是在 Kali 虚拟机上安装 DSP 的步骤。其他 Linux 发行版请遵循类似步骤，但请确保安装所有依赖项。

1. 安装 DSP 依赖项：

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

注意（2025 年 Kali 密钥环问题）。

如果在安装过程中遇到以下问题：

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 开机自启并配置当前用户无需 sudo 即可使用 Docker：

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

3. 注销并重新登录（这是让当前用户无需 sudo 使用 Docker 所必需的），然后验证您可以在没有 sudo 的情况下使用 Docker：

docker ps

此外，验证 docker compose 是否正常工作：

docker compose --version # 或旧版本的 docker-compose --version

同时验证 npm 和 nodejs 的安装：

node -v
npm -v

macOS M1 用户注意事项

可以通过启用 Rosetta 在 M1 主机上运行 DSP，但我强烈建议使用 UTM 或 VMware Fusion 创建一个 Kali 虚拟机，然后按照之前的安装步骤操作，并安装 binfmt-misc 软件包以在 ARM 架构上运行 x86 镜像。

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”上运行。

在 Kali 上使用 Wireshark 的注意事项：我建议使用 Chromium 浏览器，因为 Wireshark 容器使用了一些 Kali 上 Firefox 不支持的编解码器。您只需在终端中输入“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 实验室为 DSP 做出贡献。

如何与世界分享我的实验室？

在安装过程中，您可以创建一个不与 git 关联的本地环境，或者将个人仓库与应用程序关联。这对于与他人分享您的工作非常有用。 DSP 仓库必须满足若干要求，因此我创建了一个基本的 DSP 仓库模板，您可以用它来创建个人仓库。 因此，分享实验室的最简单方法如下：

1. Fork NS-Unina 项目：https://github.com/NS-unina/DSP_Repo.git
2. 在安装过程中，将 github 目录参数设置为您 fork 的仓库。
3. 现在创建您的实验室并分享它！

重要的是，您使用的所有镜像应对其他用户可用，因此：

• 您可以在 Docker Hub 上发布，以便其他用户拉取您的镜像来使用您的实验室。
• 您可以在 .docker-images 目录中提供 dockerfile，以便用户使用 build.sh 构建您的镜像并使用您的仓库。

如果您需要“私有方式”分享实验室，您应该以其他方式分享仓库，目前不支持分享私有仓库。

在 DSP 中，您可以管理多个用户仓库（“仓库”选项卡）。

DSP 特性

• docker-compose 图形编辑器
• Docker 镜像和 Dockerfile 管理
• GIT 集成
• 包含一组网络安全场景的 DSP 仓库

有问题吗？

如果您遇到问题，可以使用 Issue 板块。

测试

运行测试：

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

如果以普通用户运行 DSP，请勿使用 sudo。 如果出现以下错误：

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 错误

MacOS ECONNRESET 错误：

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. Fork 它！
2. 创建您的特性分支：git checkout -b my-new-feature
3. 提交您的更改：git commit -am 'Add some feature'
4. 推送到分支：git push origin my-new-feature
5. 提交拉取请求，我们会检查。

有问题吗？

请使用 Issues 来询问您想问的一切！

链接

• 
• https://github.com/NS-unina/DSP_Repo.git ：为那不勒斯费德里科二世大学 Simon Pietro Romano 教授的网络课程创建的仓库

贡献者

感谢 Giuseppe Criscuolo 和 Alessandro Placido Luise 设计徽标。

变更日志

请前往 CHANGELOG.md 查看所有版本更改。

引用本作品

如果您在研究活动中使用了 Docker Security Playground，请引用 IEEE（电气和电子工程师协会）发表的以下论文： 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 许可证。