pinecone - A WLAN red team framework.

项目说明

<p align="center">
<img width=500 src="logo_full.png?raw=true">
</p>

Pinecone is a WLAN networks auditing tool, suitable for red team usage. It is extensible , and it is designed to be run in Debian-based operating systems. Pinecone is specially oriented to be used with a Raspberry Pi, as a portable wireless auditing box.

This tool is designed for educational and research purposes only. Only use it with explicit permission.

Installation

For running Pinecone, you need a Debian-based operating system (it has been tested on Raspbian, Raspberry Pi Desktop and Kali Linux). Pinecone has the following requirements:
* Python 3.5+. Your distribution probably comes with Python3 already installed, if not it can be installed using apt-get install python3.
* dnsmasq (tested with 2.76). Can be installed using apt-get install dnsmasq.
* hostapd-wpe (tested with 2.6). Can be installed using apt-get install hostapd-wpe. If your distribution repository does not have a hostapd-wpe package, you can either try to install it using a Kali Linux repository pre-compiled package, or compile it from its source code.

After installing the necessary packages, you can install the Python packages requirements for Pinecone using pip3 install -r requirements.txt in the project root folder.

Usage

For starting Pinecone, execute python3 pinecone.py from within the project root folder:

Pinecone is controlled via a Metasploit-like command-line interface. You can type help to get the list of a commands, or help 'command' to get more information about a specific command:

Use the command use 'moduleID' to activate a Pinecone module. You can use Tab auto-completion to see the list of current loaded modules:

Every module has options, that can be seen typing help run or run --help when a module is activated. Most modules ha for their options (check them before running):

When a module is activated, you can use the run [options...] command to start its functionality. The modules provide feedback of their execution state:

If the module runs in background (for example, *scripts/infrastructure/ap*), you can stop it using the stop command when the module is running:

When you are done using a module, you can deactivate it by using the back command. You can also activate another module issuing the use command again.

Shell commands may be executed with the command shell or the ! shortcut:

Currently, Pinecone reconnaissance SQLite database is stored in the *db/* directory inside the project root folder. All the temporary files that Pinecone needs to use are stored in the *tmp/* directory also under the project root folder.

项目信息

开发语言：Python

Star 数：163

技术要点

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

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

使用与学习建议

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

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

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

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

免责声明

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