为什么值得关注

完全本地运行，无遥测、云服务、Web视图或 HTTP 服务器；通过在执行停止操作前严格验证进程身份来确保安全边界；避免文件系统扫描以减少延迟和隐私暴露。

适合谁使用

运行本地 Web 服务器或开发后端的开发者
管理多个开发环境的系统管理员
注重隐私和安全、希望无需额外服务即可控制网络监听器的用户
对本地优先、尊重隐私的工具感兴趣的 Rust 爱好者

典型使用场景

从系统托盘快速停止卡住的开发服务器
识别哪些本地端口正在被使用以及由哪个进程占用
安全终止监听器而无需强制杀死无关进程
无需打开完整应用窗口即可监控监听中的 TCP 端点

项目优势

完全用 Rust 编写，无重型框架，资源占用极低
每次停止操作前验证 PID、启动时间、端点所有权和分类
不扫描文件系统，减少延迟和隐私暴露
优先支持 Windows，并附有清晰的构建和验证步骤文档

使用前须知

初始版本仅支持 Windows（不支持 macOS 或 Linux）
v0.1.0 可执行文件未签名，需手动比对 SHA-256 校验和
因 Windows 缺少对任意外部控制台服务器的安全 SIGTERM，使用强制停止警告

README 快速开始

Harry Porter

Harry Porter is a minimal, local-first system-tray utility that shows listening development ports and lets you stop their verified owning processes.

It is Windows-first and written entirely in Rust. There is no application window, React frontend, webview, Node.js runtime, drive crawl, account, cloud service, telemetry, or local HTTP control server.

What it does

reads structured listening TCP records from the operating system;
inspects only the unique processes that own those listeners;
groups ports as Development, Other/unknown, or System/protected;
hides system and infrastructure services by default without hiding uncertain processes;
marks listeners that accept connections from other devices;
refreshes every ten seconds, on demand, and when the tray is clicked;
verifies PID, start time, endpoint ownership, user scope, and classification immediately before any stop action;
attempts graceful stop where the platform safely supports it;
requires a separate review and confirmation before force stop;
rescans the endpoint and reports the observed result.

Harry Porter does not scan Git projects or the C: drive. Filesystem crawling would add latency and privacy exposure without proving which projects are actually listening.

Build and run

Prerequisites:

Rust stable;
on Windows, the MSVC Rust toolchain, Microsoft C++ Build Tools, and a Windows SDK.

Run the debug tray process:

cargo run -p harry-porter

Build the optimized executable:

cargo build --release -p harry-porter

The Windows executable is:

target/release/harry-porter.exe

Click the tray icon with either mouse button to open the native menu. No normal application window is created.

Download v0.1.0

The first release is a portable, unsigned Windows x86_64 build:

Harry Porter v0.1.0

Extract the ZIP and run harry-porter.exe. Compare the archive against the published SHA-256 checksum before running it. Windows may warn about the unsigned executable. macOS is not included in v0.1.0 because its native tray and process-control path has not yet been verified on macOS hardware.

Verify

cargo fmt --all -- --check
cargo test --workspace
cargo clippy --workspace --all-targets -- -D warnings

The Windows integration suite creates

项目描述

A minimal system-tray tools to manage your local server

Harry-porter