dwn 是“黑客的 docker-compose”。它使用类似 docker-compose 的简单 YAML “计划”格式，定义镜像名称、版本以及卷/端口映射，从而配置工具以供使用。
使用 dwn，你可以：
只需运行 pip3 install dwn。
dwn 实际上非常简单。核心概念是“计划”（plans），其中定义了工具的信息（如名称、版本、挂载和绑定）。已有若干内置计划，你也可以创建自己的计划。不带参数直接运行 dwn，效果如下。
❯ dwn
Usage: dwn [OPTIONS] COMMAND [ARGS]...
__
___/ / _____
/ _ / |/|/ / _ \
\_,_/|__,__/_//_/
docker pwn tool manager
by @leonjza / @sensepost
Options:
--debug enable debug logging
--help Show this message and exit.
Commands:
check Check plans and Docker environment
network Work with networks
plans Work with plans
run Run a plan
show Show running plans
stop Stop a plan
要列出可用的计划，运行 dwn plans show。
❯ dwn plans show
dwn plans
┏━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ name ┃ path ┃
┡━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ sqlmap │ /tools/dwn/plans/sqlmap.yml │
│ wpscan │ /tools/dwn/plans/wpscan.yml │
│ gowitness-report │ /tools/dwn/plans/gowitness-report.yml │
│ msfconsole │ /tools/dwn/plans/msfconsole.yml │
│ gowitness │ /tools/dwn/plans/gowitness.yml │
│ nginx │ /tools/dwn/plans/nginx.yml │
│ cme │ /tools/dwn/plans/cme.yml │
│ netcat-reverse │ /tools/dwn/plans/netcat-reverse.yml │
│ semgrep-sec │ /tools/dwn/plans/semgrep-sec.yml │
│ semgrep-ci │ ~/.dwn/plans/semgrep-ci.yml │
│ neo4j │ ~/.dwn/plans/neo4j.yml │
└──────────────────┴───────────────────────────────────────┘
11 plans
要运行一个计划，例如用 gowitness 截图 https://google.com，可以运行 dwn run gowitness --disable-db single https://www.google.com。该计划会在完成后退出，因此无需执行 dwn stop gowitness。
❯ dwn run gowitness --disable-db single https://www.google.com
(i) found plan for gowitness
(i) volume: ~/scratch -> /data
(i) streaming container logs
08 Feb 2021 10:46:18 INF preflight result statuscode=200 title=Google url=https://www.google.com
❯
❯ ls screenshots
https-www.google.com.png
然而，像 netcat-reverse 这样的计划会保持活跃。你可以在容器启动后连接到该计划的 TTY，与可能收到的任何 shell 进行交互。用法示例：
❯ dwn run netcat-reverse
(i) found plan for netcat-reverse
(i) port: 4444<-4444
(i) container booted! attach & detach commands are:
(i) attach: docker attach dwn_wghz_netcat-reverse
(i) detach: ctrl + p, ctrl + q
连接到该计划（并在其他地方执行 nc -e）
❯ docker attach dwn_wghz_netcat-reverse
connect to [::ffff:172.19.0.2]:4444 from dwn_wghz_netcat-reverse_net_4444_4444.dwn:46318 ([::ffff:172.19.0.3]:46318)
env | grep -i shell
SHELL=/bin/zsh
read escape sequence
你也可以获取正在运行的计划报告
❯ dwn show
running plan report
┏━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━┓
┃ plan ┃ container(s) ┃ port(s) ┃ volume(s) ┃
┡━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━┩
│ netcat-reverse │ dwn_wghz_netcat-reverse_net_4444_4444 │ 4444<-4444 │ │
│ │ dwn_wghz_netcat-reverse │ │ │
└────────────────┴───────────────────────────────────────┴────────────┴───────────┘
最后，停止一个计划。
❯ dwn stop netcat-reverse -y
(i) stopping 2 containers for plan netcat-reverse
dwn 允许你动态地将端口映射到计划，无需重启容器。网络命令位于 dwn network 子命令下。以 nginx 计划为例，我们可以动态添加端口映射。首先，启动 nginx 计划。
❯ dwn run nginx
(i) found plan for nginx
(i) volume: ~/scratch -> /usr/share/nginx/html
(i) port: 80<-8888
(i) container dwn_wghz_nginx started for plan nginx, detaching
然后，用 cURL 测试通信
❯ curl localhost:8888/poo.txt
haha, you touched it!
❯ curl localhost:9000/poo.txt
curl: (7) Failed to connect to localhost port 9000: Connection refused
端口 9000 未开放，因此我们添加一个新的端口绑定并测试连通性
❯ dwn network add nginx -i 80 -o 9000
(i) port binding for 9000->nginx:80 created
❯
❯ curl localhost:9000/poo.txt
haha, you touched it!
dwn plans pull 命令可用于更新计划中定义的 images。若只想更新单个计划，可在 pull 后添加计划名称，例如：dwn plans pull nginx。
dwn plans new 命令可快速生成新计划的脚手架。虽然只需少数几个选项即可让计划运行起来，但 Python Docker SDK 中 run 调用支持的所有选项都是有效的标签，都可以使用。
dwn 采用 GNU General Public v3 许可证。超出本许可证范围的权限，请访问 http://sensepost.com/contact/ 获取。