Wie Sie das Suchen nach Prozessen über lsof beenden und Ihre Ports aufräumen

Klassische Situation: Sie starten einen lokalen Server und das Terminal spuckt einen schmerzhaft vertrauten Fehler Error: listen EADDRINUSE: address already in use :::3000 aus. Der Worker von gestern wurde nicht ordnungsgemäß beendet, ein Hintergrundprozess hat sich aufgehängt, oder ein Docker-Container hält still und leise den benötigten Socket.

Normalerweise beginnt hier die Routine. Sie öffnen das Terminal, erinnern sich an die lsof -i :3000-Syntax unter macOS oder greppen netstat -ano unter Windows, kopieren die PID und geben kill -9 ein. Wenn Sie ein Dutzend Microservices haben, verwandelt sich das Terminal in einen Friedhof aus sich wiederholenden Befehlen.

Das Projekt PortPal löst dieses kleine, aber hartnäckige Problem. Es ist ein leichtgewichtiges Desktop-Dashboard, das belegte Ports anzeigt, den Stack erkennt und redundante Prozesse mit einem einzigen Button beendet.

Was steckt dahinter und warum Sie es brauchen

Die meisten ähnlichen Utilities sind entweder primitive Wrapper um Systembefehle oder schleppen schweres Electron mit, das einen Gigabyte RAM verbraucht, nur um eine fünfzeilige Liste anzuzeigen.

Die Entwickler von PortPal haben einen angenehmeren Weg gewählt und die Anwendung auf Tauri 2, Rust und React 19 aufgebaut. Dank Rust belastet das Backend die CPU im Hintergrund kaum, und das native Fenster öffnet sich sofort.

Das Tool löst mehrere alltägliche Aufgaben:

• Findet hängende lokale Ports und extrahiert Prozess-Metadaten.
• Erkennt die Umgebung basierend auf dem Dateikontext und Standard-Ports.
• Hilft dabei, einen Prozess zwangsweise zu stoppen oder neu zu starten.
• Visualisiert Netzwerkverbindungen zwischen Diensten als Graphen.

Wichtigste Funktionen

Projekterkennung statt trockener Zahlen

Ein reguläres System-Monitor zeigt Ihnen nur die PID und den Binärnamen (zum Beispiel node oder python). Wenn fünf verschiedene Node.js-Projekte laufen, ist es unmöglich, sie anhand der Terminal-Ausgabe zu unterscheiden.

PortPal arbeitet intelligenter. Es schaut sich nicht nur die Socket-Nummer an, sondern scannt auch Arbeitsverzeichnisse. Das Programm sucht nach Manifest-Dateien (package.json, Cargo.toml, go.mod) und gleicht die Port-Nummer mit populären Entwicklungsumgebungen ab:

3000  -> React / Next.js
5173  -> Vite
4200  -> Angular
8000  -> Django
5432  -> PostgreSQL
6379  -> Redis

Als Ergebnis zeigt das Panel übersichtliche Karten: Sie sehen sofort, dass Ihr Frontend auf Port 5173 läuft und die Datenbank auf 5432 lauscht.

Interaktive Verbindungskarte

Der neugierigste Detail der Oberfläche ist die topologische Karte, die mit der D3.js-Bibliothek erstellt wurde.

Statt einer flachen Tabelle erhalten Sie eine physikalische Simulation mit Knoten. Die Knoten sind nach ihren Technologien eingefärbt: Blau für Datenbanken, Violett für Vite-Bundler, Grün für Node.js-Backend. Die Knoten können über den Bildschirm gezogen, mit dem Mausrad gezoomt werden, und aktive Netzwerkverbindungen können in Echtzeit untersucht werden. Wenn Sie ein System mit mehreren Microservices entwickeln, hilft ein solcher Graph schnell zu verstehen, wer gerade eine Verbindung mit wem hält.

One-Click-Verwaltung und Notfall-Button

