Verbinding via SFTP: FileZilla, Cyberduck en Command Line

SFTP (Secure File Transfer Protocol) geeft je directe toegang tot de bestanden van je site op de server. Deze gids behandelt alles wat je nodig hebt om succesvol verbinding te maken, van het vinden van je inloggegevens tot het oplossen van fouten.

Wat is SFTP en wanneer moet je het gebruiken

De bestandsbeheerder die in KPanel is ingebouwd, is handig voor snelle bewerkingen: het hernoemen van een bestand, het bekijken van een configuratie, of het uploaden van één bestand. SFTP is het juiste hulpmiddel wanneer je meer nodig hebt:

• Het uploaden of downloaden van grote aantallen bestanden tegelijk (migratie van een site, bulk-uploaden van afbeeldingen).
• Het overdragen van grote bestanden die een time-out zouden veroorzaken bij een upload via een browser.
• Werken als onderdeel van een ontwikkelingswerkstroom waarbij je bestanden lokaal bewerkt en wijzigingen pusht.
• Het gebruik van een GUI-client waarmee je een lokale en externe map synchroon kunt houden.
• Toegang tot logbestanden of configuratiebestanden die niet worden blootgesteld via de bestandsbeheerder van KPanel.

SFTP versleutelt alle gegevens in transit, wat het veiliger maakt dan gewone FTP. KapsuleHost biedt geen onversleutelde FTP-verbindingen.

Vereisten

Voordat je verbinding kunt maken, moet je twee dingen gereed hebben.

1. Een SSH-sleutel die aan je site in KPanel is toegevoegd.

SFTP op KapsuleHost maakt gebruik van SSH-sleutelauthenticatie. Wachtwoordauthenticatie is uit veiligheidsoverwegingen uitgeschakeld. Als je je openbare SSH-sleutel nog niet hebt toegevoegd, volg eerst de gids SSH-sleutels toevoegen aan je site en kom dan hier terug.

2. Je sitegebruikersnaam.

Elke site op KapsuleHost heeft een toegewijde systeemgebruiker. Dit is niet je KPanel-e-mailadres. Het is een korte gebruikersnaam die specifiek aan die site is gekoppeld.

Dit vind je als volgt:

1. Log in op KPanel via kpanel.kapsulehost.com.
2. Klik op Websites in de linkernavigatie.
3. Klik op de site waarmee je verbinding wilt maken.
4. Ga naar de pagina SSH / SFTP.
5. Je sitegebruikersnaam wordt bovenaan dit tabblad weergegeven. Het ziet er meestal uit als mysite_com of myexamplesite_net.

Verbindingsgegevens in één oogopslag:

---

Verbinding maken met FileZilla

FileZilla is een gratis, cross-platform SFTP-client voor Windows, macOS en Linux. Download het van filezilla-project.org als je het nog niet hebt.

Stapsgewijze installatie

1. Open FileZilla.

2. Ga naar File > Site Manager (of druk op Ctrl+S in Windows / Cmd+S op Mac).

3. Klik op Add Website en geef het een naam (bijvoorbeeld "Mijn Kapsule-site").

4. Configureer op het tabblad General de volgende velden:

   Veld	Waarde
   Protocol	SFTP - SSH File Transfer Protocol
   Host	cp1-kapsule.kapsulehost.com
   Port	22
   Logon Type	Key file
   User	Je sitegebruikersnaam (bijvoorbeeld mysite_com)
   Key file	Klik op Browse en navigeer naar je privésleutelbestand

5. Selecteer voor het sleutelbestand de privésleutel die overeenkomt met de openbare sleutel die je in KPanel hebt toegevoegd. Op macOS en Linux worden privésleutels meestal opgeslagen in ~/.ssh/ (bijvoorbeeld ~/.ssh/id_ed25519 of ~/.ssh/id_rsa). Op Windows bevinden ze zich vaak in C:\Users\YourName\.ssh\.

1. Klik op Connect om de verbinding te testen, of klik op OK om op te slaan en later verbinding te maken.

Opslaan en opnieuw verbinden

Zodra je bent opgeslagen in Site Manager, kun je op elk moment opnieuw verbinding maken door naar File > Site Manager te gaan en op Connect te klikken. FileZilla toont je opgeslagen sites ook in het vervolgkeuzemenu op de werkbalk voor snelle toegang.

---

Verbinding maken met Cyberduck

Cyberduck is een gratis SFTP-client voor macOS en Windows. Download het van cyberduck.io.

Stapsgewijze installatie

1. Open Cyberduck.

2. Klik op Open Connection (het aardbolpictogram op de werkbalk).

3. Selecteer in het protocolkeuzevak bovenaan het dialoogvenster SFTP (SSH File Transfer Protocol).

4. Vul de verbindingsvelden in:

   Veld	Waarde
   Server	cp1-kapsule.kapsulehost.com
   Port	22
   Username	Je sitegebruikersnaam (bijvoorbeeld mysite_com)
   Password	Leeg laten
   SSH Private Key	Klik op Choose en selecteer je privésleutelbestand

5. Klik op Connect.

Bij de eerste verbinding vraagt Cyberduck je de hostsleutelvingerafdruk van de server te verifiëren. Klik op Allow om door te gaan. Als je dit verzoek bij een volgende verbinding met een ander vingerafdruk ziet, accepteer het niet en neem contact op met ondersteuning, omdat het kan duiden op een configuratiewijziging.

