Biały ekran. Panel administracyjny nie ładuje się. Wtyczka, którą właśnie Pan/Pani aktywował/a, położyła całą witrynę. A support hostingu odpowiada raz na trzy godziny. Znajomy obrazek?

FTP w takich momentach to jedyny kanał, przez który można sięgnąć do plików witryny i przywrócić ją do życia. Problem w tym, że właściciele witryn WordPress rzadko wchodzą na serwer przez FTP w czasie pokoju. A gdy zdarzy się awaria, zaczyna się panika i szukanie „jak połączyć się z FTP" w trzech kartach przeglądarki.

W rzeczywistości połączyć się jest prościej niż skonfigurować pocztę w telefonie. Pięć minut i jest Pan/Pani wewnątrz systemu plików serwera z pełną kontrolą nad każdym folderem i każdym plikiem php. Bez paniki: oto algorytm od instalacji klienta po przesyłanie plików i awaryjne odzyskiwanie.

💡 Szybki przegląd:

• Zainstaluj FileZilla (darmowy klient FTP dla Windows, macOS i Linux) lub otwórz wbudowany File Manager w panelu hostingu, jeśli potrzebna jest jednorazowa operacja.
• Utwórz konto FTP w cPanel (lub odpowiedniku): login, hasło, powiązanie z katalogiem witryny. Dane do połączenia pojawią się natychmiast po utworzeniu.
• Połącz się z serwerem: host (domena lub IP), port 22 dla SFTP. Znajdź folder public_html (katalog główny WordPress) i przeciągaj pliki między komputerem a serwerem.
• Jeśli przesłany przez FTP plik multimedialny nie wyświetla się w bibliotece WordPress, zarejestruj go przez wtyczkę Media Sync lub Add From Server Reloaded. Samo przesłanie do folderu uploads nie dodaje pliku do bazy danych.

Do czego FTP właścicielowi witryny WordPress

FTP (File Transfer Protocol) to protokół sieciowy do przesyłania plików między komputerem a serwerem. Pojawił się na długo przed WordPress: RFC 959, opisujący specyfikację FTP, został wydany w 1985 roku. Dziś protokół ma ponad 40 lat, ale nadal jest wbudowany w każdy hosting i każdy panel sterowania jako podstawowy transport.

Cztery scenariusze, w których FTP jest niezastąpiony:

• Biały ekran śmierci (WSOD). Aktywował/a Pan/Pani wtyczkę lub motyw, witryna przestała się otwierać wraz z panelem administracyjnym. Wchodzi Pan/Pani przez FTP do /wp-content/plugins/, zmienia nazwę folderu problematycznego rozszerzenia, witryna ożywa w kilka sekund.
• Edycja wp-config.php i.htaccess. Błąd w tych plikach kładzie witrynę bez dostępu do panelu administracyjnego. FTP to jedyny sposób, by poprawić je bezpośrednio.
• Przesyłanie dużych plików. Webowy uploader WordPress napotyka limit 2-8 MB (w zależności od hostingu). FTP pozwala przesyłać pliki o dowolnym rozmiarze.
• Ręczna instalacja rdzenia, motywów i wtyczek. Przesłać świeży WordPress, motyw lub wtyczkę bezpośrednio, z pominięciem panelu administracyjnego, na przykład gdy wbudowany instalator nie radzi sobie z rozmiarem archiwum zip.

Ważna kwestia: przed jakimikolwiek operacjami przez FTP proszę wykonać kopię zapasową witryny. Jeśli coś pójdzie nie tak, cofnie Pan/Pani zmiany kilkoma kliknięciami.

Jak wybrać klienta FTP

Do połączenia z serwerem potrzebny jest program, klient FTP. Pod Windows, macOS i Linux jest wybór, a większość opcji jest darmowa.

Do 99% zadań wystarczy FileZilla. Jest darmowy, działa na wszystkich systemach i ma minimalny próg wejścia. Proszę pobierać tylko z oficjalnej strony, na zewnętrznych agregatorach często dodawane są reklamowe śmieci.

