# portscan

**Repository Path**: fpin3k/portscan

## Basic Information

- **Project Name**: portscan
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-28
- **Last Updated**: 2025-08-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 跨系统端口占用检查工具

一个基于Python和Tkinter的跨平台端口扫描工具，支持主机系统、WSL和Docker环境的端口检测。

## 功能特性

- 🖥️ 支持主机系统端口扫描
- 🐧 支持WSL环境端口检测
- 🐳 支持Docker容器端口映射检查
- 🎯 多线程并发扫描，提高效率
- 📊 图形化界面，操作简单直观
- 📋 结果导出功能

## 环境要求

- Python 3.8+
- uv (推荐的包管理器)

## 安装和运行

### 使用uv管理项目

1. 安装uv（如果尚未安装）：

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

2. 克隆或下载项目到本地

3. 进入项目目录：

```bash
cd port_scan
```

4. 使用uv创建虚拟环境并安装依赖：

```bash
uv sync
```

5. 运行程序：

```bash
uv run python main.py
```

### 开发环境

安装开发依赖：

```bash
uv sync --dev
```

运行代码格式化：

```bash
uv run black .
```

运行代码检查：

```bash
uv run flake8 .
```

运行类型检查：

```bash
uv run mypy main.py
```

## 使用说明

1. **环境选择**：选择要扫描的环境（主机系统/WSL/Docker）
2. **目标设置**：输入目标主机IP地址
3. **端口范围**：设置要扫描的端口范围
4. **线程数**：调整并发线程数以优化扫描速度
5. **开始扫描**：点击开始扫描按钮
6. **查看结果**：在结果区域查看开放的端口信息

## 注意事项

- WSL模式需要安装并配置WSL
- Docker模式需要安装Docker并确保容器正在运行
- 扫描大范围端口时建议适当调整线程数
- 某些系统可能需要管理员权限才能获取完整的进程信息

## 许可证

MIT License