Opslaan als bladwijzer

Om de verbinding voor toekomstig gebruik op te slaan:

1. Nadat u met succes verbinding hebt gemaakt, gaat u naar Bladwijzer > Nieuwe bladwijzer (of druk op Cmd+Shift+B op Mac).
2. Geef de bladwijzer een naam en sluit het dialoogvenster. De bladwijzer verschijnt in uw Cyberduck-bladwijzerlijst.

---

Verbinding maken vanuit Terminal (Mac, Linux of WSL)

Als u liever de opdrachtregel gebruikt, is de sftp opdracht beschikbaar op macOS, Linux en Windows Subsystem for Linux (WSL).

Basisverbinding

sftp mysite_com@cp1-kapsule.kapsulehost.com

Vervang mysite_com door uw werkelijke sitenaam. Als uw persoonlijke sleutel zich niet op de standaardlocatie bevindt (~/.ssh/id_rsa of ~/.ssh/id_ed25519), geeft u deze op met de -i vlag:

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

Bij de eerste verbinding wordt u gevraagd de hostfingerafdruk van de server te bevestigen. Typ yes en druk op Enter. Dit gebeurt slechts eenmaal per sleutel per apparaat.

Nuttige SFTP-opdrachten

Na verbinding ziet u een sftp> prompt. Gebruik deze opdrachten om te navigeren en bestanden over te dragen:

Voorbeeld: een bestand downloaden

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

Voorbeeld: een bestand uploaden

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

---

Waar uw bestanden zich bevinden

Na verbinding belandt u in de thuismap van uw sitgebruiker: /home/[siteuser]/.

De mapstructuur ziet er als volgt uit:

/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

De webroot waar uw WordPress (of andere toepassing) zich bevindt, is htdocs/. Dit is de map waar u het meeste tijd doorbrengt. Bij sommige siteconfiguraties kan deze ook public_html/ worden genoemd. Als u verbinding maakt en public_html/ ziet in plaats van htdocs/, gebruikt u die.

---

Verbindingsproblemen oplossen

"Verbinding geweigerd"

De verbinding werd actief geweigerd voordat deze tot stand kwam.

Controleer: Controleer of u host cp1-kapsule.kapsulehost.com en poort 22 gebruikt. Een veelgemaakte fout is het invoeren van poort 21 (dit is FTP, niet SFTP) of een typfout in de hostnaam.

"Toestemming geweigerd (openbare sleutel)"

De server accepteerde de verbindingspoging maar weigerde uw authenticatie.

Controleer elk van het volgende:

• Uw openbare SSH-sleutel is toegevoegd in KPanel > Websites > [site] > SSH / SFTP. Als deze daar niet is vermeld, heeft de server er geen verslag van.
• U hebt de juiste persoonlijke sleutel in FileZilla/Cyberduck geselecteerd, specifiek de persoonlijke sleutel die overeenkomt met de openbare sleutel die u aan KPanel hebt toegevoegd.
• Als uw sleutel een wachtwoordzin heeft, zorg ervoor dat u deze correct invoert.
• Als u meerdere sleutels hebt, bevestig dan dat u niet per ongeluk de verkeerde selecteert.

"Hostsleutelverificatie mislukt"

Uw SFTP-client heeft eerder voor deze hostnaam een ander hostsleutel gezien en waarschuwt u voor een verschil.

Bij de eerste verbinding: U wordt gevraagd de fingerafdruk te accepteren. Dit is normaal. Klik Accepteren of typ yes.

Bij een volgende verbinding met een nieuwe fingerafdruk: Dit kan wijzen op een configuratiewijziging op de server. Neem contact op met support via support@kapsulehost.com voordat u accepteert, en vermeld wat u zag.

Om een oude hostsleutel in de terminal te wissen, bewerkt u ~/.ssh/known_hosts en verwijdert u de regel voor cp1-kapsule.kapsulehost.com.

"Kon niet lezen uit externe repository" of Verkeerde map

Mogelijk hebt u uw KPanel e-mailadres gebruikt als gebruikersnaam in plaats van uw sitenaam.

Controleer: De gebruikersnaam moet uw sitenaam zijn (bijvoorbeeld mysite_com), niet uw e-mailadres. Zoek de juiste gebruikersnaam in KPanel > Websites > [site] > SSH / SFTP.

Verbinding verloopt

De verbindingspoging hangt vast en verloopt daarna zonder foutmelding.

Mogelijke oorzaken:

• Uw IP-adres kan tijdelijk worden geblokkeerd door Kapsule's firewall vanwege herhaalde mislukte aanmeldpogingen. Neem contact op met support via support@kapsulehost.com en vraag hen het firewalllogbestand te controleren.
• Een lokale firewall of VPN op uw netwerk kan uitgaande verbindingen op poort 22 blokkeren. Probeer uit een ander netwerk (bijvoorbeeld mobiele hotspot) om dit uit te sluiten.

---

Gerelateerde artikelen

• SSH-sleutels aan uw site toevoegen
• De bestandsbeheerder in KPanel gebruiken
• Verbinding maken met uw database via SSH-tunnel