O n8n
n8n to wizualne narzędzie do automatyzacji workflow. Na kanwie łączysz węzły (webhooki, zapytania HTTP, bazy danych, e-mail, usługi SaaS), a gdy pojedynczy węzeł nie wystarcza, dopisujesz kod w JavaScripcie lub Pythonie. W wersji self-hosted dane i poświadczenia zostają na Twoim serwerze, a nie u zewnętrznego dostawcy.
Po dostawie skrypt z receptury instaluje Dockera (jeśli go brakuje), a następnie uruchamia z katalogu /opt/n8n dwa kontenery przez Docker Compose: n8n (obraz docker.n8n.io/n8nio/n8n:latest) oraz Caddy 2. n8n nasłuchuje wyłącznie na 127.0.0.1:5678. Caddy, działający w trybie sieci hosta, udostępnia usługę przez HTTPS na porcie 443 i przekazuje ruch do n8n.
Certyfikat jest samopodpisany (dyrektywa tls internal w Caddy) i powiązany z publicznym adresem IP serwera. Przy pierwszej wizycie przeglądarka wyświetli więc ostrzeżenie. Dopóki nie przypiszesz domeny, jest to zachowanie normalne. Dane n8n są przechowywane w wolumenie Dockera (n8n_data), a strefa czasowa jest ustawiona na Europe/Paris.
Co możesz zrobić z n8n
Wizualny edytor workflow
Wyzwalacze, warunki i akcje składasz na kanwie. Każde wykonanie możesz przejrzeć węzeł po węźle, co bardzo ułatwia debugowanie.
Webhooki i wywołania HTTP
Workflow może wystartować od przychodzącego żądania albo odpytać dowolne API REST. Serwer jest już skonfigurowany tak, by adresy URL webhooków budować z HTTPS.
Kod w JavaScripcie lub Pythonie
Węzeł Code pozwala przekształcać dane lub zapisać logikę, której standardowe węzły nie pokrywają, bez opuszczania workflow.
Dane na Twoim serwerze
Workflow, poświadczenia i historia wykonań pozostają w wolumenie Dockera
n8n_datana Twoim VPS w Paryżu lub Frankfurcie.HTTPS przez Caddy od startu
n8n jest przypisany do
127.0.0.1, a na zewnątrz wystawiony jest tylko Caddy na porcie 443. Przejście na pełnoprawny certyfikat sprowadza się do zmiany jednego pliku.Automatyczny start po restarcie
Oba kontenery mają ustawione
restart: always. Po ponownym uruchomieniu serwera n8n i Caddy startują bez Twojej ingerencji.
Pierwsze kroki z n8n
Od zamówienia do produkcji w kilka minut.
- 1
Zamów VPS z n8n
Wybierz VPS z Linuxem w Paryżu lub Frankfurcie i zaznacz n8n w zakładce „Aplikacje” formularza zamówienia. Dostępne systemy to Debian 12, Debian 13 oraz Ubuntu 20.04, 22.04 i 24.04.
- 2
Poczekaj na dostawę i sprawdź usługi
Skrypt uruchamia się przy pierwszym starcie systemu: instaluje Dockera, a potem startuje kontenery, co trwa kilka minut. Połącz się przez SSH, używając danych dostępowych z dostawy, i sprawdź, czy n8n i Caddy działają.
Bashcd /opt/n8n && docker compose ps - 3
Utwórz konto właściciela
Otwórz w przeglądarce https://SERVER_IP i zaakceptuj ostrzeżenie o certyfikacie samopodpisanym. n8n poprosi o założenie konta właściciela, które administruje całą instancją.
- 4
Przełącz się na domenę z HTTPS
Utwórz rekord DNS A wskazujący YOUR_DOMAIN na SERVER_IP, a potem podmień Caddyfile i zmienne n8n. Caddy automatycznie uzyska wtedy uznawany certyfikat, pod warunkiem że porty 80 i 443 są osiągalne.
Bashcd /opt/n8n cat > Caddyfile <<'EOF' YOUR_DOMAIN { reverse_proxy 127.0.0.1:5678 } EOF sed -i 's|N8N_HOST=.*|N8N_HOST=YOUR_DOMAIN|; s|WEBHOOK_URL=.*|WEBHOOK_URL=https://YOUR_DOMAIN/|' docker-compose.yml docker compose up -d docker compose restart caddy
Zastosowania n8n
Synchronizacja narzędzi firmowych
Nowy lead z formularza tworzy kartę w CRM, wysyła e-mail z potwierdzeniem i powiadamia zespół w komunikatorze. Całość mieści się w jednym workflow.
Obsługa przychodzących webhooków
Płatności, repozytoria Git czy alerty z monitoringu mogą uruchamiać workflow, które filtrują, wzbogacają i rozsyłają zdarzenia dalej. Wymaga to domeny z ważnym certyfikatem, bo większość usług odrzuca certyfikaty samopodpisane.
Zadania harmonogramowane
Eksporty baz danych, raporty tygodniowe, porządkowanie danych: wyzwalacz cron zastępuje skrypty rozrzucone po kilku maszynach.
Podłączanie modeli AI
n8n potrafi wywoływać API modeli językowych z poziomu workflow, na przykład do klasyfikowania zgłoszeń lub streszczania e-maili, zanim trafią do właściwej osoby.
Najczęstsze pytania o n8n
Certyfikat generuje Caddy (tls internal) dla adresu IP serwera: w tej konfiguracji żaden publiczny urząd certyfikacji nie wystawi certyfikatu dla samego IP. Szyfrowanie działa, ale certyfikat nie jest uznawany przez przeglądarkę. Po przypisaniu domeny Caddy uzyska ważny certyfikat.
Więcej o n8n
Zainstalowane pliki
Wszystko znajduje się w /opt/n8n: skrypt install-n8n.sh, plik docker-compose.yml oraz Caddyfile. Tworzone są trzy wolumeny Dockera: n8n_data (dane n8n, w tym klucz szyfrujący poświadczenia), caddy_data i caddy_config.
Zmienne N8N_HOST i WEBHOOK_URL zawierają publiczny adres IP wykryty podczas instalacji. Jeśli zmienisz adres lub domenę, zaktualizuj je, bo w przeciwnym razie adresy webhooków wyświetlane w interfejsie będą błędne.
Zapora sieciowa
n8n nie jest wystawiony bezpośrednio, ale port 443 jest otwarty przez Caddy. Resztę ogranicz: wystarczą SSH, port 80 (potrzebny do wydania certyfikatu Let's Encrypt) i 443.
Bashufw allow 22/tcp ufw allow 80/tcp ufw allow 443/tcp ufw enable
Zezwól na SSH przed włączeniem zapory, inaczej stracisz bieżącą sesję.
Kopie zapasowe
Najważniejsze dane leżą w wolumenie n8n. Docker Compose dodaje do jego nazwy prefiks z nazwą katalogu projektu: sprawdź ją poleceniem docker volume ls (zwykle jest to n8n_n8n_data), a potem zarchiwizuj wolumen.
Bashdocker run --rm -v n8n_n8n_data:/data -v /root:/backup alpine \ tar czf /backup/n8n-data-$(date +%F).tar.gz -C /data .
Skopiuj archiwum poza serwer. Bez klucza szyfrującego zapisanego w tym wolumenie nie odzyskasz poświadczeń zapisanych w n8n.
Aktualizacje
Plik Compose używa tagu latest. Aby zaktualizować:
Bashcd /opt/n8n docker compose pull docker compose up -d
Najpierw zrób kopię zapasową. W instancji produkcyjnej możesz zastąpić latest konkretnym numerem wersji w docker-compose.yml i podnosić wersję dopiero wtedy, gdy zdecydujesz, po przeczytaniu informacji o wydaniu.