Alternatywa bez instalacji, File Manager w cPanel (lub odpowiednik w Pana/Pani panelu hostingu: hPanel, ISPmanager, DirectAdmin). Jest już na serwerze, otwiera się z przeglądarki i do jednorazowego przesłania pliku w zupełności wystarczy.

Krok 1. Utwórz konto FTP

Proszę wejść do panelu sterowania hostingiem. Znaleźć sekcję „Konta FTP" lub „FTP Accounts". Kliknąć „Utwórz", system zapyta o trzy rzeczy:

• Login. Proszę wymyślić nazwę, na przykład mysite_admin. Stanie się ona częścią adresu: mysite_admin@ваш-домен.com.
• Hasło. Proszę wygenerować silne (20+ znaków) i zapisać w menedżerze haseł. Nie używać admin123, konta FTP są regularnie atakowane brute-force.
• Katalog. Zazwyczaj /public_html (katalog główny witryny). Jeśli pozostawi Pan/Pani pole pustym, konto uzyska dostęp do całego systemu plików konta hostingowego, dla bezpieczeństwa lepiej ograniczyć do konkretnego folderu.

Po utworzeniu zobaczy Pan/Pani dane do połączenia: host, login, port. Proszę je skopiować.

Hostem najczęściej jest Pana/Pani domena (na przykład ftp.vashsite.com) lub adres IP serwera. Jeśli hosting wysyłał list powitalny, dane FTP zazwyczaj są w nim podane.

Krok 2. Połącz się przez FileZilla

Proszę otworzyć FileZilla i wypełnić pola na górnym pasku:

• Host: ftp.vashsite.com (lub adres IP serwera)
• Nazwa użytkownika: login z kroku 1
• Hasło: hasło z kroku 1
• Port: 21 dla FTP, 22 dla SFTP (zdecydowanie zalecane)

Proszę kliknąć „Szybkie połączenie". W oknie statusu na dole pojawią się logi, ostatni wiersz powinien brzmieć Status: Directory listing of "/" successful. Jest Pan/Pani połączony/a.

Interfejs FileZilla jest podzielony na dwie połowy: po lewej pliki Pana/Pani komputera, po prawej system plików serwera. W prawej części proszę znaleźć folder public_html (na niektórych hostingach nazywa się www lub htdocs), to katalog główny witryny WordPress. Tutaj znajdują się wp-config.php i trzy kluczowe foldery: wp-content, wp-admin oraz wp-includes.

Krok 3. Przesyłanie plików i prawa dostępu

Aby przesłać plik z komputera na serwer, proszę przeciągnąć go z lewego panelu FileZilla do prawego. Lub kliknąć prawym przyciskiem myszy na plik i wybrać „Prześlij na serwer". FileZilla pokazuje postęp i automatycznie wznawia transfer w przypadku przerwania połączenia.

Gdzie co umieścić:

• Wtyczki → wp-content/plugins/название-плагина/
• Motywy → wp-content/themes/название-темы/
• Pliki multimedialne (obrazy, PDF) → wp-content/uploads/год/месяц/, ale WordPress nie zobaczy ich w bibliotece mediów bez dodatkowego kroku (patrz następna sekcja)
• Pliki w katalogu głównym → wp-config.php, .htaccess i robots.txt proszę umieszczać w public_html/

Po przesłaniu proszę sprawdzić uprawnienia (chmod): dla folderów proszę ustawiać 755, dla plików proszę ustawiać 644. W FileZilla robi się to prawym kliknięciem na plik → „Prawa dostępu do pliku". Nieprawidłowe uprawnienia to najczęstsza przyczyna „zepsutych" obrazów i błędów 403 na stronie.

Co zrobić, gdy przesłany plik nie jest widoczny w WordPress

Przesłał Pan/Pani obraz przez FTP do katalogu uploads, ale nie ma go w bibliotece mediów WordPress. To nie błąd: WordPress rejestruje pliki w bazie danych tylko podczas przesyłania przez panel administracyjny. Samo umieszczenie pliku w katalogu nie wystarczy, potrzebny jest wpis w tabelach wp_posts i wp_postmeta.

