morningstarxcdcode/AnonSuite

# AnonSuite - 面向实用工程师的统一安全工具包 [](https://opensource.org/licenses/MIT) [](https://www.python.org/downloads/) [](./SECURITY_MODEL.md) [](./REAL_WORLD_USAGE.md) **AnonSuite** 是一个命令行工具包，是我多年来对碎片化安全工具感到沮丧后开发的成果。它务实地将经过实战检验的开源组件整合到一个统一平台中，用于多层次的流量混淆和网络安全审计。这体现了一种真实世界的开发方法——在稳健的工程与可在生产环境中实际运行的、可维护的代码之间取得平衡。 ## 🚀 这在现实生活中真的可用吗？ **是的，绝对可用！** 您可以立即验证这一点： ``` # 立即测试（克隆后立即可用） git clone https://github.com/morningstarxcdcode/AnonSuite.git cd AnonSuite python src/anonsuite/main.py --demo python src/anonsuite/main.py --health-check ``` **核心功能可立即使用** - 无需安装。对于完整功能，AnonSuite 会准确告诉您所需的依赖项。 📖 **[完整的实际使用指南](./REAL_WORLD_USAGE.md)** | 🧪 **[运行验证测试](./validate_usability.sh)** ## 🎯 真实验证 **即时可用性测试**（克隆后即可运行）： ``` ./validate_usability.sh # Comprehensive validation ``` **快速验证**（3 个命令）： ``` python src/anonsuite/main.py --version # ✓ Version info python src/anonsuite/main.py --demo # ✓ Feature demo python src/anonsuite/main.py --health-check # ✓ System status ``` **生产用例**： - **安全专业人士**：网络评估和匿名性管理 - **学生/研究人员**：交互式学习和概念探索 - **渗透测试人员**：WiFi 安全测试和配置管理 ## 核心功能 ### 网络匿名化（核心重点） - **多 Tor 编排**：管理多个 Tor 实例，实现链路隔离和流量路由 - **Proxy 链**：集成 Privoxy 和 HAProxy 以实现灵活的代理配置 - **健壮的日志记录**：提供带有时间戳的详细日志，便于运维监控和调试 ### WiFi 安全审计（集成） - **网络侦察**：全面的 WiFi 扫描与分析 - **WPS PIN 恢复**：集成 Pixiewps 进行 WPS 漏洞测试 - **恶意 AP 框架**：集成 WiFiPumpkin3 进行接入点模拟 ### 实用工程 - **模块化设计**：专为可扩展性和可维护性而构建 - **绝对路径依赖**：确保在各种环境中都能可靠地发现和执行二进制文件 - **人工编写的质感**：代码和文档体现了自然、迭代的开发过程 ## 快速开始 ### 前置条件 - **macOS 或基于 Linux 的系统** - **Python 3.8 或更高版本** - 某些网络操作需要 **sudo 权限** - **Homebrew**（macOS）或您系统的包管理器（Linux），用于安装外部依赖项 ### 外部依赖 AnonSuite 负责编排外部二进制文件。请通过 Homebrew (macOS) 或您系统的包管理器安装它们： ``` # 安装 Tor brew install tor # 安装 Privoxy brew install privoxy # 安装 HAProxy brew install haproxy # 安装 pidof（在 macOS 上属于 proctools 的一部分） brew install proctools ``` ### 安装 ``` # 克隆 repository git clone https://github.com/morningstarxcdcode/AnonSuite.git cd AnonSuite # 使 multitor scripts 可执行 chmod +x src/anonymity/multitor/multitor \ src/anonymity/multitor/__init__ \ src/anonymity/multitor/CreateTorProcess \ src/anonymity/multitor/CreateProxyProcess ``` ### multitor 的初始设置与故障排除 **重要提示：** multitor 需要特定的权限和端口可用性。请仔细按照以下步骤操作： 1. **修复 Tor 数据目录所有权：** Tor 的数据目录需要归其运行用户所有。如果之前的运行以 root 身份创建了该目录，您必须修复所有权： sudo chown -R $USER ~/Desktop/AnonSuite/src/anonymity/multitor/tor_9000 # 如果存在其他 tor_* 目录，请对其进行同样的操作 2. **解决 Privoxy 端口冲突：** Privoxy 的默认端口 (8118) 可能已被占用。您需要： - **终止任何冲突的进程：** lsof -i :8118 # 如果列出了进程，请将其终止（将 替换为实际的进程 ID） sudo kill - **更改 Privoxy 的监听端口：** 编辑其配置文件： sudo nano /opt/homebrew/etc/privoxy/config # 找到这一行： listen-address 127.0.0.1:8118 # 将 8118 更改为一个未使用的端口，例如： 8119： # listen-address 127.0.0.1:8119 # 保存并退出 (CTRL+O, Enter, CTRL+X) ### 运行 multitor 一旦前置条件和初始设置完成，请使用您的实际用户名运行 multitor。输出将实时记录到您的终端，并保存到 multitor.log 中。 ``` # 将 替换为您的实际系统用户名 sudo /Users/$USER/Desktop/AnonSuite/src/anonymity/multitor/multitor \ --user $USER \ --socks-port 9000 \ --control-port 9001 \ --proxy privoxy \ --haproxy yes ``` ## 项目结构 ``` AnonSuite/ ├── src/ # Core application code │ ├── anonsuite.py # Main CLI interface │ ├── config_manager.py # Configuration management system │ ├── anonymity/ # Tor and proxy modules │ │ └── multitor/ # Core multitor scripts and helpers │ │ ├── multitor │ │ ├── __init__ │ │ ├── CreateTorProcess │ │ ├── CreateProxyProcess │ │ ├── helpers │ │ ├── settings │ │ └── multitor.log # Operational logs │ └── wifi/ # WiFi auditing tools │ ├── pixiewps_wrapper.py │ ├── wifipumpkin_wrapper.py │ └── wifi_scanner.py ├── tests/ # Comprehensive test suite │ ├── unit/ # Unit tests │ ├── integration/ # Integration tests │ └── security/ # Security tests ├── docs/ # Project documentation │ ├── installation.md # Installation guide │ ├── user-guide.md # User documentation │ └── troubleshooting.md # Troubleshooting guide ├── config/ # Configuration files ├── plugins/ # Plugin system ├── run/ # Runtime files and logs ├── .github/ # GitHub Actions CI/CD workflows │ └── workflows/ │ └── ci.yml # Automated testing pipeline ├── .env.example # Environment variables template ├── architect-state.json # Project state tracking ├── pyproject.toml # Python project configuration └── README.md # You are here ``` ## 用法 ### 交互模式 ``` # 启动交互式菜单 python src/anonsuite.py ``` ### 命令行模式 ``` # 检查版本和健康状态 python src/anonsuite.py --version python src/anonsuite.py --health-check # 匿名化操作 python src/anonsuite.py --start-anonymity python src/anonsuite.py --anonymity-status python src/anonsuite.py --new-circuit # WiFi 操作 python src/anonsuite.py --wifi-scan python src/anonsuite.py --wifi-scan --wifi-interface wlan0 # 配置管理 python src/anonsuite.py --config-wizard python src/anonsuite.py --list-profiles python src/anonsuite.py --create-profile production # Plugin 系统 python src/anonsuite.py --list-plugins python src/anonsuite.py --run-plugin "Network Info Plugin" ``` ## 测试与质量保证 本项目包含全面的测试框架： ``` # 运行所有测试 pytest # 运行特定测试类别 pytest tests/unit/ # Unit tests pytest tests/integration/ # Integration tests pytest tests/security/ # Security tests # 运行并生成 coverage pytest --cov=src --cov-report=html ``` ## CI/CD 流水线 GitHub Actions 工作流确保了代码的质量和一致性： - **代码检查**：ruff check 和 ruff format --check - **类型检查**：mypy src/ - **安全扫描**：bandit 和 safety - **测试**：跨多个 Python 版本运行 pytest - **多操作系统支持**：Ubuntu 和 macOS ## 文档 - **[安装指南](./docs/installation.md)**：全面的设置说明 - **[用户指南](./docs/user-guide.md)**：详细的使用文档 - **[故障排除](./docs/troubleshooting.md)**：常见问题与解决方案 - **multitor.log**：用于调试的详细操作日志 ## 安全与法律 ### 道德使用 此工具包专为以下用途设计： - [x] 授权的渗透测试 - [x] 安全研究与教育 - [x] 网络安全评估 - [x] 合规性验证 ### 法律免责声明 - **严禁未经授权使用** - **务必获得明确许可** - **遵守当地法律法规** - **不承担任何保证或责任** 开发者不对滥用本软件的行为负责。用户在进行任何安全评估之前，必须确保遵守相关法律并获得适当的授权。 ## 支持与联系 ### 作者 - **开发者**：morningstarxcdcode - **LinkedIn**：[Sourav Rajak](https://www.linkedin.com/in/sourav-rajak-6294682b2) - **GitHub**：[@morningstarxcdcode](https://github.com/morningstarxcdcode) ### 项目仓库 - **仓库**：[GitHub 上的 AnonSuite](https://github.com/morningstarxcdcode/AnonSuite) - **Issues**：在 [GitHub Issues](https://github.com/morningstarxcdcode/AnonSuite/issues) 报告 bug 和请求新功能 - **讨论**：在 [GitHub Discussions](https://github.com/morningstarxcdcode/AnonSuite/discussions) 参与社区讨论 ## 许可证 本项目基于 MIT 许可证授权 - 详情请参阅 [LICENSE](./LICENSE) 文件。 ## 致谢 特别感谢所集成工具的开发者： - [trimstray](https://github.com/trimstray) 提供 multitor - [P0cL4bs](https://github.com/P0cL4bs) 提供 wifipumpkin3 - [wiire-a](https://github.com/wiire-a) 提供 pixiewps **重要提示**：此工具仅供授权的安全测试使用。在进行任何安全评估之前，请务必确保您已获得适当的许可。开发者对本软件的滥用不承担任何责任。

标签：Python, WiFi审计, 匿名化, 安全规则引擎, 无后门, 流量混淆, 网络安全, 逆向工具, 防御绕过, 隐私保护