DVWA(Damn Vulnerable Web Application)完整部署指南:从配置到故障排查实战
DVWA(Damn Vulnerable Web Application)完整部署指南:从配置到故障排查实战
导读
本文以 DVWA 项目的葡萄牙语文档(README.pt.md)为骨架,系统梳理这个 PHP/MySQL 极脆弱 Web 应用(Damn Vulnerable Web Application, DVWA)的完整部署流程,覆盖 Windows + XAMPP、Debian 系 Linux、Docker 三种安装路径,逐一讲解 config.inc.php 核心配置项、数据库初始化、认证禁用、reCAPTCHA 与 PHP 运行参数,并给出全套数据库连接错误(#1045/#1044/#2002/#2054)的定位与修复方案,最后深入 SQLite3 SQL 注入靶场切换原理。读完本文,你将能够在受控环境中独立完成 DVWA 的安装、配置与常见故障排解。
一、项目定位与安全警告
DVWA 是一个故意制造大量漏洞的 PHP/MySQL(推荐 MariaDB)Web 应用。它的设计目标(见 README.pt.md)是:
- 帮助安全专业人员在一个合法环境中测试自己的技能与工具;
- 帮助 Web 开发者更好地理解 Web 应用的安全加固过程;
- 帮助师生在受控的课堂环境中学习 Web 应用安全。
DVWA 通过简单直观的界面,让使用者以多种难度等级(low / medium / high / impossible)练习最常见的 Web 漏洞。文档特别强调:软件中存在已记录和未记录的漏洞,这是有意为之,官方鼓励使用者尽可能多地自行发现这些问题。
⚠️ 强制警告
DVWA 极度脆弱!切勿将其上传到托管商 public html 目录或任何面向公网的服务器,否则必然被攻陷。官方建议:
- 使用虚拟机(如 VirtualBox / VMware),并将网络模式设置为 NAT;
- 在虚拟机内安装 XAMPP 作为 Web 服务器与数据库环境。
免责声明
项目方不承担任何人对 DVWA 的使用方式所引发的责任,并明确禁止恶意使用。如果 Web 服务器因安装 DVWA 而被入侵,责任在于安装者本人。
二、获取 DVWA 源码
官方只支持 GitHub 官方仓库的最新源码(而非某个历史版本)。获取方式:
git clone https://github.com/digininja/DVWA.git
也可以直接下载 ZIP 压缩包。当前仓库根目录即为完整源码,其中与本文强相关的关键文件包括:
- config/config.inc.php.dist:配置文件模板;
- compose.yml:Docker Compose 编排;
- setup.php:数据库初始化与安装自检脚本;
- database/sqli.db 与 database/sqli.db.dist:SQLite3 注入靶场数据库;
- dvwa/includes/dvwaPage.inc.php:页面与数据库连接的公共逻辑。
三、安装与部署
3.1 安装视频参考
葡萄牙语文档给出了三条官方演示视频(YouTube):Kali + VirtualBox 安装、Windows + XAMPP 安装、Windows 10 安装 DVWA。其中 Windows 流程对其他操作系统同样具有参考价值。
3.2 Windows + XAMPP 方式
若尚无 Web 服务器环境,最简单的方式是安装 XAMPP。XAMPP 是一个极易安装的 Apache 发行包,支持 Linux、Solaris、Windows 和 Mac OS X,内置 Apache Web 服务器、MySQL、PHP、Perl、FTP 服务器与 phpMyAdmin。
Windows 下安装 DVWA 的一个常见坑是文件扩展名被隐藏,导致无法把配置文件从 .dist 重命名/复制为 .php。可先开启 Windows 的"显示文件扩展名"功能再操作。
3.3 Debian 系 Linux 包安装
如果使用 Debian 系发行版(如 Debian、Ubuntu、Kali),需要安装以下软件包(或其等价物):
- apache2
- libapache2-mod-php
- mariadb-server
- mariadb-client
- php、php-mysqli
- php-gd
建议先执行 apt update 以确保获取最新版本,然后一键安装:
apt update
apt install -y apache2 mariadb-server mariadb-client php php-mysqli php-gd libapache2-mod-php
文档明确指出:站点虽可运行在 MySQL 上,但强烈推荐 MariaDB,因为它开箱即用、无需额外调整。
四、核心配置文件详解
DVWA 自带一份模拟配置文件模板,必须将其复制为实际生效的配置文件:
cp config/config.inc.php.dist config/config.inc.php
4.1 数据库连接参数(默认值)
配置文件的数据库变量默认如下(必须与实际数据库中的凭据一致):
$_DVWA[ 'db_server'] = '127.0.0.1';
$_DVWA[ 'db_port'] = '3306';
$_DVWA[ 'db_user' ] = 'dvwa';
$_DVWA[ 'db_password' ] = 'p@ssw0rd';
$_DVWA[ 'db_database' ] = 'dvwa';
对照 config/config.inc.php.dist 源码,各变量含义与取值说明为:
| 变量 | 默认值 | 说明 |
|---|---|---|
db_server |
127.0.0.1 |
数据库主机;连接 MySQL 出问题时可尝试从 localhost 改为 127.0.0.1(规避 socket 问题) |
db_port |
3306 |
数据库端口 |
db_user |
dvwa |
数据库专用用户(MariaDB 下不能使用 root) |
db_password |
p@ssw0rd |
数据库密码 |
db_database |
dvwa |
数据库名;注意:setup 过程中该库会被整体清空重建,请使用专用数据库 |
此外该文件还包含 default_security_level(默认 impossible,可设为 low/medium/high/impossible)、default_locale(默认 en,可设为 zh)、disable_authentication(默认 false)以及 reCAPTCHA 密钥项。所有配置项都支持同名环境变量覆盖(见 getenv(...) ?: 默认值 写法),例如 DB_SERVER、DB_USER、DB_PASSWORD、DB_PORT、DB_DATABASE、DEFAULT_SECURITY_LEVEL、DISABLE_AUTHENTICATION、RECAPTCHA_PUBLIC_KEY 等,这为 Docker/Kubernetes 部署提供了不重建镜像即可改配置的途径。
4.2 数据库初始化(Create / Reset Database)
数据库配置完成后,只需在主菜单点击 Setup DVWA 按钮,再点击 Create / Reset Database 按钮,系统就会自动创建/重置数据库并写入初始数据。此逻辑在 setup.php 中实现:提交表单时校验 CSRF token 后,依据 $DBMS 常量加载 dvwa/includes/DBMS/MySQL.php 执行建库脚本;同时该页面还会展示安装自检结果(PHP 版本、allow_url_include/allow_url_fopen、mod_rewrite、上传目录可写性、数据库连接参数等)。
若创建数据库时报错,请先检查 ./config/config.inc.php 中的凭据是否正确——注意它不同于 config.inc.php.dist 示例文件。
4.3 MariaDB 下创建专用数据库用户
如果使用 MariaDB(Kali 默认)而非 MySQL,不能使用数据库 root 用户,必须新建专用用户。以 root 身份连入数据库后执行:
mysql> create database dvwa;
Query OK, 1 row affected (0.00 sec)
mysql> create user dvwa@localhost identified by 'p@ssw0rd';
Query OK, 0 rows affected (0.01 sec)
mysql> grant all on dvwa.* to dvwa@localhost;
Query OK, 0 rows affected (0.01 sec)
mysql> flush privileges;
Query OK, 0 rows affected (0.00 sec)
4.4 禁用认证(供自动化工具使用)
部分安全工具无法配合登录认证与 Cookie 使用。为此配置文件中提供开关,将以下值设为 true 即可跳过认证检查:
$_DVWA[ 'disable_authentication' ] = true;
同时还需设置一个适合你测试场景的安全等级:
$_DVWA[ 'default_security_level' ] = 'low';
在该状态下,无需登录、无需设置 Cookie 即可访问全部功能模块。
4.5 其他配置项
目录权限(葡萄牙语文档列出两条,需确保 Web 服务可写):
./hackable/uploads/—— 需 Web 服务可写(用于文件上传模块);./external/phpids/0.6/lib/IDS/tmp/phpids_log.txt—— 若想使用 PHPIDS,需 Web 服务可写(注:当前仓库源码中该 PHPIDS 目录已不再随发行包提供,若需此能力请以官方仓库历史版本为准)。
PHP 配置(按操作系统与 PHP 版本调整,位置因机器而异):
- 允许远程文件包含(RFI):
allow_url_include = onallow_url_fopen = on
- 可选降低输出冗长性(隐藏 PHP 警告信息):
display_errors = off
reCAPTCHA 密钥(仅"Insecure CAPTCHA"模块需要):
在 config/config.inc.php 中设置:
$_DVWA[ 'recaptcha_public_key' ]$_DVWA[ 'recaptcha_private_key' ]
这两组值需要在 Google reCAPTCHA 管理后台创建站点时生成。
4.6 默认凭据
- 默认用户名 =
admin - 默认密码 =
password
(文档调侃道:很容易被暴力破解 ;))
登录地址:http://127.0.0.1/login.php(若安装到其他目录则 URL 相应变化)。注意 DVWA 刻意使用弱默认凭据,这正是弱口令/暴力破解等课程模块的练习素材。
五、Docker 容器部署
葡萄牙语文档收录的 Docker 支持由社区维护者提供(@thegrims 编写、@opsxcq 维护镜像),传统用法是:
docker run --rm -it -p 80:80 vulnerables/web-dvwa
当时文档特别提示:请确保 Docker 使用 aufs 存储驱动(因历史 MySQL 问题),可通过 docker info 查看存储驱动。
需要说明的是,当前仓库已演进为基于 compose.yml 的官方编排方案:DVWA 服务监听 127.0.0.1:4280:80(即容器内 80 映射到宿主机 4280),数据库使用 mariadb:10,并预置了 MYSQL_DATABASE=dvwa、MYSQL_USER=dvwa、MYSQL_PASSWORD=p@ssw0rd 等环境变量。启动方式:
docker compose up -d
启动后访问 http://localhost:4280。若想用环境变量覆盖默认安全等级(如改为 low),可在 compose.yml 的 services 下追加:
environment:
- DB_SERVER=db
- DEFAULT_SECURITY_LEVEL=low
六、故障排查实战手册
以下排查步骤假设你处于 Debian 系发行版(Debian/Ubuntu/Kali),其他发行版请替换对应命令。
6.1 访问站点得到 404
需理解 Apache 文档根目录(默认 /var/www/html)的文件定位逻辑:
/var/www/html/hello.txt→http://localhost/hello.txt/var/www/html/mydir/hello.txt→http://localhost/mydir/hello.txt
Linux 默认区分大小写,以下访问都会得到 404 Not Found:
http://localhost/MyDir/hello.txthttp://localhost/mydir/Hello.txthttp://localhost/MYDIR/hello.txt
对应到 DVWA:大多数人用 git 克隆到 /var/www/html,得到 /var/www/html/DVWA/ 目录。此时访问 http://localhost/ 会得到 404 或 Apache 默认欢迎页,必须访问 http://localhost/DVWA;另一个常见错误是访问 http://localhost/dvwa(小写)同样 404。排查思路:确认文件相对文档根目录的位置,以及目录名的大小写是否完全一致。
6.2 运行 setup 时提示 "Access denied"
若出现以下错误,说明配置文件中的用户名或密码与数据库中的不一致:
Database Error #1045: Access denied for user 'notdvwa'@'localhost' (using password: YES).
该信息提示你当前使用的是用户名 notdvwa。
若出现下面这个错误,则说明配置文件指向了错误的数据库:
SQL: Access denied for user 'dvwa'@'localhost' to database 'notdvwa'
意思是使用用户 dvwa 尝试连接数据库 notdvwa。
排查步骤:
- 核对
config/config.inc.php中实际写入的内容; - 在命令行验证能否以该用户登录(注意
-p后无空格):
mysql -u dvwa -pp@ssw0rd -D dvwa
登录成功会看到 MariaDB [dvwa]> 提示符,说明密码正确、问题在配置文件;若看到如下信息,则是用户名或密码错误,请重做"数据库配置"步骤并全程保持同一组凭据:
ERROR 1045 (28000): Access denied for user 'dvwa'@'localhost' (using password: YES)
若看到如下信息,则凭据正确但该用户无权访问该库,请检查数据库名:
ERROR 1044 (42000): Access denied for user 'dvwa'@'localhost' to database 'dvwa'
最后一个常见错误:
ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/var/run/mysqld/mysqld.sock' (2)
这不是认证问题,而是数据库服务未启动,启动它:
sudo service mysql start
6.3 Unknown authentication method(#2054)
较新版本的 MySQL 默认认证方式导致 PHP 无法按默认配置通信。若 setup 脚本报:
Database Error #2054: The server requested authentication method unknown to the client.
有两种解决路径:
方案 A(最简单):卸载 MySQL,安装 MariaDB(官方迁移指南见 MariaDB 项目博客)。
方案 B(保留 MySQL):
- 以 root 身份编辑
/etc/mysql/mysql.conf.d/mysqld.cnf; - 在
[mysqld]行下方添加:default-authentication-plugin=mysql_native_password; - 重启数据库:
sudo service mysql restart; - 检查数据库用户的认证方式:
mysql> select Host,User, plugin from mysql.user where mysql.user.User = 'dvwa';
大概率会看到 caching_sha2_password,此时执行:
mysql> ALTER USER dvwa@localhost IDENTIFIED WITH mysql_native_password BY 'p@ssw0rd';
- 再次查询,应显示
mysql_native_password,此后 setup 即可正常运行。
6.4 Database Error #2002: No such file or directory
数据库服务未运行,Debian 系启动命令:
sudo service mysql start
6.5 "MySQL server has gone away" 与 "Packets out of order"
可能原因较多,但最常见的是数据库服务器版本与 PHP 版本不兼容,尤其是运行最新版 MySQL 时。官方建议:放弃 MySQL、安装 MariaDB(此类问题官方不提供支持)。
6.6 命令注入模块不工作
Apache 可能没有足够的权限在 Web 服务器上执行命令。Linux 下请确保以 root 身份运行;Windows 下以 Administrator 身份运行。
6.7 CentOS 上数据库无法连接
可能是 SELinux 拦截。可禁用 SELinux,或执行以下命令允许 Web 服务器与数据库通信:
setsebool -P httpd_can_network_connect_db 1
6.8 提交工单时的必备信息
若以上步骤都无法解决,请在官方仓库提交 issue。提交前请确认运行的是官方仓库 master 分支最新代码(而非最新 release 版本),并至少提供:
- 操作系统;
- 报错后 Web 服务器错误日志的最后 5 行;
- 若是数据库认证问题,按上述步骤逐步操作并对每一步截图,连同配置文件中数据库用户与密码部分的截图一并提交;
- 完整的问题描述:"发生了什么、期望什么、尝试过什么"。仅写"login broken"不足以定位问题。
七、切换 SQLite3 进行 SQL 注入练习
默认情况下,**SQLi 与 Blind SQLi(布尔盲注)**两个模块针对站点所用的 MariaDB/MySQL 进行注入测试;但 DVWA 支持切换到 SQLite3 作为注入后端。文档声明该能力支持有限,遇到问题请自行调试,不要只报"不能用"。
7.1 启用步骤
- 安装 PHP 的 SQLite3 扩展:安装
php-sqlite3包并确保其已启用; - 编辑配置文件,添加或修改以下两行:
$_DVWA["SQLI_DB"] = "sqlite";
$_DVWA["SQLITE_DB"] = "sqli.db";
对照 config/config.inc.php.dist 源码可以看到,文件顶部定义了 define ('MYSQL', 'mysql'); 与 define ('SQLITE', 'sqlite'); 两个常量,SQLI_DB 默认取 MYSQL(也可用环境变量 SQLI_DB 覆盖),并预留了 SQLITE_DB = 'sqli.db' 的注释示例。
- 默认使用 database/sqli.db 文件;若搞坏了,直接复制 database/sqli.db.dist 覆盖回去。
7.2 底层实现验证
从源码可以确认这一切换的真实生效路径:
- 在 dvwa/includes/dvwaPage.inc.php 中,当
$_DVWA['SQLI_DB'] == SQLITE时,页面框架会以database/为前缀打开$_DVWA['SQLITE_DB']指定的 SQLite3 数据库并建立连接; - 在 vulnerabilities/sqli/source/low.php 的 SQL 注入靶场实现中,代码依据
$_DVWA['SQLI_DB']进行switch:MYSQL分支走mysqli_query,SQLITE分支则通过SQLite3对象执行完全相同的查询语句(如SELECT first_name, last_name FROM users WHERE user_id = '$id';)。
也就是说,挑战题目本身完全一致,仅仅是后端数据库换成了 SQLite3。SQLite 版的初始数据定义在 database/create_sqlite_db.sql 中(users 表与 guestbook 表,含 admin/password、gordonb/abc123 等测试账号)。对学习者而言,这意味着可以脱离 MySQL/MariaDB 服务独立练习 SQL 注入,是轻量化的实验选项。
八、总结
DVWA 的部署本质上是"四步走":复制配置文件 → 对齐数据库凭据 → 执行 Create / Reset Database 初始化 → 按需调整安全等级、认证开关与 PHP 参数。绝大部分部署失败都可以归因于三类问题——目录/大小写定位错误(404)、数据库凭据不匹配(#1045/#1044)、PHP 与数据库版本认证不兼容(#2054)——本文已逐一给出可复现的定位命令与修复命令。若需要更轻量的注入实验环境,可直接切换 SQLite3 后端,无需安装任何数据库服务。