FTP-verbindingen mislukken. Ze mislukken bij de eerste configuratie, ze mislukken na maanden prima te hebben gewerkt, en ze mislukken op manieren die je cryptische foutmeldingen geven. Deze gids behandelt de meest voorkomende FTP- en SFTP-verbindingsfouten die je op Mac tegenkomt en hoe je ze oplost.
Verbinding verlopen (timeout)
Je probeert verbinding te maken en er gebeurt niets. Na 30-60 seconden krijg je een timeout-fout.
Veelvoorkomende oorzaken:
- Een firewall blokkeert de verbinding (de firewall van je Mac, je router of de firewall van de server).
- Je gebruikt Active FTP-modus terwijl je Passive modus nodig hebt. Active modus vereist dat de server terugverbindt naar je Mac, wat de meeste NAT-routers en firewalls blokkeren.
- De hostnaam of het IP-adres van de server is onjuist.
- De FTP-service van de server draait niet.
Oplossingen:
- Schakel over naar Passive FTP-modus. Dit is de juiste instelling voor vrijwel alle moderne verbindingen.
- Controleer de firewall van je Mac: Systeeminstellingen > Netwerk > Firewall. Zorg ervoor dat je FTP-app is toegestaan.
- Verifieer de hostnaam door deze te pingen in Terminal:
ping ftp.example.com - Probeer verbinding te maken met een andere app (zoals het
sftp-commando in Terminal) om app-specifieke problemen uit te sluiten.
Verbinding geweigerd
De verbinding wordt onmiddellijk geweigerd, zonder wachten.
Veelvoorkomende oorzaken:
- Verkeerde poort. FTP gebruikt poort 21, SFTP gebruikt poort 22, Implicit FTPS gebruikt poort 990.
- De FTP/SFTP-service draait niet op de server.
- De firewall van de server blokkeert expliciet je IP.
Oplossingen:
- Controleer het poortnummer. Dit is de meest voorkomende oorzaak.
- Bevestig bij je serverprovider dat FTP/SFTP is ingeschakeld.
- Vraag of je IP op een whitelist moet worden gezet.
530 Login incorrect
Je maakt succesvol verbinding, maar de login wordt geweigerd.
Veelvoorkomende oorzaken:
- Verkeerde gebruikersnaam of wachtwoord. Kopieer-plakken voegt soms onzichtbare spaties of regeleinden toe.
- Het account bestaat maar is niet ingeschakeld voor FTP-toegang (sommige hostingpanelen vereisen afzonderlijke activering van FTP).
- Hoofdlettergevoeligheid. Sommige servers behandelen gebruikersnamen als hoofdlettergevoelig.
Oplossingen:
- Typ de inloggegevens handmatig in in plaats van te plakken.
- Log in op je hosting-configuratiescherm en verifieer dat het FTP-account actief is.
- Probeer verbinding te maken via Terminal om de exacte serverreactie te zien:
ftp ftp.example.com
425 Kan dataverbinding niet openen
Je logt succesvol in, maar bestandslijsten of overdrachten mislukken met een 425-fout.
Veelvoorkomende oorzaken:
- Active vs Passive-modus mismatch. De server kan het datakanaal niet opzetten.
- Voor FTPS: TLS-sessiehergebruikfouten tussen controle- en dataverbindingen.
Oplossingen:
- Schakel over naar Passive modus.
- Probeer voor FTPS Explicit modus op poort 21 in plaats van Implicit op poort 990, of andersom.
- Sommige servers vereisen specifieke TLS-versies. Probeer te beperken tot TLS 1.2 als dat beschikbaar is in je clientinstellingen.
SSL/TLS-handshake mislukt
Specifiek voor FTPS-verbindingen. De versleutelingsonderhandeling mislukt.
Veelvoorkomende oorzaken:
- Het SSL-certificaat van de server is verlopen.
- Je verbindt met gewoon FTP naar een poort die FTPS verwacht, of andersom.
- TLS-versiemismatch. De server vereist TLS 1.2 maar je client probeert TLS 1.0.
- Zelfondertekend certificaat dat je client niet vertrouwt.
Oplossingen:
- Zorg ervoor dat je FTPS (niet gewoon FTP) hebt geselecteerd in je verbindingsinstellingen.
- Probeer zowel Explicit als Implicit FTPS-modus.
- Als de server een zelfondertekend certificaat gebruikt, controleer of je client een optie heeft om het te accepteren.
- Neem contact op met de serverbeheerder om te verifieren dat het certificaat geldig is en TLS-versies correct zijn geconfigureerd.
Verificatie van hostsleutel mislukt (SFTP)
Specifiek voor SFTP. Je Mac weigert verbinding te maken omdat de SSH-sleutel van de server niet overeenkomt met wat verwacht wordt.
Veelvoorkomende oorzaken:
- De server is opnieuw geinstalleerd of zijn SSH-sleutels zijn opnieuw gegenereerd.
- Je verbindt voor de eerste keer en strikte hostcontrole is ingeschakeld.
- Mogelijke man-in-the-middle aanval (zeldzaam, maar dit is waarvoor de waarschuwing bedoeld is).
Oplossingen:
- Als je weet dat de server opnieuw is geinstalleerd, verwijder de oude sleutel:
ssh-keygen -R hostname - Maak opnieuw verbinding en accepteer de nieuwe sleutel wanneer daarom wordt gevraagd.
- Als je geen sleutelwijziging verwachtte, verifieer dan bij de serverbeheerder voordat je accepteert.
Toegang geweigerd
Je maakt verbinding en logt in, maar kunt geen bestanden lezen, bestanden schrijven of bepaalde mappen openen.
Veelvoorkomende oorzaken:
- Je FTP-gebruiker heeft geen lees-/schrijfrechten op de doelmap.
- Het eigenaarschap van de map op de server komt niet overeen met je FTP-gebruiker.
- Chroot/jail-beperkingen verhinderen dat je buiten je homedirectory navigeert.
Oplossingen:
- Neem contact op met de serverbeheerder om de rechten van je account te verifieren.
- Controleer of het externe pad in je FTP-client correct is en toegankelijk voor je gebruiker.
- Op servers die je beheert, verifieer de maprechten:
ls -la /path/to/directory
Mac-specifieke problemen
Een paar zaken specifiek voor macOS:
- macOS heeft zijn ingebouwde FTP-server verwijderd vanaf High Sierra (10.13). Als je een FTP-server op je Mac nodig hebt, heb je software van derden nodig.
- macOS-updates kunnen SFTP breken. Grote upgrades (vooral Monterey) zijn gemeld als oorzaak van SFTP-verbindingsproblemen voor apps als Cyberduck en Transmit. Je Mac opnieuw opstarten of de SSH-configuratie resetten lost het meestal op.
- Gatekeeper-waarschuwingen kunnen verhinderen dat nieuw gedownloade FTP-apps worden geopend. Klik met de rechtermuisknop op de app en selecteer Openen, of ga naar Systeeminstellingen > Privacy en beveiliging om het toe te staan.