aircrack-ng - WiFi security auditing tools suite

项目说明

Aircrack-ng

Badges

GitHub CI

![Alma Linux CI]()
![Alpine Linux]()
![DragonFlyBSD CI]()
![FreeBSD CI]()
![Gentoo CI]()
![Kali Linux CI]()
![Linux CI]()
![Linux PCRE CI]()
![macOS CI]()
![NetBSD CI]()
![OpenBSD CI]()
![Windows CI]()

Others

![Clang Scan-build]()
![Codespell]()
![Co Scan]()
![Docker (git) push to DockerHub]()
![Markdown link]()
![P Analysis]()
![Style & Consistency]()

Repository

!Arch Linux package
!Debian package
!Debian package
!Docker Image (latest by date)
!Fedora package
!homebrew
!Ubuntu package
!Ubuntu package
!Ubuntu package
!Ubuntu package
!Ubuntu package
!Ubuntu package
!Ubuntu package

Description

Aircrack-ng is a complete suite of tools to assess WiFi 网络 security.

It focuses on different areas of WiFi security:
* Monitoring: Packet capture and export of data to text files for further processing by third party tools.
* Attacking: Replay attacks, deauthentication, fake access points and others injection.
* Testing: Checking WiFi cards and dri (capture and injection).
* Cracking: WEP and WPA PSK (WPA 1 and 2).

All tools are command line which allows for hea. A lot of GUIs ha ad of this feature. It works primarily on Linux but also Windows, macOS, FreeBSD, OpenBSD, NetBSD, as well as Solaris and e 2.

Building

Requirements

* Autoconf
* Automake
* Libtool
* shtool
* OpenSSL de package or libgcrypt de package.
* Airmon-ng (Linux) requires ethtool, usbutils, and often pciutils.
* On Windows, cygwin has to be used and it also requires w32api package.
* On Windows, if using clang, libiconv and libicon
* Linux: LibNetlink 1 or 3. It can be disabled by passing --disable-libnl to configure.
* pkg-config (pkgconf on FreeBSD, DragonFlyBSD, OpenBSD and NetBSD)
* FreeBSD, DragonFlyBSD, OpenBSD, NetBSD, Solaris and OS X with Macports: gmake
* Linux/Cygwin: make and Standard C++ Library de package (Debian: libstdc++-dev)

Note: Airmon-ng only requires pciutils if the system has a PCI/PCIe bus and it is populated.
Such bus can be present even if not physically . For example, it is present,
and populated on the Raspberry Pi 4, therefore pciutils is required on that device.

Optional stuff

* If you want SSID filtering with regular expression in airodump-ng
(--essid-regex) PCRE or PCRE2 de package is required.
* If you want to use airolib-ng and '-r' option in aircrack-ng,
SQLite de package >= 3.3.17 (3.6.X or better is recommended)
* If you want to use Airpcap, the 'de' directory from the CD/ISO/SDK is required.
* In order to build besside-ng, besside-ng-crawler, easside-ng, tkiptun-ng and wesside-ng,
libpcap de package is required (on Cygwin, use the Airpcap SDK instead; see above)
* rfkill
* If you want Airodump-ng to log GPS coordinates, gpsd is needed
* For best performance on SMP machines, ensure the hwloc library and headers are installed. It is strongly recommended on high core count systems, it may give a serious speed boost
* CMocka and expect for testing
* For integration testing on Linux only: tcpdump, HostAPd, WPA Supplicant and screen

Installing required and optional dependencies

Below are instructions for installing the basic requirements to build
aircrack-ng for a number of operating systems.

Note: CMocka, tcpdump, screen, HostAPd and WPA Supplicant should not be dependencies when packaging Aircrack-ng.

Linux

#### Arch Linux

sudo pacman -Sy base-de openssl ethtool util-linux zlib libpcap sqlite pcre2 hwloc cmocka hostapd wpa_supplicant tcpdump screen iw usbutils pciutils expect

#### Debian/Ubuntu

