Verbindung via SFTP: FileZilla, Cyberduck und Kommandozeile

SFTP (Secure File Transfer Protocol) gibt dir direkten Zugriff auf die Dateien deiner Website auf dem Server. Diese Anleitung behandelt alles, was du für eine erfolgreiche Verbindung brauchst, von der Suche nach deinen Anmeldedaten bis zur Fehlerbehebung.

Was SFTP ist und wann man es nutzt

Der in KPanel integrierte Dateimanager ist praktisch für schnelle Bearbeitungen: Umbenennen einer Datei, Anzeigen einer Konfiguration oder das Hochladen eines einzelnen Assets. SFTP ist das richtige Werkzeug, wenn du mehr brauchst:

• Hochladen oder Herunterladen großer Mengen von Dateien auf einmal (Migration einer Website, Massen-Upload von Bildern).
• Übertragung großer Dateien, die bei einem Browser-basierten Upload zu Timeouts führen würde.
• Arbeit im Rahmen eines Entwicklungs-Workflows, bei dem du Dateien lokal bearbeitest und Änderungen hochlädst.
• Verwendung eines GUI-Clients, mit dem du einen lokalen und Remote-Ordner synchronisiert halten kannst.
• Zugriff auf Logs oder Konfigurationsdateien, die nicht über KPanel's Dateimanager verfügbar sind.

SFTP verschlüsselt alle Daten während der Übertragung, was es sicherer macht als das unverschlüsselte FTP. KapsuleHost bietet keine unverschlüsselten FTP-Verbindungen an.

Voraussetzungen

Bevor du verbinden kannst, brauchst du zwei Dinge.

1. Ein SSH-Schlüssel, der in deiner Website in KPanel hinzugefügt wurde.

SFTP auf KapsuleHost verwendet SSH-Schlüssel-Authentifizierung. Passwort-Authentifizierung ist aus Sicherheitsgründen deaktiviert. Wenn du deinen öffentlichen SSH-Schlüssel noch nicht hinzugefügt hast, folge zunächst der Anleitung SSH-Schlüssel zu deiner Website hinzufügen, und kehre dann hierher zurück.

2. Dein Site-Benutzername.

Jede Website auf KapsuleHost hat einen dedizierten Systembenutzer. Dies ist nicht deine KPanel-E-Mail-Adresse. Es ist ein kurzer Benutzername, der speziell an diese Website gebunden ist.

So findest du ihn:

1. Melde dich bei KPanel unter kpanel.kapsulehost.com an.
2. Klicke auf Websites in der linken Seitenleiste.
3. Klicke auf die Website, mit der du dich verbinden möchtest.
4. Gehe zur Seite SSH / SFTP.
5. Dein Site-Benutzername wird oben auf diesem Tab angezeigt. Er sieht typischerweise wie mysite_com oder myexamplesite_net aus.

Verbindungsdetails auf einen Blick:

---

Verbindung mit FileZilla

FileZilla ist ein kostenloses, plattformübergreifendes SFTP-Programm für Windows, macOS und Linux. Lade es von filezilla-project.org herunter, falls du es noch nicht hast.

Schritt-für-Schritt-Anleitung

1. Öffne FileZilla.

2. Gehe zu File > Site Manager (oder drücke Ctrl+S unter Windows / Cmd+S auf Mac).

3. Klicke auf Add Website und gib ihm einen Namen (zum Beispiel "Meine Kapsule-Website").

4. Konfiguriere auf dem Tab General die folgenden Felder:

   Feld	Wert
   Protocol	SFTP - SSH File Transfer Protocol
   Host	cp1-kapsule.kapsulehost.com
   Port	22
   Logon Type	Key file
   User	Dein Site-Benutzername (zum Beispiel mysite_com)
   Key file	Klicke auf Browse und navigiere zu deiner privaten Schlüsseldatei

5. Wähle für die Schlüsseldatei den privaten Schlüssel, der dem öffentlichen Schlüssel entspricht, den du in KPanel hinzugefügt hast. Auf macOS und Linux werden private Schlüssel typischerweise in ~/.ssh/ gespeichert (zum Beispiel ~/.ssh/id_ed25519 oder ~/.ssh/id_rsa). Unter Windows befinden sie sich oft in C:\Users\YourName\.ssh\.