Jeder Prozess hat eine Beenden-Schaltfläche daneben. Klicken Sie auf das Kreuz – der Prozess wird sofort beendet, der Socket freigegeben.

Wenn ein Port von einem abgestürzten Script belegt ist, das PortPal sich gemerkt hat, bleibt ein Neustart-Button in der Nähe. Er führt den Befehl erneut in einem separaten Terminal aus.

In der Oberfläche werden Ports in zwei Gruppen unterteilt: Entwicklungsprozesse und Systemdienste. Das versehentliche Beenden eines Systemdienstes ist erschwert. Und für Fälle, in denen Sie Ihren Arbeitstag beendet haben und den gesamten Zoo der laufenden lokalen Server auf einmal schließen möchten, gibt es einen Alle-beenden-Button für die Gruppe der Entwicklungs-Frameworks.

Hintergrundbetrieb und System-Tray

PortPal minimiert sich in den Benachrichtigungsbereich. Das Tray-Symbol ändert seine Farbe abhängig vom Vorhandensein von Port-Konflikten. Während das Fenster geschlossen ist, zeichnet ein Hintergrund-Thread Ereignisse auf: wann ein neuer Prozess hochgefahren wurde, welcher Socket freigegeben wurde und wo ein Verkehrspeak auftrat. Der Verlauf mit allen Zeitstempeln wird auf einem separaten Logs-Tab gespeichert.

Architektur und Stack

Der technische Stack des Projekts sieht modern aus:

Backend:      Rust (sysinfo + системные API сетевого стека)
Runtime:      Tauri 2
Frontend:     React 19 + TypeScript + Vite 7
Графика:      D3.js v7 (симуляция графов на силах)
Стили:        Vanilla CSS со стеклянными эффектами

Durch den Verzicht auf schwere Frontend-Komponentenbibliotheken und die Verwendung von nativem Webview ist die Anwendung leichtgewichtig und beansprucht minimale Ressourcen während des konstanten Socket-Scannens.

Wie Sie es starten

Entwickler veröffentlichen fertige Builds auf der Releases-Seite des Repositories:

• Für Windows sind .msi und .exe verfügbar.
• Für macOS sind Builds .dmg für Apple-Silicon-Chips und Intel-Prozessoren vorbereitet.
• Für Linux gibt es .deb-Pakete und das universelle .AppImage-Format.

Wenn Sie das Utility aus dem Quellcode bauen oder eigene Erkennungsregeln hinzufügen möchten, benötigen Sie Rust Version 1.70 oder höher und Node.js 18+:

# Клонируем репозиторий
git clone https://github.com/wisher567/Portpal.git
cd portpal

# Ставим зависимости и запускаем в dev-режиме
npm install
npm run tauri dev

Im Dev-Modus funktioniert Hot-Reloading der React-Komponenten über Vite parallel zur Kompilierung des Rust-Teils.

Persönliche Eindrücke

Das Projekt ist jung, derzeit in Version 0.2, aber es sieht bereits wie ein einsatzbereites Alltagswerkzeug aus. Die grundlegende Port-Tabelle und Karten funktionieren schnell. Die D3.js-Karte wirkt anfänglich wie Dekoration, aber beim gleichzeitigen Debuggen eines API-Gateways, einer Datenbank und ein paar Clients erweist sie sich als genuin hilfreich.

Geringfügige Nachteile umfassen die begrenzte Datenbank für die automatische Framework-Erkennung. Wenn Sie einen benutzerdefinierten Dienst auf einem nicht-standardmäßigen Port wie 92211 ausführen, zeigt PortPal ihn als regulären Prozess an, bis Sie den Kontext manuell binden. Da das Projekt jedoch Open Source unter der MIT-Lizenz ist, ist das Hinzufügen zur Signaturliste im Code unkompliziert.

Wer es nützlich finden wird: Webentwickler, Full-Stack-Ingenieure und alle, die regelmäßig ein Dutzend lokaler Microservices jonglieren und es leid sind, Socket-Bereinigungsbefehle auswendig zu lernen.