sudo apt-get install build-essential autoconf automake libtool pkg-config libnl-3-de libssl-de shtool rfkill zlib1g-de libsqlite3-de libhwloc-de hostapd wpasupplicant tcpdump screen iw usbutils expect

#### Fedora

sudo yum install libtool pkgconfig sqlite-de automake openssl-de pcre2-de libnl3-devel gcc gcc-c++ ethtool hwloc-de make file expect hostapd wpa_supplicant iw usbutils tcpdump screen zlib-de

#### CentOS/RHEL 7

sudo yum install epel-release
sudo ./centos_autotools.sh
# Remo installation of automake/autoconf
sudo yum remo automake
sudo yum install sqlite-de libpcap-de rfkill libnl3-de hwloc-de make file expect hostapd wpa_supplicant iw usbutils tcpdump screen zlib-devel

Note: autoconf, automake, libtool, and pkgconfig in the repositories are too old. The script centos_autotools.sh automatically installs dependencies to compile then install the tools.

#### CentOS/RHEL 8

sudo yum config-manager --set-enabled powertools
sudo yum install epel-release
sudo yum install libtool pkgconfig sqlite-de automake openssl-de pcre2-de libnl3-devel gcc gcc-c++ ethtool hwloc-de make file expect hostapd wpa_supplicant iw usbutils tcpdump screen zlib-devel

#### openSUSE

sudo zypper install autoconf automake libtool pkg-config libnl3-de zlib-de sqlite3-de hwloc-de hostapd wpa_supplicant tcpdump screen iw gcc-c++ gcc ethtool pciutils usbutils expect

#### Mageia

sudo urpmi autoconf automake libtool pkgconfig libnl3-de zlib-de sqlite3-de hwloc-de hostapd wpa_supplicant tcpdump screen iw gcc-c++ gcc make expect

#### Alpine

sudo apk add gcc g++ make autoconf automake libtool libnl3-de ethtool libpcap-de hostapd wpa_supplicant tcpdump screen iw pkgconf util-linux sqlite-de linux-headers zlib-de usbutils expect

Note: Community repository needs to be enabled for iw

#### Clear Linux

sudo swupd bundle-add c-basic de de de de de de de ethtool wget 网络-basic software-testing sysadmin-basic wpa_supplicant os-testsuite

Note: hostapd must be compiled manually, it is not present in the repository

BSD

#### FreeBSD

pkg install pkgconf shtool libtool gcc9 automake autoconf pcre2 sqlite3 openssl gmake hwloc cmocka

#### DragonflyBSD

pkg install pkgconf shtool libtool gcc8 automake autoconf pcre2 sqlite3 libgcrypt gmake cmocka

#### OpenBSD

pkg_add pkgconf shtool libtool gcc automake autoconf pcre2 sqlite3 openssl gmake cmocka

#### NetBSD

pkg_add pkgconf libtool gcc7 automake autoconf pcre2 sqlite3 openssl gmake cmocka

macOS

XCode, Xcode command line tools and HomeBrew are required.

brew install autoconf automake libtool openssl shtool pkg-config hwloc pcre2 sqlite3 libpcap cmocka

Windows

#### Cygwin

Cygwin requires the full path to the setup.exe utility, in order to
automate the installation of the necessary packages. In addition, it
requires the location of your installation, a path to the cached
packages download location, and a mirror URL.

An example of automatically installing all the dependencies
is as follows:

c:\cygwin\setup-x86.exe -qnNdO -R C:/cygwin -s -l C:/cygwin//setup -P autoconf -P automake -P bison -P gcc-core -P gcc-g++ -P mingw-runtime -P mingw-binutils -P mingw-gcc-core -P mingw-gcc-g++ -P mingw-pthreads -P mingw-w32api -P libtool -P make -P python -P gettext-devel -P gettext -P intltool -P libiconv -P pkg-config -P git -P wget -P curl -P libpcre2-devel -P libssl-devel -P libsqlite3-devel

#### MSYS2

