ctresb/portero - 仓库详情

AI 仓库情报摘要

FR-AI / ANALYSIS

为什么值得关注

它解决了开发者经常忘记自己启动了哪些服务的问题，用人类可读的描述替代晦涩的二进制名称，并且利用 macOS 原生防火墙而不修改系统文件——全部免费开源，基于 Tauri/Rust 构建。

适合谁使用

同时管理多个项目的 macOS 开发者
监控本地服务的系统管理员
调试端口冲突的 DevOps 工程师
希望快速屏蔽端口的安全爱好者

典型使用场景

当遇到 'address already in use' 时快速定位占用端口的进程
优雅或强制杀死遗忘了的开发服务器以释放端口
出于安全测试目的屏蔽端口的入站/出站流量
从应用内一键打开本地 HTTP 服务器到浏览器

项目优势

为数百种常见进程和知名端口提供通俗解释
实时冲突检测，并可筛选出冲突进程
内置 macOS pf 防火墙集成，从不修改系统文件
基于 Tauri 2、Rust 和 React，原生性能且体积小巧

使用前须知

尚未使用 Apple Developer 证书签名，首次启动需右键→打开
pf 防火墙规则重启后失效（需在设置中手动重新应用）
仓库尚未指定许可证

README 快速开始

Website · Download · FAQ

Why

When you're working on multiple projects at the same time, it's easy to lose track of what's running. A database here, a dev server there, an API you forgot was still open... before long, your ports become a mess.

Portero gives you a clear view of everything running on your machine, so you always know what's using each port, can stop what you don't need, and get back to building instead of debugging port conflicts.

What it does

Live port list. Every listening TCP and UDP port, refreshed automatically, with process name, PID, address, protocol, user, and start time.
Plain-language explanations. Portero recognizes hundreds of common processes, dev tools, and well-known ports, and tells you what each one actually is: "Vite dev server", "PostgreSQL database", "AirDrop and sharing", instead of a cryptic binary name.
Categories. Processes are grouped into System, Apps, Terminal (dev servers you started), and Other, so you can tell at a glance what is safe to touch.
Kill processes. End a process gracefully (SIGTERM) or force it (SIGKILL) when it refuses to die. Select several rows and kill them all at once.
Conflict detection. When more than one process listens on the same port (the classic "address already in use"), Portero flags it and lets you filter straight to the conflicts.
Block ports. Block inbound and/or outbound traffic on any port using the built-in macOS firewall (pf). Rules live in a dedicated anchor, no system files are edited.
Open in browser. When a port answers HTTP (a frontend or dev server), a globe button appears to open it directly in your browser.
Favorites. Star a process to protect it. Favorited processes cannot be killed until you unstar them.
Search, filter, and sort by port, process, path, command line, or PID.
Two languages. English and Portuguese, switchable in Settings.

Install

Grab the latest .dmg for your Mac (Apple Silicon or Intel) from the Releases page, open it, and drag Portero to Applications.

Builds are not signed with an Apple Developer certificate yet. The first time you open the app, right-click it in Applications and choose Open.

How to use

Open Portero. The table shows every listening port on your machine.
Click a row to expand it and see the full command line, working dir

portero