n8n self-hosted: ghid pentru Ubuntu 24.04 cu Docker și HTTPS

Ca să găzduiți singur n8n, aveți nevoie de un VPS cu Ubuntu 24.04, un subdomeniu precum n8n.firma-dumneavoastra.ch, Docker cu Docker Compose și un reverse proxy care obține certificatul HTTPS. Acest ghid urmează documentația oficială n8n (stadiul: octombrie 2026, n8n 2.x) și folosește Caddy ca reverse proxy. Cu puțină experiență Linux, n8n este online în aproximativ o oră; după aceea, actualizările, backupurile și securitatea sunt sarcina dumneavoastră.

Ce este n8n?

n8n este un instrument de automatizare a fluxurilor de lucru (workflow-uri). Într-un editor grafic conectați servicii precum e-mailul, Google Sheets, CRM-ul, contabilitatea, webhook-uri sau modele AI în procese automate: un formular de contact nou ajunge singur în CRM, o factură este arhivată ca PDF, un raport pleacă prin e-mail în fiecare luni. Acolo unde nu există un nod gata făcut, vă ajută cererile HTTP și propriul cod JavaScript sau Python.

De ce să găzduiți n8n pe cont propriu?

• Controlul datelor: workflow-urile, datele de acces și datele execuțiilor rămân pe serverul dumneavoastră. Astfel respectați mai ușor cerințele Legii federale privind protecția datelor (nLPD) și ale contractelor cu clienții.
• Costuri: Community Edition este gratuită. Plătiți serverul, nu numărul de execuții.
• Libertate: noduri proprii din comunitate, orice variabile de mediu și acces direct la sistemele interne din aceeași rețea.
• Dar: sunteți responsabil pentru funcționare, actualizări, backupuri și securitate. Chiar n8n recomandă explicit găzduirea proprie persoanelor cu experiență în administrarea serverelor.

Cerințe

• Un server VPS cu Ubuntu 24.04 LTS și acces root sau sudo prin SSH.
• Memorie: 2 GB RAM și 1–2 vCPU sunt suficiente pentru început. Pentru n8n Assistant cu sandbox, documentația indică cel puțin 4 GB RAM și 2 vCPU.
• Spațiu: 25 GB sunt suficienți la început. Implicit, n8n șterge datele execuțiilor după 336 de ore (14 zile); se poate modifica prin variabila EXECUTIONS_DATA_MAX_AGE.
• Un domeniu la care puteți seta înregistrări DNS, de exemplu pentru n8n.firma-dumneavoastra.ch.
• O adresă de e-mail pentru certificatul Let’s Encrypt.

Pasul 1: pregătiți serverul și firewall-ul

Conectați-vă prin SSH, actualizați sistemul și creați un utilizator propriu, ca să nu lucrați permanent ca root:

1. sudo apt update && sudo apt upgrade -y
2. sudo adduser numeutilizator
3. sudo usermod -aG sudo numeutilizator
4. Adăugați o cheie SSH pentru noul utilizator, apoi conectați-vă din nou ca numeutilizator.
5. sudo ufw allow OpenSSH
6. sudo ufw allow 80
7. sudo ufw allow 443
8. sudo ufw enable

Pasul 2: instalați Docker și Docker Compose

Instalați Docker din depozitul oficial Docker, nu vechiul pachet Ubuntu docker.io. Comenzile corespund ghidului de pe docs.docker.com pentru Ubuntu 24.04 (Noble):

1. sudo apt install ca-certificates curl git
2. sudo install -m 0755 -d /etc/apt/keyrings
3. sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
4. sudo chmod a+r /etc/apt/keyrings/docker.asc
5. Creați fișierul /etc/apt/sources.list.d/docker.sources (sudo nano /etc/apt/sources.list.d/docker.sources) cu aceste cinci rânduri: Types: deb / URIs: https://download.docker.com/linux/ubuntu / Suites: noble / Components: stable / Signed-By: /etc/apt/keyrings/docker.asc
6. sudo apt update
7. sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
8. Verificare: docker --version și docker compose version, apoi sudo docker run hello-world

Pasul 3: setați înregistrarea DNS

La furnizorul DNS, creați o înregistrare A pentru subdomeniu, de exemplu n8n.firma-dumneavoastra.ch, care să indice adresa IPv4 a VPS-ului. Așteptați până când înregistrarea este rezolvată (test cu ping n8n.firma-dumneavoastra.ch). Abia apoi poate Caddy să obțină certificatul.

Pasul 4: instalați n8n cu Caddy

n8n oferă un depozit de configurare gata făcut, cu Docker Compose și Caddy. Caddy obține și reînnoiește automat certificatul Let’s Encrypt.

1. cd ~ && git clone https://github.com/n8n-io/n8n-docker-caddy.git
2. cd n8n-docker-caddy
3. sudo docker volume create caddy_data
4. sudo docker volume create n8n_data
5. nano .env și ajustați valorile (vezi mai jos).
6. nano caddy_config/Caddyfile și înlocuiți substituentul din primul rând cu n8n.firma-dumneavoastra.ch.
7. nano docker-compose.yml și, la serviciul n8n, schimbați rândul de port 5678:5678 în 127.0.0.1:5678:5678.
8. sudo docker compose up -d
9. Deschideți https://n8n.firma-dumneavoastra.ch în browser și creați contul de proprietar.

