6 listopada 2026 · Aktualizacja: 6 listopada 2026 · Zespół NexXsite · github actions · wdrożenie ftp · strony www · automatyzacja

Automatyczne wdrożenia strony z GitHuba przez FTP – praktyczne pułapki

Automatyczne wdrożenia stron z GitHuba przez FTP to wygoda, ale też pole minowe dla tych, którzy nie znają kilku kluczowych pułapek. Przez ostatnie miesiące sam przekonałem się, że drobny błąd w konfiguracji może sprawić, że nowa wersja strony nie pojawi się online, a Ty nawet tego nie zauważysz.

Jak działa automatyczne wdrożenie przez GitHub Actions?

GitHub Actions pozwala uruchomić skrypt wdrożeniowy po każdym pushu do repozytorium. Najczęściej używa się gotowych akcji jak SamKirkland/FTP-Deploy-Action. Wymaga to podania loginu, hasła i – co najważniejsze – dokładnej ścieżki docelowej na serwerze FTP.

Ścieżka FTP – najczęściej pomijany szczegół

Wielokrotnie widziałem, jak pliki trafiały na serwer, ale strona wciąż wyświetlała starą wersję. Powód? Źle ustawiona ścieżka katalogu w akcji FTP. Jeśli wyślesz pliki poziom wyżej lub niżej niż katalog serwujący stronę, wdrożenie zakończy się sukcesem, ale nikt nie zobaczy nowej wersji. Zawsze sprawdzaj, gdzie dokładnie trafiają pliki – czasem katalog docelowy potrafi różnić się nawet o jeden poziom /public_html/ vs /domains/twojadomena.pl/public_html/.

Widoczność zmian – nie ufaj komunikatom

Sam komunikat o sukcesie w GitHub Actions nie jest gwarancją, że nowa wersja strony działa. Najlepszy dowód to realny ślad na serwerze: sprawdź wpis w bazie, wywołanie funkcji w logach lub faktyczne odświeżenie strony. Kilka razy złapałem się na tym, że wdrożenie przeszło, ale formularze zgłoszeń nie dochodziły, bo backend nie został zaktualizowany.

Formularze kontaktowe – ukryte pułapki automatyzacji

Automatyczne wdrożenie nowej wersji strony może przypadkiem zepsuć formularz kontaktowy. W jednym z wdrożeń ukryte pole antyspamowe było automatycznie wypełniane przez menedżer haseł, przez co formularz pokazywał ekran sukcesu, ale nie wysyłał niczego. Po stronie właściciela wyglądało to jak brak zainteresowania ofertą, a winna była drobna zmiana w HTML. Decyzje o odrzuceniu zgłoszenia najlepiej przenieść na backend i logować każdy przypadek.

Problemy z DNS i subdomenami na hostingu

Przy wdrożeniach stron korzystających z subdomen, zdarza się, że hosting rozwiązuje subdomenę lokalnie. Jeśli aplikacja na serwerze łączy się z API na subdomenie tej samej domeny, hosting może kierować ruch na siebie, ignorując zewnętrzne DNS. Efekt: błąd 404 mimo poprawnej konfiguracji strefy DNS. Warto testować takie połączenia z zewnętrznych narzędzi lub przez curl z innego serwera.

Zawsze podawaj pełną, sprawdzoną ścieżkę katalogu docelowego w akcji FTP.
Po wdrożeniu sprawdź realny efekt: wpis w bazie lub logi serwera.
Testuj formularze na produkcji – szczególnie po zmianach w HTML.
Problemy z subdomenami mogą wynikać z lokalnego rozwiązywania DNS przez hosting.

Zobacz nasze wdrożenia automatyzacji n8n i stron

Najczęstsze pytania

Jak ustawić ścieżkę katalogu przy wdrożeniu przez FTP?

Ścieżkę katalogu docelowego znajdziesz w panelu hostingu. Najczęściej to /public_html/ lub /domains/twojadomena.pl/public_html/. Warto przesłać testowy plik i sprawdzić, gdzie się pojawił – pomyłka o jeden poziom sprawi, że strona się nie zaktualizuje.

Dlaczego GitHub Actions pokazuje sukces, a strona się nie zmieniła?

Akcja FTP nie zgłasza błędu, jeśli pliki trafią do złego katalogu. Zawsze po wdrożeniu sprawdzaj efekt na serwerze, np. przez wpis do bazy lub logi. Sam komunikat o sukcesie nie daje gwarancji działania nowej wersji.

Jak sprawdzić, czy formularz kontaktowy działa po wdrożeniu?

Przetestuj formularz na stronie produkcyjnej i sprawdź, czy zgłoszenie pojawia się w bazie lub logach serwera. Sam ekran sukcesu w przeglądarce nie oznacza, że wiadomość dotarła – w praktyce spotkałem przypadki, gdzie formularz nie wysłał niczego przez ukryte pole antyspamowe.

Co zrobić, gdy API na subdomenie zwraca błąd 404 mimo poprawnego DNS?

Hosting może rozwiązywać subdomenę lokalnie, kierując ruch na siebie. W takiej sytuacji testuj połączenie z zewnętrznych serwerów lub narzędzi, np. przez curl. To pozwala wykryć, czy problem leży po stronie hostingu.

Jak monitorować skuteczność wdrożeń przez GitHub Actions?

Oprócz sprawdzania komunikatów o sukcesie, warto logować kluczowe operacje po stronie serwera – np. wpisy do bazy lub wywołania funkcji. To jedyny sposób, by mieć pewność, że wdrożenie faktycznie zadziałało.

Porozmawiajmy o Twoim projekcie