# SecPi Commander

**Repository Path**: fiagainster/sec-pi-commander

## Basic Information

- **Project Name**: SecPi Commander
- **Description**: 控制树莓派进行简单的网络扫描测试，集成了AI分析功能，适合网安学习
- **Primary Language**: Dart
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-08
- **Last Updated**: 2026-02-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SecPi Commander

SecPi Commander 是一个网络安全实战工具，用于控制树莓派执行渗透测试命令。

## 功能特性

- **远程连接**：连接到树莓派或其他Linux服务器
- **系统状态监控**：实时查看服务器系统状态
- **网络安全工具箱**：集成多种常用网络安全命令
- **执行日志**：记录所有命令执行历史
- **AI分析**：使用DeepSeek AI分析命令执行结果

## 技术栈

- **前端框架**：Flutter 3.38.6
- **编程语言**：Dart 3.10.7
- **状态管理**：Provider
- **网络请求**：Dio
- **本地存储**：SharedPreferences
- **UI组件**：Material Design 3

## 项目结构

```
lib/
├── models/           # 数据模型
│   ├── command_template.dart  # 命令模板
│   ├── connection_config.dart # 连接配置
│   └── system_status.dart     # 系统状态
├── providers/        # 状态管理
│   ├── ai_provider.dart       # AI服务提供商
│   ├── connection_provider.dart # 连接管理
│   └── log_provider.dart      # 日志管理
├── screens/          # 页面
│   └── home_screen.dart        # 主页面
├── services/         # 服务
│   ├── api_client.dart         # API客户端
│   ├── deepseek_service.dart   # DeepSeek AI服务
│   └── local_logger.dart       # 本地日志记录
├── widgets/          # 组件
│   ├── ai_analysis_dialog.dart # AI分析对话框
│   ├── command_button.dart     # 命令按钮
│   ├── connection_card.dart    # 连接卡片
│   ├── log_console.dart        # 日志控制台
│   └── status_dashboard.dart   # 状态仪表盘
└── main.dart         # 应用入口
```

## 工具箱命令

| 命令名称 | 功能描述 | 命令模板 | 需要输入 |
|---------|---------|---------|---------|
| 扫描在线主机 | 使用nmap发现网络内存活设备 | `nmap -sn {input}` | 目标网络（如192.168.43.0/24） |
| 端口扫描 | 扫描目标IP的开放端口 | `nmap -sV -p 1-1000 {input}` | 目标IP地址 |
| 域名信息查询 | 查询域名的注册信息 | `whois {input}` | 域名（如example.com） |
| 无线网络扫描 | 扫描附近的无线网络 | `sudo iwlist wlan0 scan` | 否 |
| 连通性测试 | 测试目标主机的连通性 | `ping -c 4 {input}` | 目标IP或域名 |
| 路由追踪 | 追踪到目标主机的路由路径 | `traceroute {input}` | 目标IP或域名 |
| DNS查询 | 查询域名的DNS记录 | `nslookup {input}` | 域名（如example.com） |
| ARP扫描 | 扫描局域网内的MAC地址 | `arp-scan {input}` | 目标网络（如192.168.43.0/24） |

## 安装与使用

### 前置条件

- Flutter SDK 3.0.0 或更高版本
- Dart SDK 3.0.0 或更高版本
- Android Studio 或 Xcode（用于构建）
- 树莓派或其他Linux服务器

### 安装步骤

1. **克隆项目**
   ```bash
   git clone <项目地址>
   cd secpi_apk_builder
   ```

2. **安装依赖**
   ```bash
   flutter pub get
   ```

3. **构建应用**
   - Android
     ```bash
     flutter build apk --release
     ```
   - iOS
     ```bash
     flutter build ios --release
     ```

4. **运行应用**
   ```bash
   flutter run
   ```

### 使用方法

1. **连接服务器**
   - 在连接卡片中输入服务器IP地址和端口
   - 点击"连接"按钮

2. **执行命令**
   - 在"工具箱"部分选择需要执行的命令
   - 对于需要输入的命令，填写相关参数
   - 确认执行命令
   - 查看命令执行结果

3. **查看日志**
   - 在"执行日志"部分查看所有命令执行历史

4. **AI分析**
   - 在命令执行结果对话框中点击"AI分析"
   - 输入DeepSeek API Key（首次使用时）
   - 查看AI分析结果

## 配置说明

### DeepSeek AI 配置

1. 访问 [DeepSeek 平台](https://platform.deepseek.com/api_keys) 获取 API Key
2. 在应用中点击命令执行结果对话框中的"AI分析"
3. 输入API Key并保存

### 网络配置

如果遇到网络连接问题，可以在 `android/gradle.properties` 文件中添加以下配置：

```properties
# 网络超时设置
org.gradle.jvmargs=-Xmx1536M -Dorg.gradle.internal.http.socketTimeout=60000 -Dorg.gradle.internal.http.connectionTimeout=60000

# Flutter 镜像配置（中国大陆用户）
FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
```

## 法律免责声明

本工具仅限在已获得明确授权的环境中进行安全测试。未经授权使用本工具进行任何形式的网络攻击或渗透测试均属违法行为，使用者需承担全部法律责任。

## 版本信息

- 版本：1.0.0
- 发布日期：2026-02-08

## 贡献

欢迎提交 Issue 和 Pull Request 来帮助改进这个项目。

## 联系方式

如有问题或建议，请联系项目维护者。

---

**注意**：本工具仅供学习和授权测试使用，请勿用于非法用途。