1. Klicke auf Connect, um die Verbindung zu testen, oder klicke auf OK, um zu speichern und später zu verbinden.

Speichern und erneutes Verbinden

Nach dem Speichern im Site Manager kannst du dich jederzeit erneut verbinden, indem du zu File > Site Manager gehst und auf Connect klickst. FileZilla zeigt deine gespeicherten Websites auch in der Dropdown-Liste in der Symbolleiste für schnellen Zugriff an.

---

Verbindung mit Cyberduck

Cyberduck ist ein kostenloses SFTP-Programm für macOS und Windows. Lade es von cyberduck.io herunter.

Schritt-für-Schritt-Anleitung

1. Öffne Cyberduck.

2. Klicke auf Open Connection (das Globus-Symbol in der Symbolleiste).

3. Wähle aus der Protokoll-Dropdown-Liste oben im Dialog SFTP (SSH File Transfer Protocol).

4. Fülle die Verbindungsfelder aus:

   Feld	Wert
   Server	cp1-kapsule.kapsulehost.com
   Port	22
   Username	Dein Site-Benutzername (zum Beispiel mysite_com)
   Password	Leer lassen
   SSH Private Key	Klicke auf Choose und wähle deine private Schlüsseldatei

5. Klicke auf Connect.

Bei der ersten Verbindung wird dich Cyberduck auffordern, den Host-Key-Fingerabdruck des Servers zu überprüfen. Klicke auf Allow, um fortzufahren. Wenn diese Aufforderung bei einer nachfolgenden Verbindung mit einem anderen Fingerabdruck angezeigt wird, akzeptiere ihn nicht und kontaktiere den Support, da dies auf eine Konfigurationsänderung hindeuten könnte.

Als Lesezeichen speichern

So speicherst du die Verbindung für die zukünftige Verwendung:

1. Nach erfolgreicher Verbindung gehe zu Bookmark > New Bookmark (oder drücke Cmd+Shift+B auf Mac).
2. Gib dem Lesezeichen einen Namen und schließe das Dialog-Fenster. Das Lesezeichen erscheint in deiner Cyberduck-Lesezeichenliste.

---

Verbindung vom Terminal (Mac, Linux oder WSL)

Wenn du die Befehlszeile bevorzugst, ist der sftp-Befehl unter macOS, Linux und Windows Subsystem for Linux (WSL) verfügbar.

Grundlegende Verbindung

sftp mysite_com@cp1-kapsule.kapsulehost.com

Ersetze mysite_com durch deinen tatsächlichen Site-Benutzernamen. Wenn dein privater Schlüssel nicht am Standardort liegt (~/.ssh/id_rsa oder ~/.ssh/id_ed25519), gib ihn mit dem -i-Flag an:

sftp -i ~/.ssh/your_private_key mysite_com@cp1-kapsule.kapsulehost.com

Bei der ersten Verbindung wirst du aufgefordert, den Host-Fingerabdruck des Servers zu bestätigen. Gib yes ein und drücke Enter. Dies geschieht nur einmal pro Schlüssel pro Gerät.

Nützliche SFTP-Befehle

Nach der Verbindung siehst du eine sftp>-Eingabeaufforderung. Verwende diese Befehle zum Navigieren und Übertragen von Dateien:

Beispiel: Herunterladen einer Datei

sftp> cd htdocs/wp-content/themes
sftp> get my-theme.zip

Beispiel: Hochladen einer Datei

sftp> lcd ~/Desktop
sftp> cd htdocs/wp-content/uploads
sftp> put my-image.jpg

---

Wo deine Dateien sind

Nach der Verbindung landest du im Home-Verzeichnis deines Site-Benutzers: /home/[siteuser]/.

Die Verzeichnisstruktur sieht wie folgt aus:

/home/mysite_com/
├── htdocs/              ← Your web root (main location for site files)
│   ├── index.php
│   ├── wp-config.php
│   ├── wp-content/
│   │   ├── themes/
│   │   ├── plugins/
│   │   └── uploads/
│   └── ...
├── logs/                ← PHP and access logs
└── tmp/                 ← Temporary files

