Połączenia FTP potrafią zawodzić. Zawodzą przy pierwszej konfiguracji, zawodzą po miesiącach działania bez zarzutu i zawodzą w sposób, który daje enigmatyczne komunikaty o błędach. Ten przewodnik omawia najczęstsze błędy połączeń FTP i SFTP na Macu oraz sposoby ich naprawy.
Przekroczenie limitu czasu połączenia
Próbujesz się połączyć i nic się nie dzieje. Po 30–60 sekundach pojawia się błąd przekroczenia limitu czasu.
Najczęstsze przyczyny:
- Zapora sieciowa blokuje połączenie (zapora Maca, router lub zapora serwera).
- Używasz aktywnego trybu FTP zamiast pasywnego. Tryb aktywny wymaga, żeby serwer połączył się z powrotem do Twojego Maca — co większość routerów NAT i zapór sieciowych blokuje.
- Nieprawidłowa nazwa hosta lub adres IP serwera.
- Usługa FTP na serwerze nie jest uruchomiona.
Rozwiązania:
- Przełącz na pasywny tryb FTP. To prawidłowe ustawienie dla niemal wszystkich nowoczesnych połączeń.
- Sprawdź zaporę Maca: Ustawienia systemowe > Sieć > Zapora. Upewnij się, że Twoja aplikacja FTP jest dozwolona.
- Zweryfikuj nazwę hosta przez ping w Terminalu:
ping ftp.przyklad.pl - Spróbuj połączyć się inną aplikacją (np. poleceniem
sftpw Terminalu), żeby wykluczyć problemy specyficzne dla aplikacji.
Odmowa połączenia
Połączenie jest natychmiast odrzucane, bez oczekiwania.
Najczęstsze przyczyny:
- Zły port. FTP używa portu 21, SFTP portu 22, Implicit FTPS portu 990.
- Usługa FTP/SFTP nie jest uruchomiona na serwerze.
- Zapora serwera jawnie blokuje Twój adres IP.
Rozwiązania:
- Dokładnie sprawdź numer portu. To najczęstsza przyczyna tego błędu.
- Potwierdź u dostawcy serwera, że FTP/SFTP jest włączone.
- Zapytaj, czy Twój adres IP musi znajdować się na białej liście.
530 Login incorrect (Błędne dane logowania)
Połączenie nawiązujesz pomyślnie, ale logowanie jest odrzucane.
Najczęstsze przyczyny:
- Błędna nazwa użytkownika lub hasło. Kopiowanie i wklejanie czasem dodaje niewidoczne spacje lub znaki końca linii.
- Konto istnieje, ale nie jest włączone dla dostępu FTP (niektóre panele hostingowe wymagają oddzielnego włączenia FTP).
- Rozróżnianie wielkości liter. Niektóre serwery traktują nazwy użytkowników jako wrażliwe na wielkość liter.
Rozwiązania:
- Wpisz dane uwierzytelniające ręcznie zamiast wklejać.
- Zaloguj się do panelu sterowania hostingiem i sprawdź, czy konto FTP jest aktywne.
- Spróbuj połączyć się przez Terminal, żeby zobaczyć dokładną odpowiedź serwera:
ftp ftp.przyklad.pl
425 Nie można otworzyć połączenia danych
Logujesz się pomyślnie, ale listowanie plików lub transfery kończą się błędem 425.
Najczęstsze przyczyny:
- Niezgodność trybu aktywnego i pasywnego. Serwer nie może ustanowić kanału danych.
- Dla FTPS: błędy ponownego użycia sesji TLS między połączeniami sterowania i danych.
Rozwiązania:
- Przełącz na tryb pasywny.
- Dla FTPS wypróbuj tryb Explicit na porcie 21 zamiast Implicit na porcie 990 lub odwrotnie.
- Niektóre serwery wymagają określonych wersji TLS. Spróbuj ograniczyć do TLS 1.2, jeśli dostępne w ustawieniach klienta.
Błąd uzgadniania SSL/TLS
Dotyczy połączeń FTPS. Negocjacja szyfrowania kończy się niepowodzeniem.
Najczęstsze przyczyny:
- Certyfikat SSL serwera wygasł.
- Łączysz się zwykłym FTP do portu oczekującego FTPS lub odwrotnie.
- Niezgodność wersji TLS. Serwer wymaga TLS 1.2, ale klient próbuje TLS 1.0.
- Certyfikat własnoręcznie podpisany, któremu klient nie ufa.
Rozwiązania:
- Upewnij się, że wybrałeś FTPS (nie zwykły FTP) w ustawieniach połączenia.
- Wypróbuj zarówno tryb Explicit, jak i Implicit FTPS.
- Jeśli serwer używa certyfikatu własnoręcznie podpisanego, sprawdź, czy klient ma opcję jego zaakceptowania.
- Skontaktuj się z administratorem serwera, żeby zweryfikować ważność certyfikatu i poprawność konfiguracji wersji TLS.
Weryfikacja klucza hosta nie powiodła się (SFTP)
Dotyczy SFTP. Mac odmawia połączenia, ponieważ klucz SSH serwera nie pasuje do oczekiwanego.
Najczęstsze przyczyny:
- Serwer został przeinstalowany lub jego klucze SSH zostały wygenerowane ponownie.
- Łączysz się po raz pierwszy i włączone jest ścisłe sprawdzanie hosta.
- Potencjalny atak man-in-the-middle (rzadki, ale po to jest to ostrzeżenie).
Rozwiązania:
- Jeśli wiesz, że serwer był przeinstalowany, usuń stary klucz:
ssh-keygen -R nazwa_hosta - Połącz ponownie i zaakceptuj nowy klucz po wyświetleniu monitu.
- Jeśli nie spodziewałeś się zmiany klucza, zweryfikuj z administratorem serwera przed zaakceptowaniem.
Odmowa dostępu
Łączysz się i logujesz, ale nie możesz czytać plików, zapisywać plików ani uzyskiwać dostępu do pewnych katalogów.
Najczęstsze przyczyny:
- Twój użytkownik FTP nie ma uprawnień do odczytu/zapisu w docelowym katalogu.
- Własność katalogu na serwerze nie pasuje do Twojego użytkownika FTP.
- Ograniczenia chroot/jail uniemożliwiają nawigowanie poza katalogiem domowym.
Rozwiązania:
- Skontaktuj się z administratorem serwera, żeby zweryfikować uprawnienia konta.
- Sprawdź, czy ścieżka zdalna w kliencie FTP jest prawidłowa i dostępna dla Twojego użytkownika.
- Na serwerach, które kontrolujesz, zweryfikuj uprawnienia katalogu:
ls -la /sciezka/do/katalogu
Problemy specyficzne dla macOS
Kilka rzeczy specyficznych dla macOS:
- macOS usunął wbudowany serwer FTP od High Sierra (10.13). Jeśli potrzebujesz serwera FTP na Macu, będziesz potrzebować oprogramowania firm trzecich.
- Aktualizacje macOS mogą zepsuć SFTP. Główne aktualizacje (zwłaszcza Monterey) były zgłaszane jako przerywające łączność SFTP dla aplikacji takich jak Cyberduck i Transmit. Ponowne uruchomienie Maca lub zresetowanie konfiguracji SSH zazwyczaj rozwiązuje problem.
- Ostrzeżenia Gatekeepera mogą uniemożliwić otwarcie nowo pobranych aplikacji FTP. Kliknij aplikację prawym przyciskiem myszy i wybierz Otwórz, lub przejdź do Ustawień systemowych > Prywatność i bezpieczeństwo, żeby ją zezwolić.