Trzy rozwiązania, od najprostszego do zaawansowanego:

Pierwsze, wtyczka Media Sync. Media Sync skanuje katalog uploads i dodaje niezarejestrowane pliki do biblioteki mediów. Bezpłatna, z ponad 40 000 aktywnych instalacji i oceną 4,7 na WordPress.org. Po instalacji proszę przejść do „Media → Media Sync", kliknąć „Scan" i wybrać pliki do importu. Sprawdza się, gdy trzeba wciągnąć dziesiątki lub setki plików naraz.

Drugie, Add From Server Reloaded. Add From Server Reloaded dodaje do biblioteki mediów przycisk „Import z serwera". W przeciwieństwie do klasycznego Add From Server (nieaktualizowanego od 6 lat), ta wersja jest aktywnie wspierana i kompatybilna z WordPress 6.7+. Wchodzi Pan/Pani do biblioteki mediów, wskazuje ścieżkę do pliku na serwerze i plik zostaje zarejestrowany. Wygodne, gdy plików jest niewiele i potrzebny jest import punktowy.

Trzecie, WP-CLI. Jeśli radzi sobie Pan/Pani z terminalem, polecenie wp media import <путь-к-файлу> rejestruje plik w bibliotece mediów jedną linijką. Nadaje się do automatyzacji i przetwarzania wsadowego.

Jeśli ma Pan/Pani odwrotny problem, obrazy przesłane przez panel administracyjny nie wyświetlają się na stronie, proszę sprawdzić trzy rzeczy:

• Uprawnienia dostępu. Katalog uploads i wszystkie podkatalogi powinny mieć chmod 755, pliki 644. Nieprawidłowe uprawnienia to najczęstsza przyczyna niewidocznych obrazów.
• Konflikt wtyczek optymalizacyjnych. Proszę tymczasowo wyłączyć Smush, ShortPixel, Imagify lub Jetpack Boost i sprawdzić, czy obrazy się pojawiły. Czasami agresywna optymalizacja psuje ścieżki do plików.
• Pamięć podręczna CDN. Jeśli korzysta Pan/Pani z Cloudflare, BunnyCDN lub StackPath, proszę wyczyścić pamięć podręczną i sprawdzić, czy ustawienia nie blokują bezpośrednich żądań do wp-content/uploads/.

Awaryjne odzyskiwanie strony przez FTP

Najczęstszy scenariusz użycia FTP to odzyskiwanie awaryjne. Oto algorytm krok po kroku na wypadek, gdy strona przestała się otwierać:

• Proszę połączyć się przez FTP i w pierwszej kolejności zmienić nazwę katalogu /wp-content/plugins/ na /wp-content/plugins_disabled/. To wyłączy wszystkie wtyczki za jednym razem.
• Jeśli strona zaczęła działać, problem tkwi we wtyczkach. Proszę przywracać katalogi wtyczek pojedynczo i sprawdzać stronę po każdej, aż znajdzie Pan/Pani winowajcę.
• Nie pomogło, proszę przełączyć się na standardowy motyw. Proszę zmienić nazwę katalogu aktywnego motywu w /wp-content/themes/. WordPress automatycznie przełączy się na motyw domyślny (Twenty Twenty-Six).
• Wciąż nic, proszę sprawdzić .htaccess. Proszę pobrać plik przez FTP, usunąć całą zawartość i wgrać z powrotem pusty plik. Następnie proszę wejść do panelu administracyjnego → Ustawienia → Bezpośrednie odnośniki → „Zapisz zmiany" (WordPress odtworzy .htaccess od nowa).
• Strona nie otwiera się nawet po tym, proszę włączyć WP_DEBUG. Proszę dodać w wp-config.php linie:

1
define('WP_DEBUG', true);
2
define('WP_DEBUG_LOG', true);
3
define('WP_DEBUG_DISPLAY', false);

Błędy zostaną zapisane w /wp-content/debug.log. Proszę sprawdzić logi i szukać źródła problemu.

