Czego szukasz?

Wpisz temat, narzędzie lub problem do rozwiązania.

← Wszystkie artykuły

n8n w Dockerze: własna automatyzacja na VPS krok po kroku

Ceramiczne elementy tworzą rozgałęziony układ połączeń.

Automatyzacja działająca na własnym VPS-ie daje sporo swobody: możesz łączyć webhooki, własne API i usługi dostępne w prywatnej sieci. Trzeba jednak zadbać o coś więcej niż uruchomienie kontenera. Panel potrzebuje HTTPS, dane trwałego miejsca, a po aktualizacji workflow nadal musi działać.

W tym poradniku uruchomimy n8n w Dockerze, dodamy reverse proxy i zbudujemy prostą odpowiedź na webhook. Konfiguracja jest przeznaczona na początek dla jednej osoby i niewielkich przepływów. Używa SQLite oraz osobnego kontenera task runnera. Nie obejmuje klastra, wysokiej dostępności ani stosu n8n Assistant.

Co przygotować na VPS-ie

Potrzebujesz Linuxa z Docker Engine i pluginem Compose, dostępu SSH oraz subdomeny, np. n8n.example.com. Zakładam, że Nginx działa bezpośrednio na hoście i masz dla tej subdomeny poprawny certyfikat HTTPS. Instalację samego Dockera opisuję w poradniku Docker na VPS.

Zacznij od serwera z zapasem pamięci, monitoruj zużycie i dobieraj zasoby do workflow. Obróbka dużych plików, równoległe wykonania i zadania Code mają inne wymagania niż prosty webhook. Nie traktuj uruchomienia pustego panelu jako testu maksymalnego obciążenia.

W przykładzie używam obrazów n8n i runners w wersji 2.41.3. Numer przypina konkretny zestaw do odtworzenia. Przed własnym wdrożeniem sprawdź dostępne poprawki oraz informacje o zmianach; przypięta wersja wymaga świadomego aktualizowania.

docker version
docker compose version
mkdir -p ~/n8n-vps
cd ~/n8n-vps

Sekrety i konfiguracja Compose

Utwórz .env tylko przy pierwszej instalacji. Skrypt odmówi nadpisania istniejącego pliku, ponieważ wygenerowanie nowego klucza do istniejącej bazy może uniemożliwić odczyt zapisanych poświadczeń:

(
  set -eu
  umask 077
  test ! -e .env
  {
    printf 'N8N_VERSION=2.41.3\n'
    printf 'N8N_HOST=n8n.example.com\n'
    printf 'N8N_ENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)"
    printf 'N8N_RUNNERS_AUTH_TOKEN=%s\n' "$(openssl rand -hex 32)"
  } > .env
)

Zmień domenę w pliku na swoją. Dodaj .env do .gitignore; plik zawiera prawdziwe sekrety, a nie szablon do opublikowania. Uprawnienia 600 ograniczają dostęp zwykłych użytkowników hosta, ale administrator i osoba kontrolująca Dockera nadal mogą odczytać konfigurację kontenera.

Zapisz poniższy plik jako compose.yml:

name: n8n-vps
services:
  n8n:
    image: docker.n8n.io/n8nio/n8n:${N8N_VERSION:?set N8N_VERSION}
    restart: unless-stopped
    ports:
      - "127.0.0.1:5678:5678"
    environment:
      N8N_HOST: ${N8N_HOST:?set N8N_HOST}
      N8N_PORT: "5678"
      N8N_PROTOCOL: https
      N8N_WEBHOOK_URL: https://${N8N_HOST}/
      N8N_EDITOR_BASE_URL: https://${N8N_HOST}/
      N8N_PROXY_HOPS: "1"
      N8N_ENCRYPTION_KEY: ${N8N_ENCRYPTION_KEY:?set encryption key}
      N8N_RUNNERS_MODE: external
      N8N_RUNNERS_BROKER_LISTEN_ADDRESS: 0.0.0.0
      N8N_RUNNERS_AUTH_TOKEN: ${N8N_RUNNERS_AUTH_TOKEN:?set runner token}
      GENERIC_TIMEZONE: Europe/Warsaw
      TZ: Europe/Warsaw
      N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS: "true"
    volumes:
      - n8n_data:/home/node/.n8n
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"
  runners:
    image: n8nio/runners:${N8N_VERSION:?set N8N_VERSION}
    restart: unless-stopped
    environment:
      N8N_RUNNERS_TASK_BROKER_URI: http://n8n:5679
      N8N_RUNNERS_AUTH_TOKEN: ${N8N_RUNNERS_AUTH_TOKEN:?set runner token}
    depends_on:
      - n8n
    security_opt:
      - no-new-privileges:true
    cap_drop:
      - ALL
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"
volumes:
  n8n_data:

