N8N / AUTOMATYZACJA
n8n na VPS: Compose, Nginx i przykładowy webhook
Paczka n8n z zewnętrznym runnerem, generatorem sekretów, fragmentem Nginx i workflow z Header Auth. Instrukcja startu oraz ochrony danych.
Środowisko i zakresNowa, pojedyncza instancja n8n 2.41.3 z SQLite. Linux, Docker Engine 28+, Compose v2+, Bash/OpenSSL oraz istniejący Nginx z HTTPS dla własnej subdomeny.
Co zawiera paczka?
Compose uruchamia n8n i oddzielny task runner. Port aplikacji 5678 jest lokalny, a broker 5679 nie jest publikowany na hoście. Runner nie otrzymuje wolumenu aplikacji ani jej klucza szyfrowania.
Dostajesz .env.example, init-env.sh, fragment konfiguracji Nginx, importowalny workflow.json oraz README. Paczka nie wystawia certyfikatu i nie migruje istniejącej instalacji.
1. Wygeneruj własne sekrety
W nowym prywatnym katalogu uruchom skrypt z własną domeną. Nazwa projektu n8n-vps musi być wolna. Skrypt tworzy .env z prawami 600 i odmawia nadpisania istniejącego pliku. Klucz szyfrowania zachowaj także w bezpiecznym menedżerze sekretów.
Uwaga: Nie publikuj .env ani wyniku docker compose config bez --quiet. Administrator Dockera ma dostęp do środowiska kontenera.
bash init-env.sh n8n.twoja-domena.pl
docker compose config --quiet2. Przygotuj dostęp przez HTTPS
nginx-location.conf wstaw do istniejącego bloku server z HTTPS. Zmień przykładowe IP w allow na własne. Pozostaw deny all na czas pierwszej konfiguracji. Przykład zakłada jeden reverse proxy i dlatego ustawia N8N_PROXY_HOPS=1.
Uwaga: Migracje przy pierwszym starcie mogą potrwać kilka minut. Właściciela utwórz przez przygotowane HTTPS przed poszerzeniem dostępu. Reguły allow/deny ograniczają także webhooki.
sudo nginx -t && sudo systemctl reload nginx
docker compose pull
docker compose up -d
docker compose ps
curl --fail http://127.0.0.1:5678/healthz/readiness3. Zaimportuj i sprawdź workflow
Zaimportuj workflow.json w edytorze. W węźle Webhook dodaj własne poświadczenie Header Auth: nagłówek X-Demo-Token i losowy sekret. Paczka nie zawiera prawdziwego credential ani jego identyfikatora.
Wybierz Listen for Test Event i użyj Test URL z POST oraz JSON {"source":"moja-proba"}. Poprawna odpowiedź zawiera source i received=true. Sprawdź także odrzucenie żądania bez tokena. Po teście opublikuj workflow i przejdź na Production URL; sam zapis zmian nie wystarcza.
4. Backup, aktualizacja i wycofanie
Dane są w n8n-vps_n8n_data. Kopię wolumenu wykonuj po zatrzymaniu n8n i runnera; zachowaj także .env i Compose. Bez klucza szyfrowania nie odtworzysz poświadczeń. Eksport workflow nie jest pełną kopią.
Przed aktualizacją sprawdź odtworzenie na osobnym wolumenie. Zmiana obrazu na starszy nie cofa migracji bazy. Dla większego obciążenia zaplanuj osobno PostgreSQL i migrację danych. Zwykłe down pozostawia wolumen.
docker compose downSprawdzone scenariusze
Zweryfikowano generowanie sekretów i odmowę ich nadpisania, Compose, start n8n oraz rejestrację runnera. Workflow przeszedł 300 poprawnych wywołań w opisanym poniżej teście pamięci. Osobny test materiałów do poradnika potwierdził trwałość danych i odtworzenie z kluczem.
Fragment Nginx przeszedł kontrolę składni. Nie testowano domeny ani certyfikatu czytelnika, zewnętrznych integracji, dużego obciążenia i migracji PostgreSQL.
Pobierz i sprawdź u siebie
ZIP zawiera instrukcję README.md i pliki wymienione poniżej.
Pobierz ZIP (4,8 KiB) ↓Zawartość i suma SHA-256
.env.exampleREADME.mdcompose.ymlinit-env.shnginx-location.confworkflow.json
d18afdfb68d79dc40f3f9da51bb07f74fa4987340e671ba2e091d9e8c29f530d
Źródła i dokumentacja
Data publikacji: 29.09.2026.