AWD Watchbird 安装与使用教程

AWD Watchbird 安装与使用教程

项目地址:https://gitcode.com/gh_mirrors/aw/awd-watchbird

1. 项目目录结构及介绍

AWD Watchbird 的目录结构大致如下：

awd-watchbird/
├── README.md       # 项目简介与说明
├── pack.py         # 打包脚本，用于将源码打包成单文件
├── waf.c            # WAF的核心C语言代码，用于编译生成动态链接库
└── watchbird.php    # 主要的PHP入口文件，包含配置与控制逻辑

• README.md: 包含项目的基本信息、特点以及贡献指南。
• pack.py: Python脚本，用于合并所有源代码为一个单一的PHP文件，便于部署。
• waf.c: WAF的C语言实现，编译后生成waf.so，用于增强PHP的安全防护。
• watchbird.php: 管理界面的PHP文件，提供了配置、日志查看等功能。

2. 项目的启动文件介绍

2.1 编译 waf.so

首先确保你的环境中已经安装了GCC编译器，然后在项目根目录执行以下命令来编译waf.so：

gcc waf.c -shared -o waf.so

2.2 部署 watchbird.php

将编译后的waf.so和未修改的watchbird.php放置到你的Web服务器的公共HTML目录中，例如 /var/www/html。

2.3 启用 WAF

在需要防护的每个PHP文件顶部添加以下代码，引入watchbird.php:

<?php include_once("/path/to/watchbird/php"); ?>

2.4 初始化配置

访问以下URL，初始化WAF并设置管理密码：

http://your-server-address/your-php-file.php?watchbird=ui

这将创建必要的配置文件，并允许你设置waf.so的路径和其他选项。

3. 项目的配置文件介绍

AWD Watchbird 的主要配置是在运行时通过watchbird.php的UI完成的。配置包括但不限于：

• waf.so 的路径，确保PHP能够找到此动态库。
• 防护策略，比如启用/禁用某些类型的防御机制（如SQL注入、RCE等）。
• 实时日志查看和流量控制选项，如是否将流量转发到其他网络段或第三方服务器。
• 自动提交flag的设置，可以在发现恶意活动时自动采取行动。

通过在UI中调整这些设置，你可以定制WAF以适应你的具体需求和服务器环境。

请注意，在实际部署之前，你应该仔细阅读项目源码和官方文档，了解更详细的配置选项和注意事项。在AWD赛事中合理使用WAF能够有效提高系统的安全性。

awd-watchbird A powerful PHP WAF for AWD 项目地址: https://gitcode.com/gh_mirrors/aw/awd-watchbird