Podstawy n8n
Przewodnik dla początkujących użytkowników automatyzacji
Autor: Michał Moroz
Lipiec 2025
Wstęp
Automatyzacja procesów biznesowych stała się kluczowym elementem nowoczesnych firm, które chcą działać szybciej, wydajniej i bardziej niezawodnie. Jednym z najbardziej elastycznych i dostępnych narzędzi w tym obszarze jest n8n – otwartoźródłowa platforma do tworzenia przepływów pracy (workflow) łączących różne aplikacje i usługi.
Celem tego podręcznika jest wprowadzenie Cię krok po kroku w świat n8n – od podstawowej instalacji, poprzez tworzenie prostych przepływów, aż po zaawansowane techniki integracji i wdrażania w środowisku produkcyjnym.
Podręcznik został przygotowany z myślą o początkujących użytkownikach, którzy nie mają doświadczenia z n8n, ale chcą szybko rozpocząć tworzenie własnych automatyzacji. Każdy rozdział zawiera przykłady, praktyczne porady oraz opis działania najważniejszych funkcji narzędzia.
Dzięki tej publikacji dowiesz się między innymi:
– jak zainstalować i skonfigurować n8n,
– jak tworzyć, testować i uruchamiać workflowy,
– jak korzystać z najpopularniejszych node’ów,
– jak bezpiecznie wdrażać automatyzacje w firmie.
Mamy nadzieję, że ta wiedza pozwoli Ci oszczędzić czas, zredukować liczbę błędów i usprawnić codzienną pracę – niezależnie od tego, czy jesteś specjalistą IT, analitykiem, czy osobą odpowiedzialną za procesy biznesowe.
Powodzenia i przyjemnej lektury!
Autor
Podstawy n8n – Rozdział 1: Jak zacząć z n8n
1.1 Czym jest n8n?
n8n (czyt. n-eight-n) to narzędzie do automatyzacji procesów, które umożliwia tworzenie przepływów (workflow) łączących różne aplikacje i usługi. Jest to alternatywa dla takich narzędzi jak Zapier czy Make, z tą różnicą, że:
– Jest open-source.
– Można go uruchomić lokalnie lub w chmurze.
– Pozwala na większą elastyczność i programistyczną swobodę.
1.2 Wymagania systemowe
Aby zainstalować i korzystać z n8n, potrzebujesz:
– Node.js (zalecana wersja LTS, np. 18.x)
– npm lub yarn
– Docker (opcjonalnie, ale zalecany)
– Przeglądarka internetowa (Chrome, Firefox itp.)
– Konto w GitHub, Google lub innej usłudze – przydatne przy integracjach
1.3 Instalacja n8n lokalnie
1. Zainstaluj Node.js i npm: https://nodejs.org/
2. Otwórz terminal i wpisz:
npm install n8n -g
3. Uruchom n8n komendą:
n8n
4. W przeglądarce wejdź na: http://localhost:5678
1.4 Instalacja n8n przez Docker
1. Stwórz plik docker-compose.yml z zawartością:
version: '3.1′
services:
n8n:
image: n8nio/n8n
ports:
– 5678:5678
volumes:
– ./n8n_data:/home/node/.n8n
environment:
– N8N_BASIC_AUTH_ACTIVE=true
– N8N_BASIC_AUTH_USER=admin
– N8N_BASIC_AUTH_PASSWORD=admin
2. Uruchom kontener:
docker-compose up -d
3. Wejdź na: http://localhost:5678
1.5 Tworzenie pierwszego workflow
1. Kliknij „+ New Workflow”.
2. Dodaj pierwszy node, np. Cron lub HTTP Request.
3. Połącz go z kolejnym node’em, np. Set albo Email.
4. Kliknij „Execute Node” lub „Execute Workflow”, by przetestować działanie.
1.6 Przykładowe zastosowania n8n
– Automatyzacja powiadomień mailowych
– Integracja z CRM (HubSpot, Pipedrive)
– Przetwarzanie danych z zewnętrznych API
– Synchronizacja danych z Google Sheets lub bazą danych
– Obsługa webhooków i reakcji na zdarzenia w aplikacjach
1.7 Co dalej?
W kolejnych rozdziałach nauczysz się:
– Jak korzystać z różnych typów node’ów
– Jak przetwarzać dane i używać funkcji warunkowych
– Jak tworzyć webhooki i harmonogramy
– Jak analizować i debugować workflow
– Jak wdrażać i zabezpieczać automatyzacje w środowisku produkcyjnym
Podstawy n8n – Rozdział 2: Struktura i elementy workflow
2.1 Interfejs użytkownika n8n
Po uruchomieniu n8n, zobaczysz graficzny edytor workflow. Główne elementy interfejsu to:
– Pasek narzędzi: u góry ekranu, zawiera opcje zapisu, uruchamiania workflow, eksportu, itp.
– Panel node’ów: po lewej stronie, pozwala wyszukiwać i dodawać node’y.
– Obszar roboczy (canvas): centralna część ekranu, w której budujesz workflow.
– Panel właściwości node’a: po prawej stronie, umożliwia konfigurację wybranego node’a.
2.2 Co to jest node?
Node (węzeł) to podstawowy element workflow w n8n. Każdy node wykonuje określone zadanie, np. pobiera dane z API, wysyła e-mail, przekształca dane lub reaguje na zdarzenie.
2.3 Typy node’ów
Node’y w n8n można podzielić na kilka typów:
– Trigger: rozpoczyna workflow (np. Webhook, Cron)
– Action: wykonuje akcję (np. HTTP Request, Email, Google Sheets)
– Logic: umożliwia sterowanie przepływem (np. IF, Switch)
– Data: przetwarza dane (np. Set, Function, Merge)
– Error Trigger: reaguje na błędy w workflow
2.4 Łączenie node’ów
Node’y łączy się za pomocą strzałek (połączeń), które określają kolejność wykonywania operacji. Można tworzyć rozgałęzienia (np. IF), pętle, a także łączyć kilka node’ów w jednym punkcie.
2.5 Dane wejściowe i wyjściowe
Każdy node przyjmuje dane wejściowe i generuje dane wyjściowe. Dane te mają postać JSON i mogą być przetwarzane w kolejnych krokach workflow. W panelu właściwości node’a można podejrzeć dane wejściowe/wyjściowe i zdebugować działanie.
2.6 Praktyczna wskazówka
Warto testować workflow krok po kroku, używając opcji „Execute Node”. To pozwala dokładnie przeanalizować, co się dzieje na każdym etapie automatyzacji.
Podstawy n8n – Rozdział 3: Popularne node’y – przykłady zastosowania
W tym rozdziale zapoznasz się z najczęściej używanymi node’ami w n8n. Każdy node posiada specyficzne zastosowanie – od uruchamiania workflow, przez pobieranie danych, po ich przetwarzanie.
3.1 Cron – uruchamianie cykliczne
Node Cron służy do uruchamiania workflow w określonych odstępach czasu – np. co godzinę, codziennie o 9:00, raz w tygodniu.
Przykład: Uruchom codziennie workflow, który wysyła raport e-mail.
3.2 Webhook – nasłuchiwanie zdarzeń
Node Webhook tworzy publiczny URL, który może nasłuchiwać żądań HTTP POST/GET.
Przykład: Po wysłaniu formularza kontaktowego na stronie, dane trafiają do n8n przez webhook.
3.3 HTTP Request – integracje z API
Node HTTP Request umożliwia wysyłanie zapytań do dowolnego API (GET, POST, PUT, DELETE).
Przykład: Pobierz dane o kursach walut z zewnętrznego API i przekaż dalej do Google Sheets.
3.4 Set – tworzenie i modyfikacja danych
Node Set pozwala tworzyć nowe pola, nadpisywać wartości, usuwać dane w rekordach JSON.
Przykład: Dodaj pole „status” z wartością „aktywny” do każdego rekordu.
3.5 Email – wysyłanie wiadomości
Node Email umożliwia wysyłanie e-maili przez SMTP (np. Gmail, Outlook).
Przykład: Wyślij powiadomienie z wynikami raportu do działu handlowego.
3.6 Google Sheets – praca z arkuszami kalkulacyjnymi
Node Google Sheets pozwala odczytywać, zapisywać i aktualizować dane w arkuszach Google.
Przykład: Dodaj nowy wiersz z danymi leadów wygenerowanych przez webhook.
3.7 Merge – łączenie danych z różnych źródeł
Node Merge umożliwia połączenie danych z dwóch różnych strumieni.
Przykład: Połącz dane klienta z bazy CRM i dane o zamówieniach z ERP.
3.8 IF – warunkowe sterowanie przepływem
Node IF pozwala rozdzielić przepływ na podstawie warunków logicznych (np. wartość większa niż 100).
Przykład: Jeśli zamówienie ma wartość > 1000 zł, wyślij powiadomienie do kierownika.
3.9 Podsumowanie
Znajomość podstawowych node’ów jest kluczowa do tworzenia efektywnych automatyzacji. W kolejnych rozdziałach nauczysz się wykorzystywać te node’y w bardziej zaawansowanych scenariuszach, z wykorzystaniem logiki warunkowej, pętli i przetwarzania danych.
Podstawy n8n – Rozdział 4: Warunki, pętle i przetwarzanie danych
W tym rozdziale nauczysz się, jak kontrolować logikę przepływu za pomocą warunków, iteracji oraz jak przetwarzać dane w różnych formatach, zwłaszcza JSON. To kluczowe elementy dla budowania bardziej inteligentnych automatyzacji.
4.1 Node IF – logika warunkowa
Node IF umożliwia podjęcie decyzji w zależności od spełnienia warunku logicznego.
Przykład: Jeśli wartość pola 'amount' jest większa niż 1000, workflow przechodzi jedną ścieżką, w przeciwnym wypadku – drugą.
4.2 Pętle i iteracje
n8n przetwarza dane jako tablice rekordów (items). Większość node’ów działa na każdym elemencie tablicy.
Aby wykonać bardziej złożone iteracje, użyj node’a Function lub Loop (eksperymentalny).
4.3 Node Function i Function Item
Node Function umożliwia napisanie własnego kodu JavaScript, który działa na wszystkich rekordach naraz.
Node Function Item działa na pojedynczym rekordzie i jest przydatny przy prostych transformacjach.
Przykład:
– Function: Filtruj rekordy, które mają wartość 'status' = 'active'.
– Function Item: Dodaj nowe pole 'fullName' łącząc imię i nazwisko.
4.4 Transformacja danych JSON
Większość danych w n8n przekazywana jest w formacie JSON. Node Set pozwala ręcznie określić pola, node Function pozwala tworzyć własne przekształcenia.
Przykład: Z pola 'data' wyciągnij podpole 'user.email' i zapisz je jako nowe pole ’email'.
4.5 Obsługa wielu rekordów (items)
Każdy node przetwarza dane w postaci listy rekordów (items). Warto wiedzieć, że:
– n8n wykonuje operacje równolegle dla każdego itema,
– można filtrować, przekształcać i łączyć rekordy,
– node Merge umożliwia łączenie danych z dwóch strumieni.
4.6 Praktyczne zastosowanie
Typowy scenariusz:
1. Pobierz dane zamówień z API.
2. Użyj node Function, by wybrać tylko te powyżej 500 zł.
3. Za pomocą node IF przekaż dalej tylko zamówienia z kategorią 'elektronika'.
4. W node Email wyślij podsumowanie do działu zakupów.
4.7 Podsumowanie
Stosowanie warunków, iteracji i własnych przekształceń danych daje ogromne możliwości kontroli nad tym, co dzieje się w workflow. W kolejnym rozdziale nauczysz się testować automatyzacje i obsługiwać błędy.
Podstawy n8n – Rozdział 5: Praca z błędami i testowanie
Podczas tworzenia workflow w n8n mogą wystąpić błędy – zarówno logiczne, jak i techniczne. Ten rozdział pokaże Ci, jak testować swoje automatyzacje oraz jak radzić sobie z błędami w czasie ich działania.
5.1 Tryby wykonania workflow
n8n oferuje dwa główne tryby uruchamiania workflow:
– Execute Workflow: uruchamia workflow ręcznie w trybie testowym.
– Active: workflow jest aktywny i uruchamia się automatycznie na podstawie triggera.
W trybie Execute możesz analizować dane wejściowe/wyjściowe każdego node’a.
5.2 Testowanie node’ów
Podczas projektowania workflow możesz uruchamiać pojedyncze node’y za pomocą przycisku „Execute Node”.
Pozwala to szybciej testować dane i debugować problemy na bieżąco bez potrzeby uruchamiania całego przepływu.
5.3 Obsługa błędów w node’ach
Jeśli któryś z node’ów napotka błąd (np. błąd HTTP 500), workflow domyślnie zatrzyma się.
Możesz to zmienić, włączając w node opcję „Continue On Fail” – wtedy workflow przejdzie dalej mimo błędu.
5.4 Node Error Trigger – reakcja na błędy
Node Error Trigger służy do obsługi błędów globalnych. Uruchamia workflow w momencie wystąpienia błędu w innym workflow.
Przykład: Gdy workflow nie może pobrać danych z API, wysyła e-mail z powiadomieniem do administratora.
5.5 Retry i fallback – ponawianie prób
Choć n8n nie posiada natywnej funkcji retry, możesz samodzielnie stworzyć taką logikę np. za pomocą node IF, Delay i pętli.
Przykład: Jeśli zapytanie HTTP zakończy się błędem, odczekaj 10 sekund i spróbuj ponownie maksymalnie 3 razy.
5.6 Praktyczne rady
– Przetestuj każdy krok osobno zanim uruchomisz całość.
– Zapisuj workflowy pod różnymi nazwami (np. v1, v2) podczas iteracji.
– Używaj node Set i Function do uproszczonego logowania danych.
– Dokumentuj warunki i kluczowe zmienne wewnątrz node’ów.
5.7 Podsumowanie
Poprawna obsługa błędów i testowanie workflow są niezbędne do stabilnego działania automatyzacji. W następnym rozdziale nauczysz się korzystać z webhooków i łączyć n8n z zewnętrznymi aplikacjami.
Podstawy n8n – Rozdział 6: Webhooki i integracje z zewnętrznymi systemami
Webhooki są jednym z najczęściej używanych sposobów integrowania n8n z zewnętrznymi systemami. Pozwalają na odbieranie danych w czasie rzeczywistym i automatyczne wyzwalanie workflow.
6.1 Co to jest webhook?
Webhook to publiczny adres URL, który może odbierać dane z zewnętrznych aplikacji w formacie HTTP POST lub GET.
Po otrzymaniu danych webhook może natychmiast uruchomić workflow i rozpocząć dalsze przetwarzanie.
6.2 Tworzenie node’a Webhook
Aby utworzyć webhook w n8n:
1. Dodaj node Webhook jako pierwszy element workflow.
2. Wybierz metodę (GET lub POST).
3. Ustaw unikalną nazwę ścieżki URL (np. /zamowienie).
4. Zapisz workflow i aktywuj go – tylko aktywne workflow będą reagować na webhooki.
5. Otrzymany adres URL zostanie wygenerowany automatycznie (np. https://twoj-serwer/webhook/zamowienie).
6.3 Testowanie webhooków
Webhook można testować za pomocą narzędzi takich jak Postman lub curl.
Przykład użycia curl:
curl -X POST https://twoj-serwer/webhook/zamowienie -H „Content-Type: application/json” -d '{„klient”: „Jan”, „produkt”: „Laptop”}'
6.4 Obsługa danych wejściowych
Po odebraniu żądania przez node Webhook, dane trafiają jako rekord JSON. Możesz je przetwarzać dalej za pomocą node Set, Function, HTTP Request lub zapisać do bazy danych czy arkusza Google Sheets.
6.5 Bezpieczeństwo webhooków
Aby ograniczyć dostęp do webhooka, możesz:
– Użyć Basic Auth (logowanie przez użytkownika i hasło).
– Sprawdzać nagłówki lub klucze API we własnym kodzie (np. w node Function).
– Użyć n8n w środowisku chronionym VPN lub reverse proxy z autoryzacją.
6.6 Przykład: formularz kontaktowy
1. Strona internetowa wysyła dane formularza do webhooka n8n.
2. n8n odbiera dane i zapisuje je do Google Sheets.
3. Workflow wysyła potwierdzenie e-mail do użytkownika.
4. Workflow informuje dział sprzedaży przez Slacka lub e-mail.
6.7 Podsumowanie
Webhooki umożliwiają natychmiastową reakcję na zdarzenia z zewnętrznych systemów. W połączeniu z innymi node’ami n8n tworzą potężne narzędzie do integracji w czasie rzeczywistym.
Podstawy n8n – Rozdział 7: Harmonogramowanie i uruchamianie automatyczne
W tym rozdziale poznasz sposoby automatycznego uruchamiania workflow w n8n. Można to osiągnąć dzięki harmonogramowi (np. codziennie o 8:00) lub poprzez integrację z zewnętrznymi systemami.
7.1 Node Cron – cykliczne uruchamianie workflow
Node Cron pozwala uruchamiać workflow w ustalonych przedziałach czasu. Obsługuje konfigurację:
– minutową, godzinową, dzienną, tygodniową, miesięczną
– z dokładnością do konkretnej daty lub dnia tygodnia
Przykład: Uruchom workflow codziennie o 6:00 rano, aby pobrać dane z API i wysłać raport e-mailem.
7.2 Przykład konfiguracji node Cron
Ustawienia node Cron:
– Repeats: Every Day
– Hour: 06
– Minute: 00
To spowoduje uruchamianie workflow codziennie o 6:00.
7.3 Workflow aktywne vs nieaktywne
Aby workflow działał automatycznie, musi być aktywowany.
– Workflow aktywny: uruchamia się automatycznie, np. przez Cron lub Webhook.
– Workflow nieaktywny: można uruchomić tylko ręcznie.
Pamiętaj, że po każdej edycji workflow należy go ponownie aktywować.
7.4 Uruchamianie workflow przez API lub inny workflow
n8n umożliwia uruchamianie workflow z innych workflow poprzez node HTTP Request lub node Execute Workflow.
Możesz też uruchomić workflow z zewnątrz, wysyłając żądanie do webhooka lub korzystając z API n8n (w wersjach self-hosted).
7.5 Kombinacja Cron i Webhook
Nic nie stoi na przeszkodzie, by używać wielu triggerów w jednym workflow.
Możesz na przykład:
– raz dziennie (Cron) sprawdzać statusy zamówień
– oraz reagować na nowe zamówienia wysłane przez webhook
w tym samym workflow.
7.6 Uwagi dotyczące wydajności
– Unikaj uruchamiania workflow co sekundę – może to prowadzić do przeciążenia.
– Zamiast pętli nieskończonych, użyj node Delay do wprowadzania opóźnień.
– Monitoruj zużycie zasobów przy wielu równoległych workflow (np. cron co minutę dla setek użytkowników).
7.7 Podsumowanie
Automatyczne uruchamianie workflow pozwala realizować cykliczne zadania bez potrzeby interwencji użytkownika. Dzięki node Cron oraz możliwościom triggerów zewnętrznych, n8n doskonale sprawdza się jako silnik harmonogramów.
Podstawy n8n – Rozdział 8: Zmienne, środowiska i zaawansowana konfiguracja
W tym rozdziale poznasz sposoby pracy ze zmiennymi, konfiguracją środowiskową oraz inne zaawansowane techniki przydatne przy rozwijaniu większych projektów w n8n. Odpowiednie zarządzanie zmiennymi i konfiguracją pozwala utrzymać workflowy czytelne, bezpieczne i łatwe w utrzymaniu.
8.1 Zmienne w node’ach
n8n umożliwia dynamiczne odwoływanie się do danych z poprzednich node’ów za pomocą składni:
{{$json.nazwa_pola}} lub {{$node[’NodeName'].json[’nazwa_pola']}}.
Przykład: Aby użyć adresu e-mail z poprzedniego node’a w wiadomości e-mail, wpisz {{$json.email}}.
8.2 Własne pola i tagi
Za pomocą node’a Set możesz tworzyć własne zmienne na potrzeby dalszego przetwarzania. Używanie logicznych nazw i tagów ułatwia orientację w dużych workflowach.
8.3 Zmienne środowiskowe (ENV)
W środowisku produkcyjnym warto używać zmiennych środowiskowych w pliku `.env`, np.:
– N8N_BASIC_AUTH_USER=admin
– N8N_BASIC_AUTH_PASSWORD=haslo123
– WEBHOOK_TUNNEL_URL=https://mojserwer.pl
Dzięki temu możesz łatwo zarządzać danymi wrażliwymi i konfiguracyjnymi bez twardego kodowania ich w workflowach.
8.4 Secrets – bezpieczne dane w n8n
Secrets to sposób na przechowywanie danych takich jak tokeny API, hasła i klucze dostępu. Są one konfigurowane w pliku konfiguracyjnym lub środowiskowym i używane w node’ach za pomocą składni {{$env.XXX}}.
8.5 Reużywanie fragmentów workflow
Node 'Execute Workflow' pozwala wywołać jeden workflow z drugiego. To sposób na budowanie modułowych i skalowalnych automatyzacji. Warto tworzyć tzw. „workflowy pomocnicze” np. do wysyłania powiadomień czy walidacji danych.
8.6 Ustawienia globalne i kontekstowe
Dla większych instalacji możesz:
– zdefiniować zmienne globalne w pliku konfiguracyjnym,
– używać tagów do grupowania workflow,
– ustawiać limity i parametry działania instancji (np. maxConcurrentExecutions).
8.7 Podsumowanie
Zastosowanie zmiennych i konfiguracji środowiskowej pozwala budować skalowalne, bezpieczne i łatwe w utrzymaniu workflowy. W kolejnym rozdziale przejdziemy do konkretnych przykładów gotowych automatyzacji w n8n.
Podstawy n8n – Rozdział 9: Przykłady gotowych automatyzacji
W tym rozdziale przedstawiamy konkretne przykłady workflowów w n8n, które możesz wykorzystać w codziennej pracy. Są to popularne scenariusze automatyzacji, które ułatwiają zarządzanie danymi, komunikację oraz integrację systemów.
9.1 Pobieranie danych z API i zapis do Google Sheets
1. Node HTTP Request – pobiera dane z API (np. kursy walut).
2. Node Function – przekształca dane do pożądanego formatu.
3. Node Google Sheets – zapisuje dane w arkuszu kalkulacyjnym.
9.2 Wysyłka raportu e-mail codziennie rano
1. Node Cron – uruchamia workflow o 7:00 rano każdego dnia.
2. Node HTTP Request – pobiera dane z systemu ERP.
3. Node Function – generuje treść raportu.
4. Node Email – wysyła wiadomość do wskazanych odbiorców.
9.3 Notyfikacje o błędach na Slacka
1. Node Error Trigger – reaguje na błędy w innych workflow.
2. Node Slack – wysyła wiadomość z opisem błędu do kanału #alerts.
9.4 Tworzenie leadów w CRM z formularza kontaktowego
1. Node Webhook – odbiera dane z formularza.
2. Node Function – waliduje dane i sprawdza wymagane pola.
3. Node Pipedrive lub HubSpot – tworzy nowy lead w CRM.
4. Node Email – wysyła potwierdzenie do użytkownika.
9.5 Automatyczna synchronizacja danych między bazą danych a Google Sheets
1. Node Cron – uruchamia workflow co godzinę.
2. Node MySQL/Postgres – pobiera dane z bazy.
3. Node Google Sheets – aktualizuje dane w arkuszu.
9.6 Podsumowanie
n8n pozwala tworzyć bardzo różnorodne automatyzacje – od prostych powiadomień, po złożone procesy integrujące kilka systemów. W kolejnym rozdziale dowiesz się, jak wdrażać te rozwiązania w środowisku produkcyjnym i zadbać o bezpieczeństwo.
Podstawy n8n – Rozdział 10: Wdrożenie, backup i bezpieczeństwo
W tym rozdziale przedstawiamy dobre praktyki związane z wdrażaniem workflowów n8n w środowisku produkcyjnym. Omówimy również metody tworzenia kopii zapasowych oraz podstawy bezpieczeństwa.
10.1 Eksport i import workflowów
n8n umożliwia eksportowanie workflowów do plików JSON oraz ich ponowny import. Jest to przydatne przy przenoszeniu konfiguracji między środowiskami (np. testowe → produkcyjne).
– Eksport: kliknij „Download” na pasku narzędzi.
– Import: użyj opcji „Import from file” lub przeciągnij plik JSON do obszaru roboczego.
10.2 Backup danych n8n
W zależności od trybu instalacji (Docker lub lokalnie), dane n8n są przechowywane w:
– plikach (np. SQLite w katalogu `.n8n/`)
– bazie danych (np. PostgreSQL lub MySQL)
Aby utworzyć kopię zapasową:
– wykonaj backup katalogu `.n8n` lub bazy danych,
– przechowuj backup w bezpiecznym miejscu,
– zadbaj o automatyzację kopii zapasowych (np. cron + rsync/skrypt bash).
10.3 Hasła i dane wrażliwe
Nie zapisuj haseł i tokenów bezpośrednio w node’ach. Używaj:
– zmiennych środowiskowych (ENV),
– mechanizmu Credentials n8n,
– Secrets, jeśli tworzysz niestandardową instancję.
Pamiętaj również, aby nie udostępniać workflowów z osadzonymi tokenami.
10.4 Autoryzacja i dostęp do n8n
Jeśli korzystasz z n8n lokalnie lub przez Docker, zadbaj o zabezpieczenie dostępu do interfejsu:
– włącz Basic Auth (N8N_BASIC_AUTH_ACTIVE=true),
– nie udostępniaj portu 5678 bezpośrednio do Internetu,
– stosuj reverse proxy z autoryzacją i SSL (np. Traefik, Nginx).
W przypadku instalacji w chmurze, upewnij się, że wszystkie endpointy są odpowiednio chronione.
10.5 Monitorowanie i logowanie
n8n domyślnie loguje błędy do konsoli. W środowiskach produkcyjnych warto podłączyć zewnętrzne narzędzia do logowania (np. Papertrail, Grafana Loki) lub pisać własne logi do plików/logów systemowych.
Możesz też tworzyć własne workflowy do monitoringu i raportowania np. nieudanych prób wykonania.
10.6 Aktualizacje i migracje
– Regularnie aktualizuj n8n do najnowszej wersji (poprawki bezpieczeństwa).
– Sprawdzaj changelogi i planuj migracje środowisk.
– Testuj zmiany na kopii środowiska przed wdrożeniem produkcyjnym.
10.7 Podsumowanie
Bezpieczne i stabilne wdrożenie n8n wymaga przemyślanej strategii zarządzania danymi, kopiami zapasowymi, autoryzacją i aktualizacjami. Dzięki tym praktykom Twoje workflowy będą działały niezawodnie i bezpiecznie nawet w środowisku produkcyjnym.
Glosariusz
Poniżej znajduje się zestawienie najważniejszych terminów używanych w podręczniku „Podstawy n8n”.
n8n
Otwarta platforma do automatyzacji procesów i integracji aplikacji.
Workflow
Zbiór połączonych ze sobą node’ów, które realizują określony proces.
Node
Podstawowy blok w workflow wykonujący określoną akcję (np. pobranie danych, wysłanie e-maila).
Trigger
Node rozpoczynający działanie workflow (np. Cron, Webhook).
Action
Node wykonujący działanie na danych (np. zapis do bazy, wysyłka wiadomości).
Webhook
Publiczny adres URL, który może odbierać dane i uruchamiać workflow.
Function
Node pozwalający na własne przetwarzanie danych w języku JavaScript.
Set
Node umożliwiający tworzenie lub modyfikację danych JSON.
Merge
Node łączący dane z dwóch różnych strumieni.
IF
Node służący do podejmowania decyzji na podstawie warunków logicznych.
Execute Workflow
Node pozwalający na uruchomienie innego workflow w ramach obecnego.
ENV Variable
Zmienna środowiskowa używana do przechowywania danych konfiguracyjnych i poufnych.
Secrets
Bezpieczny sposób przechowywania poufnych informacji takich jak hasła i tokeny.
Basic Auth
Podstawowy mechanizm zabezpieczający dostęp do instancji n8n przy użyciu loginu i hasła.
Error Trigger
Node reagujący na błędy w innych workflow.
Cron
Node uruchamiający workflow według zadanego harmonogramu.
JSON
Format danych używany w n8n do przekazywania informacji między node’ami.
Credentials
Mechanizm do bezpiecznego przechowywania danych logowania do zewnętrznych usług.