Zum Inhalt springen
kaiport

Verbindungen und Startfenster

Gespeicherte Verbindungen im Startfenster finden, öffnen und ordnen, die Schnellverbindung nutzen und Verbindungen anlegen, bearbeiten oder löschen.

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.

EintragFunktion
Verbindungen (Connections)Zeigt die Verbindungsliste. Die Zahl daneben zählt deine gespeicherten Verbindungen.
EinstellungenAlle Einstellungen der App, auch kaiport Pro. Siehe Einstellungen.
GruppenEin Eintrag pro Gruppe. Ein Klick zeigt nur die Verbindungen dieser Gruppe. Die Überschrift erscheint, sobald eine Verbindung eine Gruppe hat.
TagsEin 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:

  1. Favoriten – die Verbindungen mit Stern.
  2. Ein Abschnitt pro Gruppe, alphabetisch sortiert.
  3. 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) oder backups · s3.eu-central-1.wasabisys.com fü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.
BadgeBedeutung
Passwort, SchlüsselSo 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, AzureDie Art einer Speicherverbindung.
JumpDie Verbindung läuft über einen Jump-Host.
2 TunnelDie Zahl der Regeln für Port-Weiterleitungen.
Deine TagsBis 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ü:
AktionFunktion
VerbindenÖffnet die Verbindung wie ein Klick auf die Karte.
BearbeitenÖffnet den Verbindungsdialog.
DuplizierenLegt eine Kopie namens „… (Kopie)“ mit allen Einstellungen und den gespeicherten Zugangsdaten an. Die Kopie gilt als noch nie verbunden.
LöschenLöscht die Verbindung nach einer Rückfrage.

Eine Verbindung löschen

  1. Wähle im Menü … der Karte Löschen oder klicke im Verbindungsdialog unten links auf Löschen.
  2. 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.

  1. Gib das Ziel in Schnellverbindung (Quick connect) ein, etwa admin@192.0.2.10 oder deploy@web-01.example.com:2222.
  2. Drücke Enter oder klicke auf Verbinden.
  3. Gib das Passwort ein, wenn kaiport danach fragt.
EingabeErgebnis
benutzer@hostVerbindet mit Port 22.
benutzer@host:2222Verbindet mit Port 2222.
hostVerbindet als root mit Port 22.
ssh benutzer@host -p 2222Auch 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.

Die Schaltfläche … (Aktionen) neben Neue Verbindung hat zwei Einträge:

EintragFunktion
Importieren …Öffnet den Import-Assistenten. Siehe Import und Export.
ExportierenSpeichert alle Verbindungen in einer JSON-Datei. Siehe Verbindungen exportieren.

Eine Verbindung anlegen

  1. Klicke auf Neue Verbindung (New connection).
  2. Wähle unter Verbindungsart eine Kachel: SSH, FTP / FTPS, S3-Speicher, WebDAV oder Azure Blob.
  3. Fülle die Felder im Tab Allgemein aus.
  4. Stelle bei Bedarf weitere Optionen in den Tabs Erweitert und KI ein.
  5. 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.

ArtFelder und Optionen
SSHSSH-Verbindungen
FTP / FTPS, S3-Speicher, WebDAV, Azure BlobSpeicherverbindungen

Der Verbindungsdialog

Derselbe Dialog legt Verbindungen an und bearbeitet sie. Sein Titel lautet Neue Verbindung oder Verbindung bearbeiten.

Tabs

TabInhalt
AllgemeinDie Verbindungsart (nur beim Anlegen), der Name, die Felder der jeweiligen Art sowie Farbe, Tags, Gruppe und Favorit.
ErweitertSSH: Jump-Host, Befehl nach dem Verbinden, Port-Weiterleitungen und Notizen. Speicherverbindungen: Notizen.
KIKI-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:

FeldTabBeschreibung
NameAllgemeinOptional. Bleibt er leer, benennt kaiport die Verbindung nach ihrer Adresse, bei SSH benutzer@host.
FarbeAllgemeinEine von acht Farben für den Avatar und den Punkt im Tab.
TagsAllgemeinKommagetrennt, etwa prod, web. Tags erscheinen auf der Karte und in der Seitenleiste.
GruppeAllgemeinOptional. 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.
FavoritAllgemeinDasselbe wie der Stern auf der Karte.
NotizenErweitertFreitext 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.