Das Web-Root-Verzeichnis, in dem deine WordPress (oder andere Anwendung) lebt, ist htdocs/. Dies ist das Verzeichnis, in dem du die meiste Zeit verbringst. Bei einigen Site-Konfigurationen kann es auch public_html/ heißen. Wenn du dich verbindest und public_html/ statt htdocs/ siehst, nutze dieses.

---

Fehlerbehebung bei Verbindungsproblemen

"Connection refused" (Verbindung abgelehnt)

Die Verbindung wurde aktiv abgelehnt, bevor sie hergestellt wurde.

Überprüfung: Stelle sicher, dass du Host cp1-kapsule.kapsulehost.com und Port 22 verwendest. Ein häufiger Fehler ist die Eingabe von Port 21 (das ist FTP, nicht SFTP) oder ein Tippfehler im Hostnamen.

"Permission denied (publickey)" (Berechtigung verweigert - öffentlicher Schlüssel)

Der Server akzeptierte den Verbindungsversuch, lehnte aber deine Authentifizierung ab.

Überprüfe folgende Punkte:

• Dein öffentlicher SSH-Schlüssel ist in KPanel > Websites > [Website] > SSH / SFTP hinzugefügt. Wenn er dort nicht aufgelistet ist, hat der Server keinen Datensatz darüber.
• Du hast den richtigen privaten Schlüssel in FileZilla/Cyberduck ausgewählt, insbesondere den privaten Schlüssel, der mit dem öffentlichen Schlüssel gekoppelt ist, den du zu KPanel hinzugefügt hast.
• Wenn dein Schlüssel eine Passphrase hat, stelle sicher, dass du diese korrekt eingibst.
• Wenn du mehrere Schlüssel hast, überprüfe, dass du nicht versehentlich den falschen auswählst.

"Host key verification failed" (Host-Schlüssel-Überprüfung fehlgeschlagen)

Dein SFTP-Client hat zuvor einen anderen Host-Schlüssel für diesen Hostnamen gesehen und warnt dich vor einem Mismatch.

Beim ersten Verbindungsaufbau: Du wirst aufgefordert, den Fingerabdruck zu akzeptieren. Das ist normal. Klicke auf Accept oder gib yes ein.

Bei einer nachfolgenden Verbindung mit einem neuen Fingerabdruck: Dies kann auf eine Konfigurationsänderung auf dem Server hindeuten. Kontaktiere den Support unter support@kapsulehost.com, bevor du akzeptierst, und erwähne, was du gesehen hast.

Um einen alten Host-Schlüssel im Terminal zu löschen, bearbeite ~/.ssh/known_hosts und entferne die Zeile für cp1-kapsule.kapsulehost.com.

"Could not read from remote repository" oder falsches Verzeichnis

Du hast möglicherweise deine KPanel-E-Mail-Adresse als Benutzernamen statt deines Site-Benutzernamens verwendet.

Überprüfung: Der Benutzername muss dein Site-Benutzername sein (zum Beispiel mysite_com), nicht deine E-Mail-Adresse. Finde den richtigen Benutzernamen in KPanel > Websites > [Website] > SSH / SFTP.

Verbindungs-Timeout

Der Verbindungsversuch hängt und zeitgeht dann aus, ohne einen Fehler zu zeigen.

Mögliche Ursachen:

• Deine IP-Adresse kann von Kapsule's Firewall aufgrund wiederholter fehlgeschlagener Login-Versuche vorübergehend blockiert sein. Kontaktiere den Support unter support@kapsulehost.com und bitte ihn, das Firewall-Log zu überprüfen.
• Eine lokale Firewall oder ein VPN in deinem Netzwerk blockkt möglicherweise ausgehende Verbindungen auf Port 22. Versuche dich von einem anderen Netzwerk (zum Beispiel mobiler Hotspot) zu verbinden, um dies auszuschließen.

---

Verwandte Artikel

• SSH-Schlüssel zu deiner Website hinzufügen
• Verwendung des Dateimanagers in KPanel
• Verbindung zu deiner Datenbank über SSH-Tunnel