Ten algorytm rozwiązuje większość sytuacji awaryjnych na WordPress bez kontaktu z pomocą techniczną hostingu i bez paniki.

⁉️🤔 Często zadawane pytania

Co jest bezpieczniejsze, FTP czy SFTP?

SFTP (SSH File Transfer Protocol) szyfruje zarówno login z hasłem, jak i przesyłane pliki. Zwykły FTP przesyła wszystko jawnym tekstem, włącznie z hasłem. Jeśli hosting obsługuje SFTP, proszę używać wyłącznie jego. W FileZilla do przełączenia wystarczy zmienić port z 21 na 22.

Czy można przesyłać pliki całkowicie bez klienta FTP?

Tak. Praktycznie każdy hosting udostępnia File Manager bezpośrednio w panelu sterowania: przesyłanie przez przeglądarkę, zero instalacji. Do zadań jednorazowych jest wystarczający, File Manager nie wymaga konfiguracji i jest już autoryzowany na Pana/Pani koncie. Bardziej hardkorowa opcja to WP-CLI: polecenie wp media import przesyła i rejestruje plik w bibliotece mediów jedną linijką.

Dlaczego FileZilla nie łączy się, błąd „Connection timed out"?

Dwie prawdopodobne przyczyny. Pierwsza: nieprawidłowy port. FTP to port 21, SFTP to port 22. Proszę spróbować obu. Druga: hosting blokuje połączenie po IP. Proszę sprawdzić w panelu hostingu, czy nie jest włączone blokowanie przychodzących połączeń FTP i dodać swój adres IP do białej listy.

Czy można przesłać motyw lub wtyczkę przez FTP, jeśli archiwum waży więcej niż limit hostingu?

Tak, w tym właśnie sens FTP. Limit przesyłania przez panel administracyjny WordPress (zazwyczaj 2-8 MB) nie obowiązuje dla FTP. Proszę rozpakować archiwum na komputerze i wgrać katalog z motywem lub wtyczką odpowiednio do wp-content/themes/ lub wp-content/plugins/. Po tym motyw lub wtyczka pojawią się w panelu administracyjnym.

Czy trzeba wyłączać wtyczki przed przesłaniem plików przez FTP?

Nie. FTP działa na poziomie systemu plików i nie wchodzi w interakcję z WordPress bezpośrednio. Może Pan/Pani przesyłać, usuwać i edytować pliki niezależnie od tego, czy wtyczki są włączone, czy strona w ogóle się nie otwiera, to główna zaleta FTP jako kanału awaryjnego.

Jak poznać swoje dane FTP, jeśli je zapomniałem/zapomniałam?

Proszę wejść do panelu sterowania hostingiem (cPanel, ISPmanager, DirectAdmin), otworzyć sekcję „Konta FTP". Są tam wymienione wszystkie utworzone konta. Jeśli hasło zostało utracone, można tam ustawić nowe. W ostateczności: dane FTP są zazwyczaj podane w liście powitalnym od hostingu podczas tworzenia konta.

Opanować FTP w pół godziny: warto czy nie?

FTP nie stał się ładniejszy przez 40 lat. Interfejs FileZilla przypomina Windows XP, a zamieszanie z portami i chmod wciąż irytuje początkujących. Ale gdy strona leży, a pomoc techniczna hostingu milczy, to niezgrabne narzędzie staje się jedynym działającym kanałem.

Jeśli jest Pan/Pani właścicielem strony WordPress, proszę opanować trzy rzeczy: utworzyć konto FTP w panelu hostingu, połączyć się przez FileZilla, zmienić nazwę katalogu wtyczki. Zajmie to pół godziny. I kiedyś zaoszczędzi Panu/Pani godzin paniki i oczekiwania.

Proszę zacząć od razu: utworzyć testowe konto FTP, połączyć się z serwerem przez klienta FTP FileZilla i upewnić się, że widzi Pan/Pani folder public_html. Po prostu, żeby wiedzieć, że kanał działa.