Port 5678 jest związany z loopbackiem hosta. Port brokera 5679 nie jest publikowany. Task runner dostaje token połączenia z brokerem, ale nie otrzymuje klucza szyfrowania ani wolumenu danych n8n. Oba obrazy mają ten sam numer wersji.

depends_on określa kolejność uruchamiania, lecz sam nie potwierdza gotowości aplikacji. Dlatego po starcie sprawdzimy odpowiedź HTTP i logi. Zewnętrzny runner obsługuje zadania Code; nie dodajemy tu uprzywilejowanego kontenera ani dostępu do gniazda Dockera.

SQLite jest wygodne do nauki i małych zastosowań. Dla istotnej instalacji produkcyjnej z większym obciążeniem przygotuj PostgreSQL i osobny backup bazy. Sama zmiana DB_TYPE nie przenosi istniejących danych z SQLite.

HTTPS i ochrona pierwszego uruchomienia

Zanim udostępnisz panel, ogranicz dostęp do adresu IP, z którego będziesz tworzyć konto właściciela. Pusta instalacja nie powinna czekać publicznie na pierwszą osobę, która wypełni formularz rejestracji.

Poniższy fragment wstaw do przygotowanego bloku server obsługującego HTTPS dla subdomeny. To konfiguracja lokalizacji, nie kompletny plik z certyfikatem. Zastąp przykładowy adres 203.0.113.10 własnym publicznym IP:

location / {
    allow 203.0.113.10;
    deny all;

    proxy_pass http://127.0.0.1:5678;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-Host $host;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Forwarded-For $remote_addr;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_read_timeout 300s;
    proxy_buffering off;
}

Ten przykład zakłada dokładnie jeden reverse proxy między przeglądarką a n8n, bez dodatkowego proxy CDN. Dla innej topologii trzeba ponownie ustalić liczbę zaufanych przeskoków i sposób ustalania adresu klienta. Nie zwiększaj N8N_PROXY_HOPS przypadkowo.

Ceramiczna bramka z zamkiem stoi przed modułem aplikacji.
Reverse proxy obsługuje HTTPS, a port n8n pozostaje dostępny lokalnie.

Sprawdź konfigurację Nginx, a dopiero potem ją przeładuj:

sudo nginx -t && sudo systemctl reload nginx
docker compose config --quiet
docker compose pull
docker compose up -d
docker compose ps

config --quiet sprawdza składnię bez wypisywania rozwiniętych sekretów. Pierwszy start obejmuje migracje bazy i na małym VPS-ie może potrwać kilka minut. Sprawdzaj gotowość lokalnie na VPS-ie:

curl --fail http://127.0.0.1:5678/healthz/readiness
docker compose logs --tail=80 n8n runners

Status 200 z endpointu readiness potwierdza połączenie z bazą i zakończone migracje. Nie sprawdza poprawności twoich integracji. Otwórz domenę przez HTTPS, utwórz konto właściciela, ustaw mocne hasło i włącz dostępne uwierzytelnianie dwuskładnikowe. Nie wyłączaj secure cookies, aby zamaskować niepoprawne HTTPS.

Po skonfigurowaniu konta zdecyduj o dostępności panelu. Jeżeli usuniesz allow i deny all, logowanie n8n będzie publiczne, a webhooki dostępne dla zewnętrznych systemów. Pozostawienie tych reguł ograniczy również webhooki. Rozdzielenie ochrony panelu i publicznych endpointów wymaga świadomej konfiguracji ścieżek.

