Verbindungen und Startfenster
Gespeicherte Verbindungen im Startfenster finden, öffnen und ordnen, die Schnellverbindung nutzen und Verbindungen anlegen, bearbeiten oder löschen.
Auf dieser Seite
- Das Startfenster
- Die Seitenleiste
- Die Verbindungsliste
- Verbindungskarten
- Eine Verbindung öffnen
- Aktionen auf der Karte
- Eine Verbindung löschen
- Suchen und filtern
- Schnellverbindung
- Das Menü der Seite
- Eine Verbindung anlegen
- Der Verbindungsdialog
- Tabs
- Gemeinsame Felder
- Eine Verbindung bearbeiten
- Wo Zugangsdaten gespeichert werden
Das Startfenster ist deine Zentrale in der Mac-App von kaiport. Hier stehen alle gespeicherten Verbindungen – SSH-Server und Dateispeicher –, und hier öffnest, findest, ordnest und bearbeitest du sie. Diese Seite erklärt das Fenster, die Verbindungskarten und den Verbindungsdialog, den alle Verbindungsarten gemeinsam haben. Die Felder der einzelnen Arten beschreiben die jeweiligen Seiten.
Das Startfenster
Beim Start zeigt kaiport das Startfenster. Ist unter Einstellungen → Terminal die Option Sitzung wiederherstellen an und waren beim Beenden Terminalfenster offen, öffnet kaiport stattdessen diese Fenster wieder.
Öffnest du eine Verbindung, öffnet kaiport dafür ein Terminalfenster und schließt das Startfenster. Zurück kommst du über das Haus-Symbol (Startseite) in der Tableiste eines Terminalfensters oder mit ⌘⇧H. Schließt du das letzte Terminalfenster, erscheint das Startfenster von selbst wieder.
Die Seitenleiste
| Eintrag | Funktion |
|---|---|
| Verbindungen (Connections) | Zeigt die Verbindungsliste. Die Zahl daneben zählt deine gespeicherten Verbindungen. |
| Einstellungen | Alle Einstellungen der App, auch kaiport Pro. Siehe Einstellungen. |
| Gruppen | Ein Eintrag pro Gruppe. Ein Klick zeigt nur die Verbindungen dieser Gruppe. Die Überschrift erscheint, sobald eine Verbindung eine Gruppe hat. |
| Tags | Ein Eintrag pro Tag. Ein Klick zeigt nur die Verbindungen mit diesem Tag. |
Die Seitenleiste ist immer zu sehen. Unten steht die Version von kaiport, die du gerade nutzt.
Die Verbindungsliste
Die Kopfzeile zeigt, wie viele Verbindungen du gespeichert hast. Darunter folgen die Schnellverbindung, das Suchfeld und deine Verbindungen, sortiert in Abschnitte:
- Favoriten – die Verbindungen mit Stern.
- Ein Abschnitt pro Gruppe, alphabetisch sortiert.
- Ohne Gruppe – Verbindungen ohne Gruppe. Diese Überschrift erscheint nur, wenn es weitere Abschnitte gibt.
Ein Favorit steht nur unter Favoriten, nicht zusätzlich in seiner Gruppe. Innerhalb eines Abschnitts stehen die zuletzt genutzten Verbindungen oben.
Solange du noch keine Verbindung gespeichert hast, zeigt die Liste eine Begrüßung mit zwei Schritten – SSH-Verbindung anlegen und AI Pilot einrichten – und die Schaltfläche Importieren …. Siehe Schnellstart.
Verbindungskarten
Jede Verbindung erscheint als Karte:
- Der Avatar trägt die Farbe der Verbindung. SSH-Verbindungen zeigen die Initialen ihres Namens, Speicherverbindungen ein Symbol für ihre Art.
- Der Name und darunter die Adresse, etwa
deploy@web-01.example.com:2222(der Port erscheint nur, wenn er vom Standard abweicht) oderbackups · s3.eu-central-1.wasabisys.comfür einen S3-Bucket. - Badges mit den wichtigsten Einstellungen.
- Die letzte Verbindung: Gerade eben, vor 5 Min., vor 2 Std., vor 3 Tagen, nach einer Woche das Datum oder Noch nie verbunden.
| Badge | Bedeutung |
|---|---|
| Passwort, Schlüssel | So meldet sich eine SSH-Verbindung an. Eine importierte Verbindung kann auch Agent zeigen; die Mac-App unterstützt keinen SSH-Agent, wähl dafür einen Schlüssel oder ein Passwort. |
| FTP, FTPS, S3, WebDAV, Azure | Die Art einer Speicherverbindung. |
| Jump | Die Verbindung läuft über einen Jump-Host. |
| 2 Tunnel | Die Zahl der Regeln für Port-Weiterleitungen. |
| Deine Tags | Bis zu drei Tags der Verbindung. |
Eine Verbindung öffnen
Klicke auf eine Karte oder steuere sie mit Tab an und drücke Enter. Was sich öffnet, hängt von der Art ab:
- SSH: ein Terminalfenster mit der Sitzung in einem Tab. Siehe Terminal.
- FTP / FTPS, S3-Speicher, WebDAV und Azure Blob: ein Tab mit der Übertragungsansicht – links ein Ordner auf deinem Mac, rechts der Speicher.
Jede Verbindung, die du aus dem Startfenster öffnest, bekommt ein eigenes Terminalfenster. Innerhalb eines Terminalfensters öffnest du weitere Verbindungen als Tabs – über die Verbindungsauswahl eines neuen Tabs oder die Befehlspalette.
Aktionen auf der Karte
Zeigst du mit der Maus auf eine Karte, erscheinen ihre Aktionen:
- Der Stern macht die Verbindung zum Favoriten oder nimmt die Markierung zurück (Favorit / Favorit entfernen).
- Die Schaltfläche … (Aktionen) öffnet ein Menü:
| Aktion | Funktion |
|---|---|
| Verbinden | Öffnet die Verbindung wie ein Klick auf die Karte. |
| Bearbeiten | Öffnet den Verbindungsdialog. |
| Duplizieren | Legt eine Kopie namens „… (Kopie)“ mit allen Einstellungen und den gespeicherten Zugangsdaten an. Die Kopie gilt als noch nie verbunden. |
| Löschen | Löscht die Verbindung nach einer Rückfrage. |
Eine Verbindung löschen
- Wähle im Menü … der Karte Löschen oder klicke im Verbindungsdialog unten links auf Löschen.
- kaiport fragt Verbindung löschen? und nennt die Verbindung. Bestätige mit Löschen.
Suchen und filtern
Das Suchfeld über der Liste erscheint, sobald du mindestens eine Verbindung gespeichert hast. Es filtert schon beim Tippen und durchsucht:
- den Namen,
- den Host (bei WebDAV die Server-URL),
- den Benutzernamen,
- die Gruppe,
- die Tags.
Um nach Gruppe oder Tag zu filtern, klicke in der Seitenleiste darauf. Der aktive Filter erscheint als Chip neben dem Suchfeld. Mit dem × auf dem Chip (Filter entfernen) oder einem erneuten Klick auf denselben Eintrag in der Seitenleiste hebst du ihn wieder auf. Eine Gruppe, ein Tag und ein Suchbegriff lassen sich kombinieren.
Passt nichts, zeigt die Liste Keine Treffer und die Schaltfläche Filter zurücksetzen, die Suche, Gruppe und Tag auf einmal zurücksetzt.
Schnellverbindung
Mit der Schnellverbindung öffnest du eine SSH-Sitzung, ohne vorher eine Verbindung zu speichern.
- Gib das Ziel in Schnellverbindung (Quick connect) ein, etwa
admin@192.0.2.10oderdeploy@web-01.example.com:2222. - Drücke Enter oder klicke auf Verbinden.
- Gib das Passwort ein, wenn kaiport danach fragt.
| Eingabe | Ergebnis |
|---|---|
benutzer@host | Verbindet mit Port 22. |
benutzer@host:2222 | Verbindet mit Port 2222. |
host | Verbindet als root mit Port 22. |
ssh benutzer@host -p 2222 | Auch ein eingefügter ssh-Befehl mit -p funktioniert. |
Die Schnellverbindung meldet sich immer mit Passwort an, und die Prüfung des Host-Schlüssels gilt wie gewohnt. Die Verbindung wird nicht gespeichert und taucht nicht in der Liste auf. Kann kaiport deine Eingabe nicht lesen, erscheint Format: benutzer@host[:port]. Um einen Server zu behalten, lege ihn über Neue Verbindung an.
Das Menü der Seite
Die Schaltfläche … (Aktionen) neben Neue Verbindung hat zwei Einträge:
| Eintrag | Funktion |
|---|---|
| Importieren … | Öffnet den Import-Assistenten. Siehe Import und Export. |
| Exportieren | Speichert alle Verbindungen in einer JSON-Datei. Siehe Verbindungen exportieren. |
Eine Verbindung anlegen
- Klicke auf Neue Verbindung (New connection).
- Wähle unter Verbindungsart eine Kachel: SSH, FTP / FTPS, S3-Speicher, WebDAV oder Azure Blob.
- Fülle die Felder im Tab Allgemein aus.
- Stelle bei Bedarf weitere Optionen in den Tabs Erweitert und KI ein.
- Klicke auf Anlegen.
Die Art lässt sich später nicht mehr ändern; die Kacheln erscheinen nur beim Anlegen. Fehlt beim Klick auf Anlegen ein Pflichtfeld, wechselt kaiport in den Tab Allgemein und markiert das Feld.
| Art | Felder und Optionen |
|---|---|
| SSH | SSH-Verbindungen |
| FTP / FTPS, S3-Speicher, WebDAV, Azure Blob | Speicherverbindungen |
Der Verbindungsdialog
Derselbe Dialog legt Verbindungen an und bearbeitet sie. Sein Titel lautet Neue Verbindung oder Verbindung bearbeiten.
Tabs
| Tab | Inhalt |
|---|---|
| Allgemein | Die Verbindungsart (nur beim Anlegen), der Name, die Felder der jeweiligen Art sowie Farbe, Tags, Gruppe und Favorit. |
| Erweitert | SSH: Jump-Host, Befehl nach dem Verbinden, Port-Weiterleitungen und Notizen. Speicherverbindungen: Notizen. |
| KI | KI-Anweisungen für diese Verbindung und die Listen verbotener und erlaubter Befehle. Diesen Tab haben nur SSH-Verbindungen. Siehe Freigaben und Sicherheit. |
Gemeinsame Felder
Diese Felder sind bei jeder Verbindungsart gleich:
| Feld | Tab | Beschreibung |
|---|---|---|
| Name | Allgemein | Optional. Bleibt er leer, benennt kaiport die Verbindung nach ihrer Adresse, bei SSH benutzer@host. |
| Farbe | Allgemein | Eine von acht Farben für den Avatar und den Punkt im Tab. |
| Tags | Allgemein | Kommagetrennt, etwa prod, web. Tags erscheinen auf der Karte und in der Seitenleiste. |
| Gruppe | Allgemein | Optional. Eine Gruppe pro Verbindung; kaiport schlägt die Gruppen vor, die du schon nutzt. Jede Gruppe bekommt einen eigenen Abschnitt in der Liste und einen Eintrag in der Seitenleiste. |
| Favorit | Allgemein | Dasselbe wie der Stern auf der Karte. |
| Notizen | Erweitert | Freitext für deine eigenen Hinweise zum Server. |
Eine Verbindung bearbeiten
Wähle im Menü … der Karte Bearbeiten. Geheime Felder bleiben beim Bearbeiten leer. Ist etwas gespeichert, steht es beim Feld, etwa „Ein Passwort ist gespeichert (verschlüsselt). Leer lassen, um es zu behalten.“ Gib nur dann einen neuen Wert ein, wenn du ihn ersetzen willst. Mit Speichern übernimmst du die Änderungen.
Änderungen wirken ab der nächsten Verbindung. Bereits offene Sitzungen behalten die Einstellungen, mit denen sie gestartet sind.
Wo Zugangsdaten gespeichert werden
kaiport speichert deine Verbindungen in connections.json im Datenordner; den Pfad zeigt Einstellungen → Über → Daten. Passwörter, Passphrasen, private Schlüssel und Secret Keys darin sind mit einem Schlüssel verschlüsselt, den der macOS-Schlüsselbund schützt.
Unter Einstellungen → Über → Verschlüsselung steht Systemschlüsselbund (safeStorage), wenn das funktioniert. Steht dort Nicht verfügbar – Secrets werden nur kodiert gespeichert, erreicht kaiport den Schlüsselbund nicht und kodiert die Zugangsdaten nur.