# portkill

**Repository Path**: luolip/portkill

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-14
- **Last Updated**: 2026-04-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PortKill - 端口管理工具

PortKill 是一个 Windows 平台下的端口管理工具，基于 Go + Wails + React 开发，提供图形化界面来查看和管理系统中的 TCP 端口占用情况。

## 简介

在日常开发中，经常会遇到端口被占用导致服务无法启动的问题。PortKill 可以帮助你快速查看当前系统中所有处于监听状态的 TCP 端口，并可以方便地关闭占用端口的进程。

## 功能特性

### 1. 端口列表展示
- 自动获取系统中所有处于 LISTENING 状态的 TCP 端口
- 显示协议、端口、本地地址、进程ID、进程名称等信息
- 支持一键刷新端口列表

### 2. 进程搜索
- 支持根据进程名称进行模糊搜索
- 实时过滤，快速定位目标进程

### 3. 端口关闭
- **单个关闭**：点击每行的"关闭"按钮，关闭单个端口对应的进程
- **批量关闭**：输入端口号（多个用逗号分隔），一键关闭多个端口
- **选中关闭**：勾选多个端口后，点击"关闭选中"批量关闭

### 4. 全选操作
- 支持全选/取消全选，方便批量操作

## 界面预览

![PortKill 界面](screenshot.png)

## 使用说明

### 启动程序
直接双击 `portkill.exe` 运行程序，程序会自动请求管理员权限。

### 查看端口列表
程序启动后会自动加载当前系统中所有处于监听状态的 TCP 端口。

### 搜索进程
在搜索框中输入进程名称关键词（如 `svchost`、`chrome`、`server`），表格会实时过滤显示匹配的进程。

### 关闭端口

#### 方式一：单个关闭
点击端口行右侧的橙色"关闭"按钮，即可关闭该端口对应的进程。

#### 方式二：批量关闭
1. 在"输入端口号"输入框中输入要关闭的端口号
2. 多个端口号用逗号分隔，如：`8080,3000,5000`
3. 点击"批量关闭"按钮

#### 方式三：选中关闭
1. 勾选需要关闭的端口（或点击"全选"）
2. 点击"关闭选中 (N)"按钮

## 技术栈

- **后端**：Go
- **前端**：React + Vite
- **框架**：Wails v2
- **平台**：Windows（需要 WebView2 运行时）

## 开发

```bash
# 安装依赖
cd frontend && npm install

# 开发模式
wails dev

# 构建
wails build
```

## 注意事项

1. 程序需要管理员权限运行，以便获取完整的端口信息和关闭进程
2. 关闭系统关键进程可能导致系统不稳定，请谨慎操作
3. 部分系统进程（如 System）占用的端口可能无法关闭

## 许可证

MIT License