Pierwszy workflow: webhook, dane, odpowiedź

Zbuduj trzy połączone węzły: Webhook, Edit Fields (Set) i Respond to Webhook. Jeżeli potrzebujesz wyjaśnienia samego mechanizmu, zajrzyj do artykułu czym jest webhook.

W Webhook ustaw metodę POST, ścieżkę tryb-demo oraz odpowiedź przez węzeł Respond to Webhook. Wybierz Header Auth i utwórz poświadczenie z nazwą nagłówka X-Demo-Token oraz własnym losowym sekretem. Adres endpointu sam w sobie nie zastępuje uwierzytelnienia.

W Edit Fields wybierz ręczne mapowanie. Dodaj pole tekstowe source z wyrażeniem {{ $json.body.source }} oraz pole logiczne received z wartością true. Wyłącz przekazywanie pozostałych pól wejściowych, aby przypadkowo nie zwrócić nagłówka z tokenem. W Respond to Webhook wybierz odpowiedź JSON i ustaw jej treść jako wyrażenie {{ $json }}.

Impuls przechodzi przez trzy ceramiczne elementy połączone ścieżką.
Webhook uruchamia przepływ, który przetwarza dane i zwraca odpowiedź.

Najpierw włącz nasłuchiwanie zdarzenia testowego. Skopiuj Test URL z interfejsu i wyślij żądanie. Poniższy przykład Bash pobiera token bez wyświetlania go podczas wpisywania:

read -rsp 'Token webhooka: ' demo_token
printf '\n'
curl --fail-with-body \
  'https://n8n.example.com/webhook-test/tryb-demo' \
  -H 'Content-Type: application/json' \
  -H "X-Demo-Token: $demo_token" \
  --data '{"source":"test-z-terminala"}'
unset demo_token

Token nie trafia tu jako literalny tekst do historii poleceń, ale podczas działania curl jest argumentem procesu. Na współdzielonym systemie użyj chronionego pliku konfiguracji klienta albo innego sposobu przekazania sekretu.

Oczekiwana odpowiedź to obiekt z source i received: true. Sprawdź również żądanie bez poprawnego tokena: powinno zostać odrzucone. Po udanym teście opublikuj workflow i przejdź na Production URL. Adres testowy działa w trybie nasłuchiwania, a nie jako stała integracja. Nie myl publikacji workflow z samym zapisaniem jego zmian.

Dane i klucz muszą przetrwać kontener

Wolumen n8n_data przechowuje katalog /home/node/.n8n, w tym bazę SQLite i konfigurację. Przy nazwie projektu z przykładu Docker tworzy wolumen n8n-vps_n8n_data. Zmiana nazwy projektu może wskazać nowy, pusty wolumen; to częsta przyczyna pozornego zniknięcia workflow.

Ceramiczny pojemnik na dane i osobny klucz leżą obok siebie.
Backup musi obejmować dane n8n oraz właściwy klucz szyfrowania.

Zapisz klucz szyfrowania z .env w bezpiecznym menedżerze sekretów. Odtworzenie bazy bez odpowiedniego klucza nie przywróci możliwości odczytania poświadczeń. Nie używaj docker compose down -v do zwykłego restartu: flaga -v usuwa wolumeny projektu.

W tym prostym układzie SQLite wykonuj kopię przy zatrzymanym n8n. Poniższy skrypt uruchom z katalogu projektu. Przygotuj wcześniej /srv/backups/n8n poza katalogiem publicznym, z prawami zapisu dla operatora i dostępem ograniczonym do niego:

(
  set -eu
  umask 077
  backup_dir=/srv/backups/n8n
  stamp=$(date +%Y%m%d-%H%M%S)
  docker compose stop n8n runners
  trap 'docker compose start n8n runners' EXIT
  docker run --rm \
    -v n8n-vps_n8n_data:/data:ro \
    alpine:3.22 tar -czf - -C /data . \
    > "$backup_dir/data-$stamp.tar.gz"
  tar -czf "$backup_dir/config-$stamp.tar.gz" compose.yml .env
  test -s "$backup_dir/data-$stamp.tar.gz"
)

