🔍 PortDetection

Windows 端口检测与管理工具 - 一款基于 Tauri 2 构建的现代化桌面应用，用于实时监控和管理 Windows 系统的网络端口占用情况。

✨ 功能特性

• 🔎 端口扫描 - 实时获取系统 TCP/UDP 端口占用信息
• 🔗 进程关联 - 显示占用端口的进程详细信息（名称、PID、路径）
• 🔍 端口搜索 - 快速查找特定端口或进程
• 🔒 保留端口检测 - 查看 Windows 系统保留的端口范围
• 📊 端口监控 - 持续监控端口状态变化
• 💻 系统托盘 - 支持最小化到托盘后台运行
• 🔔 系统通知 - 端口状态变化时推送桌面通知

🛠️ 技术栈

🦀 后端

技术	版本	用途
Rust	2021 Edition	系统编程语言
Tauri	2.x	跨平台桌面框架
Windows API	0.58	原生系统调用
Tokio	1.x	异步运行时
Tracing	0.1	日志与追踪

⚛️ 前端

技术	版本	用途
React	18.3	UI 框架
TypeScript	5.6	类型安全
Vite	5.4	构建工具
Tailwind CSS	3.4	样式框架

💻 系统要求

• 操作系统: Windows 10/11 (64-bit)
• 开发环境:
  • Node.js >= 18.x
  • Rust >= 1.70
  • Tauri 开发依赖

📦 安装与构建

1️⃣ 克隆项目

git clone https://github.com/your-username/PortDetection.git
cd PortDetection

2️⃣ 安装依赖

# 安装前端依赖
npm install

3️⃣ 开发模式

# 启动开发服务器
npm run tauri dev

4️⃣ 生产构建

# 构建可执行文件
npm run tauri build

📁 构建产物位于 src-tauri/target/release/ 目录。

📂 项目结构

PortDetection/
├── 📁 src/                       # 前端源码
│   ├── 📁 components/            # React 组件
│   │   ├── PortTable.tsx         # 端口列表表格
│   │   ├── PortSearch.tsx        # 端口搜索组件
│   │   ├── ProcessDetail.tsx     # 进程详情面板
│   │   └── ReservedPorts.tsx     # 保留端口展示
│   ├── 📁 hooks/                 # 自定义 Hooks
│   ├── 📁 lib/                   # 工具函数
│   ├── 📁 styles/                # 样式文件
│   ├── App.tsx                   # 应用入口组件
│   └── main.tsx                  # 应用启动入口
├── 📁 src-tauri/                 # Rust 后端源码
│   ├── 📁 src/
│   │   ├── 📁 commands/          # Tauri 命令
│   │   │   ├── port.rs           # 端口相关命令
│   │   │   ├── process.rs        # 进程相关命令
│   │   │   └── monitor.rs        # 监控相关命令
│   │   ├── 📁 core/              # 核心业务逻辑
│   │   │   ├── port_scanner.rs   # 端口扫描器
│   │   │   └── monitor.rs        # 端口监控器
│   │   ├── 📁 models/            # 数据模型
│   │   │   ├── port_info.rs      # 端口信息结构
│   │   │   ├── process_info.rs   # 进程信息结构
│   │   │   └── error.rs          # 错误类型定义
│   │   ├── 📁 platform/          # 平台特定实现
│   │   │   └── 📁 windows/       # Windows 平台
│   │   │       ├── tcp_table.rs  # TCP 连接表
│   │   │       ├── udp_table.rs  # UDP 连接表
│   │   │       ├── process.rs    # 进程操作
│   │   │       └── reserved_ports.rs  # 保留端口
│   │   ├── 📁 utils/             # 工具模块
│   │   ├── lib.rs                # 库入口
│   │   └── main.rs               # 应用入口
│   ├── Cargo.toml                # Rust 依赖配置
│   └── tauri.conf.json           # Tauri 配置
├── package.json                  # 前端依赖配置
├── tailwind.config.js            # Tailwind 配置
├── vite.config.ts                # Vite 配置
└── tsconfig.json                 # TypeScript 配置

📖 使用说明

🎯 基本操作

1. 🚀 启动应用 - 双击运行 PortDetection.exe
2. 👀 查看端口 - 主界面展示当前所有活动端口及占用进程
3. 🔍 搜索端口 - 在搜索框输入端口号或进程名进行过滤
4. 📋 查看详情 - 点击表格行查看进程详细信息
5. 🔒 查看保留端口 - 切换到保留端口标签查看系统保留范围

⚠️ 权限说明

应用需要管理员权限才能获取完整的进程信息和端口映射。建议以管理员身份运行以获得最佳体验。

🔧 开发命令

# 🔥 开发模式（热重载）
npm run tauri dev

# 📦 前端构建
npm run build

# 🏗️ 生产构建
npm run tauri build

# 🌐 仅运行前端开发服务器
npm run dev

📄 许可证

MIT License

🤝 贡献

欢迎提交 Issue 和 Pull Request！