这份详细的部署教程将指引您安装和使用 Airgorah——一款基于 Rust 和 GTK4 构建、以 aircrack-ng 为核心的现代化 WiFi 安全审计图形化工具。它可以帮助您发现网络、捕获 WPA 握手包并执行密码审计。

⚠️ 重要法律声明

Airgorah 仅可用于测试您拥有所有权的网络。 在未经授权的情况下对 WiFi 网络进行任何形式的攻击，在绝大多数国家/地区均属于非法行为。使用本软件造成的任何后果，作者不承担任何责任。

🔧 系统要求

在开始之前，请确保您的环境满足以下条件：

  • 操作系统：仅支持 Linux（支持 X11 和 Wayland），并需要 root 权限运行。
  • 无线网卡：必须支持监控模式 (Monitor Mode) 和数据包注入 (Packet Injection)。您可以通过 iw list | grep -A 10 "Supported interface modes" 命令检查。
  • 架构：支持 x86_64 和 aarch64 架构。

📦 安装方式

您可以根据自己的 Linux 发行版选择最适合的安装方法。

方式一：使用预编译包安装（推荐）

这是最简单快捷的方式。从 GitHub Releases 页面 下载对应您系统的包并安装。

  • Debian/Ubuntu (.deb):

    1
    2
    3
    sudo apt update
    # 将 <version> 和 <arch> 替换为实际下载的文件名
    sudo apt install ~/Downloads/airgorah_<version>_<arch>.deb

  • Fedora/RHEL (.rpm):

    1
    2
    sudo dnf update
    sudo dnf install ~/Downloads/airgorah_<version>_<arch>.rpm

  • Arch Linux (.pkg.tar.zst):

    1
    2
    sudo pacman -Syu
    sudo pacman -U ~/Downloads/airgorah_<version>_<arch>.pkg.tar.zst

    或者从 AUR 安装：yay -S airgorah-bin。

方式二：从源码编译（开发者/最新版）

如果您需要最新功能或想自行编译，可按以下步骤操作。

  1. 安装 Rust 和 Cargo：

    1
    curl https://sh.rustup.rs -sSf | sh

  2. 安装构建依赖：

    • Debian/Ubuntu:

      1
      sudo apt install build-essential libgtk-4-dev libglib2.0-dev ruby ruby-dev rubygems rpm libarchive-tools

    • Fedora/RHEL:

      1
      sudo dnf install git gcc gtk4-devel glib2-devel ruby-devel rpm-build

    • Arch Linux:

      1
      sudo pacman -S git base-devel gtk4 glib2 ruby rpm-tools

  3. 安装 fpm（用于生成软件包）：

    1
    sudo gem install fpm

  4. 克隆并编译项目：

    1
    2
    3
    git clone https://github.com/martin-olivier/airgorah.git
    cd airgorah
    cargo build --release

  5. 生成并安装包：编译成功后，在项目根目录下使用 fpm 命令生成对应系统的安装包（如 .deb, .rpm），然后用包管理器安装。具体的 fpm 命令参数可参考项目文档或中的示例。

🚀 首次运行与权限配置

安装完成后，您可以通过应用菜单启动 Airgorah，或使用命令行。

  • 使用 pkexec（推荐）：图形界面会以普通用户运行，但在需要特权操作时，会通过 pkexec 调用一个特权代理 (airgorah-agent) 并弹出密码认证对话框。

    1
    pkexec airgorah

  • 使用 sudo（备选）：如果您是通过 cargo install 安装的，可能无法在应用菜单中找到它，可以使用此命令。

    1
    sudo ~/.cargo/bin/airgorah

首次启动时，系统会提示您输入密码以授予 root 权限。

🖥️ 界面与核心功能使用

启动后，您将看到一个简洁的图形界面。

  1. 选择无线网卡：在界面列表中选择您支持监控模式的无线网卡。选定后，该网卡会自动被设置为监控模式，并根据您的设置停止网络管理器或修改 MAC 地址，然后自动开始扫描周围网络。
  2. 扫描与筛选网络：
    • 主窗口会实时显示附近所有 WiFi 网络的信息（BSSID、ESSID、信道、信号强度、加密方式等）。
    • 您可以通过右侧边栏筛选频段（2.4GHz/5GHz） 或指定要扫描的特定信道。
  3. 执行去认证攻击并捕获握手包：
    • 在 WiFi 列表中选择目标网络，点击 Deauth 按钮。
    • 在弹出的窗口中选择攻击后端（aireplay-ng 或 mdk4），并选择要踢掉的客户端（或选择“Deauth all clients”）。
    • 点击 Deauth 开始攻击。当客户端重新连接时，如果成功捕获到 WPA 握手包，它会在主界面的“Handshake”列中显示。
  4. 破解密码：
    • 点击顶部栏的解密按钮（钥匙图标）。
    • 在解密窗口中，选择包含握手包的捕获文件，然后选择字典文件进行破解，或配置暴力破解参数。
    • 点击 Start Decryption，密码破解过程将在独立的终端窗口中运行。

⚙️ 设置与文件位置

  • 设置窗口：您可以通过顶部栏的设置按钮调整 Airgorah 的全局行为，如是否在扫描时停止网络管理器或随机化 MAC 地址。
  • 配置文件：所有设置保存在 /etc/airgorah/config.toml 文件中。

如果在部署或使用中遇到问题，可以查阅项目的 GitHub Issues 或参考 官方Wiki。

你使用的是哪个 Linux 发行版？如果在安装或权限配置时遇到具体的报错信息，可以告诉我，我会尽力帮你分析。