pacman -Sy autoconf automake-wrapper libtool msys2-w32api-headers msys2-w32api-runtime gcc pkg-config git python openssl-de libopenssl msys2-runtime-devel gcc binutils make pcre2-de

GNU/Hurd

#### Debian

apt-get install build-essential autoconf automake libtool pkg-config libssl-de zlib1g-de libsqlite3-de libhwloc-de screen expect libbsd-dev

Docker containers

We have two repositories on DockerHub:

aircrackng/release: Each release

aircrackng/git: every commit in the git repository

Base command for the git :

sudo docker run --rm -it aircrackng/git

A platforms/CPU architectures:

linux/386 (base image: debian:unstable-slim)

linux/amd64 (base image: debian:unstable-slim)

linux/arm/v5 (base image: debian:unstable-slim)

linux/arm/v6 (base image: alpine:3)

linux/arm/v7 (base image: debian:unstable-slim)

linux/arm64/v8 (base image: debian:unstable-slim)

linux/mips64le (base image: debian:unstable-slim)

linux/ppc64le (base image: debian:unstable-slim)

linux/riscv64 (base image: debian:unstable-slim)

linux/s390x (base image: debian:unstable-slim)

Compiling

To build aircrack-ng, the Autotools build system is utilized. Autotools replaces
the older method of compilation.

NOTE: If utilizing a de , eg: one checked out from 源码 control,
you will need to run a pre-configure script. The script to use is one of the
following: autoreconf -i or en=1 ./autogen.sh.

First, ./configure the project for building with the appropriate options specified
for your en:

./configure <options>

TIP: If the abo, please see abo de 源码 control .

Next, compile the project (respecting if make or gmake is needed):

* Compilation:

make

* Compilation on *BSD or Solaris:

gmake

Finally, the additional targets listed below may be of use in your en:

* Execute all unit testing:

make check

* Execute all integration testing (requires root):

make integration

* Installing:

make install

* Uninstall:

make uninstall

./configure flags

When configuring, the following flags can be used and combined to adjust the suite
to your choosing:

* with-airpcap=DIR: needed for supporting airpcap devices on Windows (Cygwin or MSYS2 only).
Replace DIR above with the absolute location to the root of the
extracted 源码 代码 from the Airpcap CD or downloaded SDK a
online. Required on Windows to build besside-ng, besside-ng-crawler,
easside-ng, tkiptun-ng and wesside-ng when building experimental tools.
The de pack (Compatible with 4.1.1 and 4.1.3) can be downloaded at

* with-experimental: needed to compile tkiptun-ng, easside-ng, buddy-ng,
buddy-ng-crawler, air and wesside-ng.
libpcap de package is also required to compile most of the tools.
If not present, not all experimental tools will be built.
On Cygwin, libpcap is not present and the Airpcap SDK replaces it.
See --with-airpcap option above.

* with-ext-scripts: needed to build airoscript-ng, , airgraph-ng and
airdrop-ng.
Note: Each script has its own dependencies.

* with-gcrypt: Use libgcrypt crypto library instead of the default OpenSSL.
And also use internal fast sha1 implementation (borrowed from GIT).
Dependency (Debian): libgcrypt20-dev

* with-duma: Compile with DUMA support. DUMA is a library to detect buffer o and underruns.
Dependency (Debian): duma

* disable-libnl: Set up the project to be compiled without libnl (1 or 3). Linux option only.

* without-opt: Do not enable -O3 optimizations.

* enable-shared: Make OSdep a shared library.

* disable-shared: When combined with enable-static, it will statically compile Aircrack-ng.

* with-avx512: On x86, add support for AVX512 instructions in aircrack-ng. Only use it when
the current CPU supports AVX512.

* with-static-simd=<SIMD>: Compile a single optimization in aircrack-ng binary. Useful when compiling
statically and/or for space-constrained devices. Valid SIMD options: x86-sse2,
x86-a, x86-avx512, ppc-altivec, ppc-power8, arm-neon, arm-asimd.
Must be used with --enable-static --disable-shared. When using those 2 options, the default
is to compile the generic optimization in the binary. --with-static-simd merely allows
to choose another one.