Przenoś zaszyfrowane kopie poza VPS. Aby sprawdzić odzyskiwanie, odtwórz dane do osobnego wolumenu, przywróć konfigurację i uruchom tę samą wersję obrazu w odizolowanym środowisku. Uważaj na automatyzacje, które po starcie mogłyby wysłać wiadomości lub zmienić prawdziwe dane. Eksport JSON pojedynczego workflow jest przydatny do przenoszenia definicji, lecz nie zastępuje pełnej kopii instancji.

Aktualizacja i typowe problemy

Przed aktualizacją zrób kopię i sprawdź informacje o wydaniu. Zmień N8N_VERSION w .env, pobierz obrazy i odtwórz kontenery przez docker compose up -d. Następnie sprawdź readiness, logowanie i kontrolny webhook. Cofnięcie numeru obrazu nie gwarantuje cofnięcia migracji bazy; plan powrotu musi uwzględniać backup.

Objaw Co sprawdzić najpierw
502 z Nginx Czy n8n działa i odpowiada lokalnie na 5678
Niepoprawny adres webhooka N8N_WEBHOOK_URL, domenę i konfigurację proxy
404 przy wywołaniu Test URL versus Production URL oraz publikację workflow
Błąd poświadczeń po migracji Klucz szyfrowania i właściwy wolumen
Code czeka lub zgłasza błąd Wersje runnera, token i połączenie z brokerem
Kontener znika lub restartuje się Logi, pamięć, wolne miejsce i stan OOMKilled

Monitoruj nie tylko panel, ale też wykonania ważnych przepływów. Status HTTP 200 nie powie, czy zewnętrzne API zaakceptowało ostatnie zamówienie. Podstawy monitorowania adresów opisuję w poradniku Uptime Kuma w Dockerze.

FAQ

Czy n8n musi mieć publiczny port 5678?

Nie. W tym układzie publiczny jest HTTPS Nginx, a port aplikacji pozostaje na loopbacku. Jeżeli proxy też działa w kontenerze, trzeba zmienić sposób połączenia, bo jego localhost nie oznacza hosta ani kontenera n8n.

Czy własny serwer daje wszystkie funkcje n8n?

Nie zakładaj tego. Dostępność funkcji zależy od edycji i licencji. Ten przykład skupia się na podstawowym przepływie webhooka i nie wymaga n8n Assistant, płatnego dostawcy modeli ani rozbudowanego systemu ról.

Czy mogę wkleić dowolny workflow z internetu?

Najpierw go przejrzyj. Sprawdź adresy żądań, operacje na plikach, wykonywany kod i wymagane poświadczenia. Uruchamiaj testy na sztucznych danych, zanim udostępnisz przepływowi dostęp do usług produkcyjnych.

Dlaczego po zmianie bazy nie widzę workflow?

Nowa baza PostgreSQL nie zawiera automatycznie danych ze starego SQLite. Sprawdź konfigurację i procedurę migracji. Nie usuwaj starego wolumenu, dopóki nie potwierdzisz odtworzenia danych.

Co sprawdzić przed podłączeniem pierwszej ważnej integracji?

Poprawne HTTPS, ochronę konta, uwierzytelnienie webhooka, trwałość danych i odtworzenie kopii. Następnie przetestuj błąd zewnętrznego API oraz ponowienie żądania, żeby automatyzacja nie tworzyła duplikatów.

Źródła

Data publikacji: 13.10.2026.

KP
O AUTORZE

Krystian Proć

Tworzę narzędzia do pracy z danymi, systemy backendowe i automatyzacje. Pracuję z SQL, PHP, TypeScriptem i Dockerem; rozwijam m.in. dragon-island.com. AI pomaga mi przyspieszać pracę, a architekturę, weryfikację i decyzje techniczne biorę na siebie. Na Trybie Technicznym dzielę się doświadczeniami z budowania i utrzymywania własnych projektów.

Dyskusja

Dodaj komentarz

Twój adres email nie zostanie opublikowany. Wymagane pola są oznaczone *