Sfat: Schimbarea în 127.0.0.1:5678 este importantă: Docker publică porturile ocolind firewall-ul UFW. Fără această modificare, n8n ar fi accesibil și necriptat la http://adresa-IP:5678. Caddy ajunge la n8n intern, prin rețeaua Docker, și nu are nevoie de port.

Cele mai importante variabile de mediu

• DATA_FOLDER=/home/numeutilizator/n8n-docker-caddy – calea către folderul clonat.
• DOMAIN_NAME=firma-dumneavoastra.ch și SUBDOMAIN=n8n – împreună dau adresa https://n8n.firma-dumneavoastra.ch.
• GENERIC_TIMEZONE=Europe/Zurich – fusul orar pentru programări (Schedule Trigger).
• SSL_EMAIL=it@firma-dumneavoastra.ch – adresa de contact pentru certificat.
• În docker-compose.yml, depozitul setează deja N8N_HOST, N8N_PROTOCOL=https și WEBHOOK_URL, ca adresele webhook să înceapă corect cu https.
• Opțional, sub environment: TZ=Europe/Zurich, N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true (ca în șablonul Compose oficial) și N8N_DIAGNOSTICS_ENABLED=false dacă nu doriți să trimiteți telemetrie către n8n.

Actualizări: n8n și serverul la zi

n8n publică o nouă versiune minoră aproape în fiecare săptămână. Imaginea fără număr de versiune (latest) este versiunea stabilă pentru producție; tag-ul next este o versiune preliminară instabilă. Pentru actualizare:

1. Mai întâi faceți un backup (vezi secțiunea următoare).
2. cd ~/n8n-docker-caddy
3. sudo docker compose pull
4. sudo docker compose down
5. sudo docker compose up -d
6. Testați scurt workflow-urile. Înainte de salturi mari de versiune, citiți notele de lansare și modificările incompatibile (breaking changes).

Și Ubuntu are nevoie de actualizări. Instalați automat actualizările de securitate cu sudo apt install unattended-upgrades și verificați regulat dacă este nevoie de o repornire.

Backupul datelor n8n

Tot ce contează se află în volumul Docker n8n_data: baza de date SQLite cu workflow-uri și execuții, precum și cheia de criptare cu care n8n vă criptează datele de acces. Fără această cheie, datele de acces salvate sunt inutilizabile. Faceți deci backup în două moduri:

1. Export în fișiere: sudo docker compose exec -u node n8n n8n export:workflow --backup --output=/files/backup/workflows/
2. sudo docker compose exec -u node n8n n8n export:credentials --backup --output=/files/backup/credentials/
3. Exporturile ajung pe server, în folderul local_files/backup. Datele de acces rămân criptate.
4. Volumul complet: sudo docker compose stop, apoi sudo docker run --rm -v n8n_data:/data -v $(pwd):/backup alpine tar czf /backup/n8n_data-$(date +%F).tar.gz -C /data . și la final sudo docker compose start.
5. Copiați backupurile pe alt sistem cu rsync sau scp; nu le lăsați doar pe VPS.

Sfat: Notați cheia de criptare și în managerul de parole. Se află în fișierul config din volumul n8n_data (afișare cu sudo docker compose exec n8n cat /home/node/.n8n/config).

Securitate: ce trebuie să protejați singur

• Firewall: deschideți doar porturile 22, 80 și 443; legați portul 5678 doar la 127.0.0.1.
• SSH: autentificare doar cu cheie; în /etc/ssh/sshd_config setați PasswordAuthentication no.
• Nu aveți nevoie de basic auth: din n8n 1.0, gestionarea integrată a utilizatorilor protejează interfața. Activați autentificarea cu doi factori în setările personale.
• Actualizări: actualizați regulat imaginea n8n, imaginea Caddy și Ubuntu. Vulnerabilitățile din n8n sunt remediate în versiunile noi.
• Webhook-uri: protejați webhook-urile de producție cu verificare de header sau token, pentru că sunt accesibile fără autentificare.
• Noduri din comunitate: instalați-le doar din surse de încredere, deoarece rulează cu drepturile n8n.

Ce server VPS se potrivește pentru n8n?

Pentru câteva zeci de workflow-uri ajunge un server mic. La HostOn alegeți Ubuntu 24.04 direct la comandă. VPS CORE 1 (1 vCPU, 2 GB RAM, 25 GB SSD) la CHF 11.90 pe lună este suficient pentru început; cu VPS CORE 2 (2 vCPU, 4 GB RAM, 50 GB SSD) la CHF 19.90 pe lună aveți rezervă pentru multe workflow-uri sau pentru n8n Assistant. Ambele sunt unmanaged, cu reziliere lunară: instalarea, actualizările și backupurile n8n le faceți singur, așa cum este descris mai sus.