n8n - ghid de inițiere
n8n este un instrument open-source de automatizare a fluxurilor de lucru care vă permite să conectați aplicații, API-uri și servicii cu un editor vizual drag-and-drop. Funcționează ca Zapier sau Make, dar rulează în întregime pe serverul dumneavoastră. Cu peste 400 de integrări și suport pentru cod personalizat, se potrivește atât automatizărilor simple, cât și fluxurilor complexe în mai mulți pași. Contul de proprietar este creat automat la provizionare, cu domeniul, e-mailul și parola introduse la comandă.
Pasul 1 – Verificați funcționarea n8n
Adresa IP și parola root a serverului sunt afișate pe pagina Server Details din panoul clientului. Deschideți browserul și accesați:
http://your.server.ip
Autentificați-vă cu e-mailul și parola introduse la comandă. Contul de proprietar a fost creat automat în timpul configurării.
Dacă pagina de autentificare se încarcă și vă puteți conecta, n8n funcționează corect.
Dacă ați plasat serverul în spatele unui router VyOS într-o rețea privată, configurați redirecționarea porturilor (22, 80 și 443) pentru ca n8n să fie accesibil de pe internet (necesar pentru webhook-uri de la servicii externe) sau conectați-vă prin VPN și accesați n8n pe IP-ul privat al serverului.
Pasul 2 – Configurarea unui domeniu propriu (opțional)
Dacă ați introdus un nume de domeniu la comandă, direcționați-l către server creând o înregistrare DNS A:
your-domain.com -> your.server.ip
Modificările DNS durează de obicei câteva minute, dar pot dura până la 24 de ore. Puteți verifica starea pe dnschecker.org.
Pasul 3 – Activarea SSL cu Let’s Encrypt
După ce domeniul se rezolvă la IP-ul serverului, conectați-vă prin SSH și rulați:
ssh root@your.server.ip
/opt/setup/get-ssl.sh
Scriptul va configura automat Nginx cu domeniul, va obține un certificat gratuit Let’s Encrypt și va trece n8n pe HTTPS. După finalizare, n8n va fi disponibil la https://your-domain.com. Reînnoirea automată este deja configurată.
După instalare
Fail2Ban – protecție împotriva atacurilor brute-force
Serverul dumneavoastră include Fail2Ban preconfigurat pentru a proteja SSH împotriva atacurilor brute-force.
| Regulă | Încercări maxime | Durata blocării |
|---|---|---|
| SSH | 5 autentificări eșuate | 10 minute |
Comenzi utile:
# Check banned IPs
fail2ban-client status sshd
# Unban an IP
fail2ban-client set sshd unbanip 1.2.3.4
Dacă vă blocați accidental, conectați-vă prin consola VNC din panoul clientului și deblocați-vă IP-ul.
Administrarea serviciilor
# Check n8n service status
systemctl status n8n
# View n8n logs
journalctl -u n8n -f
# Restart n8n
systemctl restart n8n
# View setup log
cat /opt/setup/setup.log
Backup-uri
n8n stochează toate datele (fluxuri de lucru, credențiale, istoricul execuțiilor) într-o bază de date SQLite:
# Back up n8n data
cp -r /root/.n8n /root/n8n-backup-$(date +%Y%m%d)
# Or export workflows via CLI
n8n export:workflow --all --output=/root/workflows-backup.json
Actualizări
# Update n8n
npm install -g n8n
systemctl restart n8n
# Update OS packages
apt update && apt upgrade -y
Software inclus
| Componentă | Versiune |
|---|---|
| Ubuntu | 24.04 LTS |
| n8n | Cea mai recentă |
| Node.js | 22.x LTS |
| Nginx | 1.24 |
| Certbot | 2.9 |
| Fail2Ban | 1.0.2 |
Depanare
| Problemă | Soluție |
|---|---|
| Interfața web n8n nu poate fi accesată | Verificați dacă n8n rulează: systemctl status n8n. Verificați și Nginx: systemctl status nginx |
| n8n afișează „Not Found” sau o pagină goală | Reporniți n8n: systemctl restart n8n. Așteptați 10-15 secunde și reîmprospătați pagina |
| Scriptul SSL eșuează cu o eroare DNS | Asigurați-vă că înregistrarea A a domeniului indică IP-ul serverului. Verificați cu: dig +short your-domain.com |
| Pagina de autentificare afișează „wrong credentials” | Folosiți e-mailul și parola introduse la comandă. Dacă le-ați uitat, verificați detaliile comenzii în panoul clientului |
| Fluxurile de lucru nu se execută | Verificați logurile n8n: journalctl -u n8n --since "1 hour ago". Asigurați-vă că fluxul de lucru este setat ca Active |
| Webhook-urile nu sunt accesibile din exterior | Configurați un domeniu și activați SSL. URL-urile webhook se actualizează automat după configurarea SSL |
| Blocat de Fail2Ban | Deblocați-vă IP-ul prin consola VNC din panoul clientului |
| Ați uitat parola root | Resetați-o prin consola VNC din panoul clientului |