
PortReaper:Mac 上查看端口对应项目与 Git 分支并一键结束
来源标题:Show HN: PortReaper – see which project and git branch holds each port on a Mac
PortReaper 是一款 macOS 应用,可列出所有监听端口,并显示每个端口背后的项目名和 Git 分支,支持一键结束进程。目前为 v0.5,支持 Apple Silicon 与 Intel,已签名公证并支持自动更新,可通过 ⌘⇧K 快速释放被占端口。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
EADDRINUSE,⌘⇧K,输入 3000,回车。开发服务器启动。
PortReaper 是一个小型 macOS 应用,列出机器上每一个正在监听的端口,标出每个端口背后的项目和 git 分支,一键杀掉对应进程。它常驻 Dock 和菜单栏。你看到的不再是 node 48213,而是 shop-api · feature/cart · vite。
状态:v0.5,macOS(Universal:Apple Silicon 与 Intel)。使用 Apple Developer ID 签名、已公证、支持自动更新。
编码 agent 会留下还在运行的东西。Claude Code 或 Cursor 会话结束后,它的开发服务器、MCP 服务器、Playwright 浏览器和测试 worker 往往还留在那里。每次端口被占用,我都要跑 lsof -i :3000,然后 kill。那些不占端口的进程根本不会出现在 lsof -i 的结果里。我想看到每个进程属于哪个项目、哪个分支,并且一个按键就把它释放掉。于是我做了 PortReaper。
3000 端口被占用,你不知道是被什么占的。在任意应用里按 ⌘⇧K。一条浮层会出现在你当前正在做的事情之上,最可能挡你路的端口已经预先选中:先是终端已经关掉的开发服务器,然后是 PortReaper 一分钟前释放、又被别的进程抢走的端口,最后是最近启动的开发服务器。输入 3 把它缩小到 :3000(输入进程名或项目名也可以),按 ↵。进程先收到 SIGTERM,最多 3 秒关闭套接字,然后收到 SIGKILL。浮层显示 Freed :3000 · node (48213),约 180 毫秒后消失,焦点回到你的终端。
⌥↵ 立即发送 SIGKILL。受保护的进程(数据库、Docker、系统守护进程、可能再次启动的 launchd 任务)会要求再按一次 ↵。Esc 逐级退回:解除待确认状态、清空查询、隐藏浮层。
模拟数据,来自浏览器构建(pnpm dev),1040×660。用 pnpm screenshot 重新生成;docs/screenshot-dark.png 是同一个窗口的深色版本;docs/screenshot-quick.png 是 ⌘⇧K 浮层。
PortReaper 与你本来会用的工具对比:LeftOpen(一个按项目列出 TCP 监听器的 macOS 应用)、终端里的 lsof -i 和 kill、kill-port npm 包,以及活动监视器。LeftOpen 也做了一些 PortReaper 没有的功能:通过 Portless 提供固定的 *.localhost URL、"Copy Setup Prompt for AI"、音效,以及中文翻译。使用 sudo 时,lsof 还能完整看到其他用户的进程;PortReaper 从不请求 sudo,只能显示内核允许普通用户看到的那部分。
对比于 2026-11-17 依据 LeftOpen v0.5.8 的 README 和源码进行,2026-11-19 依据上述其他工具的 README 进行。欢迎指正:开一个 issue。
Homebrew
brew install --cask amitgal45/tap/portreaper
每次发布都会更新 cask,cask 固定 DMG 的 SHA-256。
首次启动下载的构建。从 0.3.0 起,应用使用 Apple Developer ID 签名并已公证:它像其他应用一样直接打开。0.2.x 的构建只做了 ad-hoc 签名,所以 macOS 第一次会显示"Apple could not verify PortReaper"并且不打开它。点击 Done,然后进入系统设置 → 隐私与安全性 → 向下滚动到"PortReaper was blocked" → 仍要打开(每次安装一次;在 macOS 15 上右键 → 打开已不再有效)。如果 macOS 反而说应用"已损坏"(0.2.1 之前的构建),清除下载标记再打开:
xattr -cr /Applications/PortReaper.app
下载最新版本的 .dmg:一个 universal 构建(PortReaper_<version>_universal.dmg)在 Intel 和 Apple Silicon Mac 上都能运行。或者从源码构建(Xcode Command Line Tools、Rust stable 1.85+、Node 24、pnpm 11)。克隆仓库,然后:
pnpm install pnpm tauri build --bundles app open src-tauri/target/release/bundle/macos/PortReaper.app
CI(.github/workflows/ci.yml)会为每次推送到 main 和每个 pull request 构建一个未签名的 .app;从 workflow 运行记录中下载(PortReaper-macos-unsigned)。
PortReaper 会自我更新。每个版本都发布在 GitHub Releases 上,附带一个 latest.json;应用在启动十秒后以及每六小时读取该文件,发现有新版本时会在对话框中("Update & relaunch" / "Later")和侧边栏中("PortReaper 0.3.0 is ready · Update")提示。更新包经过签名(minisign,通过 Tauri 的 updater),并在安装前用内置在应用中的公钥验证;验证不通过的包会被拒绝,当前运行的版本保持不变。要手动检查,打开菜单栏图标并选择"Check for Updates…"。检查只是对该文件的一次 GET 请求,不携带任何身份信息;在没有可查找的版本期间,应用保持安静。
pnpm tauri dev # 应用,带热重载 pnpm dev # 仅 UI,在浏览器中,对接 mock core pnpm check # Biome、vue-tsc、Vitest pnpm e2e # Playwright(WebKit、Chromium),对接 mock core cargo test --manifest-path src-tauri/Cargo.toml # Rust 核心(会打开真实套接字,只杀自己启动的子进程) pnpm icons # 从 design/*.svg 重新生成所有图标
工作原理
Rust 核心(Tauri 2)用 listeners crate 读取监听套接字,用 sysinfo 读取进程详情,从每个进程的工作目录向上查找项目清单和 .git/HEAD,并根据端口号和命令行对端口分类。同一个核心把每次 kill 记录进 Taskline,并记住命令和目录以便 Relaunch,因此窗口、浮层和菜单栏看到的是同一份历史。一个 Vue 3 窗口在可见时每 2 秒向核心请求一次列表,并把 kill 请求发回去;src-tauri/src/model.rs 和 src/types.ts 是两者之间的契约。外观描述见 design/README.md。
应用签名了吗?
从 0.3.0 起,是的:Developer ID Application、hardened runtime、经 Apple 公证并 stapled,所以下载的构建首次启动即可打开。在此基础上,更新还会用内置在应用中的 minisign 公钥验证(见 Updates)。你自己构建的应用是 ad-hoc 签名的,在你自己的 Mac 上正常打开。0.2.x 的下载在首次启动时会被拒绝:打开系统设置 → 隐私与安全性,点击"仍要打开",或者运行
xattr -dr com.apple.quarantine PortReaper.app
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。