* enable-maintainer-mode: It is important to enable this flag when de with Aircrack-ng. This flag enables additional compile warnings and safety features.

#### Examples:

* Configure and compiling:

* Compiling with gcrypt:

* Installing:

make install

* Installing (strip binaries):

make install-strip

* Installing, with external scripts:

* Testing (with sqlite, experimental and pcre2)

* Compiling on OS X with macports (and all options):

* Compiling on macOS running on M1/AARCH64 and Homebrew:

* Compiling on OS X 10.10 with XCode 7.1 and Homebrew:

*NOTE*: Older XCode ships with a of LLVM that does not support CPU feature
detection; which causes the ./configure to fail. To work around this older LLVM,
it is required that a different compile suite is used, such as GCC or a newer LLVM
from Homebrew.

If you wish to use OpenSSL from Homebrew, you may need to specify the location
to its installation. To figure out where OpenSSL lives, run:

brew --prefix openssl

Use the output above as the DIR for --with-openssl=DIR in the ./configure line:

* Compiling on FreeBSD with gcc9

* Compiling on Cygwin with Airpcap (assuming Airpcap devpack is unpacked in Aircrack-ng directory)

* Compiling on DragonflyBSD with gcrypt using GCC 8

* Compiling on OpenBSD (with autoconf 2.69 and automake 1.16)

* Compiling and debugging aircrack-ng

IDE de

VS Code - de

A VS 代码 de en is provided, as is, for rapid setup of a de en. This additionally adds support for GitHub Codespaces.

Requirements

The first requirement is a working Docker 引擎 en.

Next, an installation of VS 代码 with the following extension(s):

Remote - Containers by Microsoft.

> The "Remote - Containers" extension will refuse to work with OSS 代码.

Usage

1. Clone this repository to your working folder:

2. After cloning this repository, open the folder inside VS 代码.

> IMPORTANT: You should answer "Yes", if it asks if the folder should be opened inside a remote container. If it does not ask, then press Ctrl+Shift+P and type open in container. This should bring up the correct command, for which pressing enter will run said command.

3. A number of warnings might appear about a missing compile_commands.json file. These are safe to ignore for a moment, as this file is automatically generated after the initial compilation.
4. Now build the entire project by pressing Ctrl+R and selecting Build Full from the pop-up menu that appears.
5. VS Code should detect the compile_commands.json file and ask if it should be used; selecting "Yes, always" will complete the initial setup of a fully working IDE.
> IMPORTANT: If it doesn't detect the file, pressing Ctrl+Shift+P and typing reload window will bring up the selection to fully reload the en.
6. At this point, nearly all features of VS 代码 will function; from Intellisense, auto-completion, li, to 代码 formatting. Additionally, there are pre-configured tasks for builds and tests, as well as an example GDB/LLDB configuration for debugging aircrack-ng.

Packaging

Automatic detection of CPU optimization is done at run time. This behavior
is desirable when packaging Aircrack-ng (for a Linux or other distribution.)

Also, in some cases it may be desired to provide your own flags completely and
not having the suite auto-detect a number of optimizations. To do this, add
the additional flag --without-opt to the ./configure line:

./configure --without-opt

Using pre-compiled binaries

Linux/BSD

Aircrack-ng is a in most distributions repositories. However, it is not always up-to-date.

Windows

* Install the appropriate "monitor" driver for your card; standard drivers don't work for capturing data.
* Aircrack-ng suite is command line tools. So, you have to open a command-line
Start menu -> Run... -> cmd.exe then use them
* Run the executables without any parameters to have help

Documentation

Some more information is present in the README file.

Documentation, tutorials, ... can be found on

Support is a in the GitHub Discussions and on IRC (in #aircrack-ng on Libera Chat).

Every 工具 has its own manpage. For aircrack-ng, man aircrack-ng

Infrastructure sponsors

项目信息

开发语言：C

Star 数：7704

技术要点

该项目属于安全软件方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕WiFi security auditing tools suite展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。