Как да хоствате n8n самостоятелно на Linux VPS (стъпка по стъпка)

Въведение

n8n е един от най-мощните инструменти за автоматизация на работните процеси с отворен код, налични днес. За разлика от SaaS алтернативи като Zapier или Make, n8n ви дава пълен контрол над вашите данни и автоматизации — но само когато го хоствате сами. Linux VPS е идеалната среда за това: винаги активна, достъпна и изцяло под ваш контрол.

Това ръководство ви води през целия процес на настройка на готова за производствена употреба, самостоятелно хоствана инстанция на n8n на Linux VPS. Ще преминете от празен сървър до напълно защитена, поддържаща SSL инсталация на n8n с Docker, Nginx, PostgreSQL, автоматизирани резервни копия и засилена конфигурация за сигурност.

Ключови изводи

• n8n на VPS ви предоставя неограничен брой работни потоци, без ограничения за използване и пълна собственост върху данните
• Docker е препоръчителният метод за инсталиране за по-лесни актуализации и изолация
• PostgreSQL е препоръчителната база данни за производствени натоварвания (а не SQLite)
• За производствена употреба е необходим обратен прокси (Nginx) с SSL сертификат от Let’s Encrypt
• Вашият VPS трябва да разполага с поне 1 vCPU и 2 GB RAM за безпроблемна работа с n8n и PostgreSQL
• Редовните автоматизирани архивирания защитават данните от работните ви потоци и вашите идентификационни данни

Какво е n8n?

n8n (произноси се „ен-осем-ен“) е платформа за автоматизация на работни потоци с отворен код, която ви позволява да свързвате приложения, API-та и услуги чрез визуален редактор, базиран на възли. Тя поддържа над 400 интеграции още от самото начало и ви позволява да изпълнявате персонализиран JavaScript или Python код в работните потоци.

Основната разлика между n8n и конкурентите му се свежда до три неща: собственост, цена и гъвкавост.

**Собственост: **Когато хоствате n8n самостоятелно, данните за вашите работни потоци, удостоверенията за достъп и логовете за изпълнение никога не напускат вашия сървър. За екипи, които работят с чувствителни клиентски данни, финансови записи или собствена бизнес логика, това е от огромно значение. Облачните платформи съхраняват вашата логика за автоматизация на тяхната инфраструктура, като тя е подчинена на техните политики за съхранение на данни и нивото на сигурност.

**Цена: **Облачният план на n8n се таксува за всяко изпълнение на работен поток, което бързо води до високи разходи при автоматизации с голям обем. Един екип от среден размер, който изпълнява хиляди работни потоци на ден, може да харчи стотици долари месечно. На вашия собствен VPS, след като платите за сървъра, изпълненията са неограничени без допълнителни разходи.

**Гъвкавост: **Самохостната версия на n8n ви позволява да инсталирате възли от общността, да изпълнявате произволен код в рамките на работните потоци, да се свързвате с вътрешни услуги, недостъпни от публичния интернет, и да конфигурирате всеки аспект на внедряването според вашите предпочитания. Облачните планове ограничават много от тези възможности.

Предварителни изисквания

Преди да започнете, уверете се, че разполагате с:

• Linux VPS, работещ с Ubuntu 22.04 или 24.04 (препоръчително). Проверете дали вашият доставчик предлага Ubuntu за избрания от вас план, тъй като някои планове от начално ниво предлагат само други дистрибуции
• Потребител без root права, но с sudo привилегии
• Домейн, насочен към IP адреса на вашия VPS (например, n8n.yourdomain.com)
• SSH достъп до вашия сървър
• Основни познания за командния ред на Linux

Избор на подходящ VPS

Сървърът, който изберете, оказва пряко влияние върху производителността на n8n. Като минимум са ви необходими 1 vCPU, 2 GB RAM и 20 GB SSD памет. Допълнителната RAM в сравнение с минималната инсталация, базирана на SQLite, е необходима, защото PostgreSQL, Nginx и n8n работят едновременно.

За екипи с много потребители, сложни многоетапни работни потоци или висока пропускателна способност на уебхукове, преминете към 2 vCPU и 4 GB RAM. Паметта трябва да е минимум 40 GB, ако планирате да съхранявате дълги логове за изпълнение.

PetroSky предлага NVMe VPS планове в Париж и Монреал, като n8n е достъпен като приложение с едно кликване при плащане: скрипт за инсталиране с отворен код разгръща n8n с Docker Compose и автоматично настройва HTTPS чрез Caddy и Let’s Encrypt. Това ръководство обхваща ръчния начин, който работи при всеки доставчик.

Когато избирате доставчик на VPS, имайте предвид и географското местоположение. Хоствайте вашия n8n инстанс в региона, най-близък до услугите, към които той ще се свързва най-често — това намалява латентността на API при изпълнението на вашите работни потоци.

Стъпка 1: Актуализирайте сървъра си

Свържете се чрез SSH с вашия VPS и изпълнете пълна актуализация на системата, преди да инсталирате каквото и да било:

    sudo apt update && sudo apt upgrade -y

Това гарантира, че разполагате с най-новите кръпки за сигурност и че всички системни библиотеки са актуални, преди да добавите Docker и друг софтуер отгоре.

Рестартирайте, ако е приложена актуализация на ядрото:

    sudo reboot

След като се свържете отново чрез SSH, създайте специален системeн потребител за стартиране на n8n. Изпълняването на услуги като root представлява риск за сигурността:

    sudo adduser n8nuser
    sudo usermod -aG sudo n8nuser
    su - n8nuser

Стъпка 2: Инсталиране на Docker и Docker Compose

Официалният препоръчван метод за инсталиране на n8n е Docker. Docker изолира n8n и неговите зависимости от останалата част на системата ви, което улеснява актуализациите и връщането към предишни версии.

Инсталирайте Docker, като използвате официалния скрипт за улеснение:

    curl -fsSL https://get.docker.com | sudo sh

В документацията на Docker се отбелязва, че скриптът за улеснение не се препоръчва за производствени среди, тъй като инсталира най-новата версия, без да ви позволява да изберете версия. Ако искате да фиксирате версиите на Docker, използвайте вместо това метода с apt репозиторията от ръководството за инсталиране на Docker за Ubuntu (docs.docker.com/engine/install/ubuntu/).

Добавете своя потребител към групата Docker, за да можете да изпълнявате команди на Docker без sudo:

    sudo usermod -aG docker $USER
    newgrp docker

Проверете дали Docker работи правилно:

    docker --version
    docker compose version

И двете команди трябва да върнат версиите без грешки. Ако Docker Compose не бъде открит, инсталирайте го ръчно:

    sudo apt install docker-compose-plugin -y

Стъпка 3: Настройте PostgreSQL за производствена среда

По подразбиране n8n използва SQLite като своя база данни. SQLite е подходящ за лична употреба и леки работни потоци, но се справя зле с едновременните записи, което се проявява като забавяния и грешки от типа „базата данни е заключена“, когато много работни потоци се изпълняват едновременно. За внедряване в производствена среда PostgreSQL е правилният избор.

Стартирайте PostgreSQL в Docker заедно с n8n:

    mkdir ~/n8n && cd ~/n8n

Създайте файл за средата, в който да съхранявате вашите секретни данни безопасно. Никога не записвайте пароли на твърдо в файла compose:

    nano ~/n8n/.env

Добавете следното, като замените стойностите на заместващите символи със силни и уникални пароли:

    POSTGRES_USER=n8n
    POSTGRES_PASSWORD=вашата_силна_парола_за_базата_данни_тук
    POSTGRES_DB=n8n
    N8N_ENCRYPTION_KEY=вашият_случаен_низ_от_32_символа_тук

Генерирайте сигурен ключ за криптиране с:

    openssl rand -hex 16

Използвайте получения резултат като ваш N8N_ENCRYPTION_KEY. Този ключ криптира данните за достъп, съхранени в n8n — ако го загубите, всички запазени данни за достъп стават невъзстановими.

Стъпка 4: Създайте файла n8n Docker Compose

Създайте файла docker-compose.yml във вашата директория n8n:

    nano ~/n8n/docker-compose.yml

Поставете следната конфигурация:

services:
  postgres:
    image: postgres:16-alpine
    restart: always
    environment:
      - POSTGRES_USER=${POSTGRES_USER}
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
      - POSTGRES_DB=${POSTGRES_DB}
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -h localhost -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
      interval: 5s
      timeout: 5s
      повторения: 10


  n8n:
    изображение: docker.n8n.io/n8nio/n8n
    рестартиране: винаги
    портове:
      - "127.0.0.1:5678:5678"
    среда:
      - N8N_HOST=n8n.yourdomain.com
      - N8N_PORT=5678
      - N8N_PROTOCOL=https
      - NODE_ENV=production
      - WEBHOOK_URL=https://n8n.yourdomain.com/
      - GENERIC_TIMEZONE=Europe/London
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=${POSTGRES_DB}
      - DB_POSTGRESDB_USER=${POSTGRES_USER}
      - DB_POSTGRESDB_PASSWORD=${POSTGRES_PASSWORD}
      - N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}
      - EXECUTIONS_MODE=regular
      - N8N_LOG_LEVEL=info
    volumes:
      - n8n_data:/home/node/.n8n
    depends_on:
      postgres:
        condition: service_healthy


volumes:
  postgres_data:
  n8n_data:

Забележки за конфигурацията:

• Свързването на порт 127.0.0.1:5678:5678 гарантира, че n8n е достъпен само локално. Nginx ще обработва целия външен трафик — никога не излагайте порт 5678 директно в интернет.
• depends_on с условието service_healthy гарантира, че n8n ще изчака PostgreSQL да е напълно готов, преди да стартира. Без това n8n ще се провали при първото стартиране, ако базата данни все още не приема връзки.
• N8N_LOG_LEVEL=info ви предоставя полезни оперативни логове, без да препълва дисковото пространство, както би станало с опцията debug.

Стъпка 5: Инсталиране и конфигуриране на Nginx

Nginx ще действа като обратен прокси, препращайки HTTPS трафика от порт 443 към вашия n8n контейнер на порт 5678. Той също така се занимава с SSL терминирането, което означава, че самият n8n не се налага да управлява сертификати.

    sudo apt install nginx -y

Премахнете сайта по подразбиране и създайте нов сървър блок за n8n:

    sudo rm /etc/nginx/sites-enabled/default
    sudo nano /etc/nginx/sites-available/n8n

Поставете следното:

    map $http_upgrade $connection_upgrade {
        default upgrade;
        ''      close;
    }
server {
    listen 80;
    server_name n8n.yourdomain.com;


    location / {
        proxy_pass http://127.0.0.1:5678;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        chunked_transfer_encoding on;
        proxy_buffering off;
        proxy_cache off;
        proxy_read_timeout 90s;
        client_max_body_size 50m;
    }
}

Блокът map в началото обработва правилно заглавките за ъпгрейд на WebSocket. n8n използва WebSockets за актуализации в реално време в редактора, така че тази конфигурация е важна — без нея визуалният редактор няма да функционира правилно.

Директивата client_max_body_size 50m позволява на работните потоци да приемат големи данни от уебхукове. Ограничението по подразбиране в Nginx е 1 MB, което е твърде малко за работни потоци, обработващи качване на файлове или големи JSON отговори.

Активирайте конфигурацията и я тествайте:

    sudo ln -s /etc/nginx/sites-available/n8n /etc/nginx/sites-enabled/
    sudo nginx -t
    sudo systemctl reload nginx

Стъпка 6: Издаване на SSL сертификат с Let’s Encrypt

Инсталирайте Certbot и плъгина за Nginx:

    sudo apt install certbot python3-certbot-nginx -y

Поискайте сертификат за вашия домейн:

    sudo certbot --nginx -d n8n.yourdomain.com

Следвайте инструкциите. Когато бъдете попитани дали да пренасочите HTTP трафика към HTTPS, изберете „Да“ (опция 2). Certbot автоматично ще актуализира конфигурацията на Nginx, за да се справи с това пренасочване, и ще инсталира пълната верига от сертификати.

Проверете дали автоматичното подновяване е конфигурирано правилно:

    sudo certbot renew --dry-run

Certbot инсталира таймер в systemd, който подновява сертификатите автоматично на всеки 12 часа. Сертификатите се подновяват, когато остават по-малко от 30 дни до изтичането им. Никога не би трябвало да се налага да ги подновявате ръчно.

Стъпка 7: Стартирайте n8n

Върнете се в директорията на n8n и стартирайте всички услуги:

    cd ~/n8n
    docker compose up -d

Docker ще изтегли образите на PostgreSQL и n8n, ще създаде томовете, първо ще стартира PostgreSQL, ще изчака проверката за работоспособност да приключи успешно, след което ще стартира n8n. Този процес отнема 1–3 минути при първото изпълнение.

Проверете дали и двата контейнера работят:

    docker compose ps

Трябва да видите, че и postgres, и n8n са изброени със статус Up. Ако n8n показва Restarting, проверете логовете:

    docker compose logs n8n --tail=50

След като и двата контейнера са в добро състояние, отворете браузъра си и отидете на https://n8n.yourdomain.com. Ще ви бъде предложено да създадете акаунт на собственик с имейл адрес и парола. Този акаунт има пълен администраторски достъп до вашия n8n инстанс.

Стъпка 8: Конфигуриране на n8n да стартира при зареждане

Директивата restart: always във вашия файл docker-compose.yml гарантира, че всички контейнери се рестартират автоматично при срив или рестартиране на сървъра.

Проверете това, като рестартирате сървъра си:

    sudo reboot

След като се свържете отново чрез SSH, проверете дали n8n се е стартирал автоматично:

    docker compose -f ~/n8n/docker-compose.yml ps

И двата контейнера трябва да се показват като работещи без никаква ръчна намеса.

Стъпка 9: Настройте автоматични архивирания

Данните ви в n8n — работни потоци, идентификационни данни и история на изпълнението — се съхраняват на две места: в базата данни PostgreSQL и в Docker тома n8n_data (в който се съхраняват ключове за криптиране и част от конфигурацията). Правете редовни резервни копия и на двете места.

Създайте скрипт за архивиране:

    nano ~/n8n/backup.sh

Поставете следното:

    #!/bin/bash
    BACKUP_DIR="/home/n8nuser/backups"
    DATE=$(date +%Y-%m-%d_%H-%M)
    LOG_FILE="$BACKUP_DIR/backup.log"
# Уверете се, че директорията за архивиране съществува, преди да продължите
mkdir -p "$BACKUP_DIR"


# Извличане на PostgreSQL
DUMP_FILE="$BACKUP_DIR/n8n_db_$DATE.sql"
docker compose -f /home/n8nuser/n8n/docker-compose.yml exec -T postgres \
  pg_dump -U n8n n8n > "$DUMP_FILE"


# Проверка дали архивирането е успешно и файлът не е празен
if [ $? -ne 0 ] || [ ! -s "$DUMP_FILE" ]; then
    echo "ГРЕШКА: Архивирането на базата данни се провали на $DATE" >> "$LOG_FILE"
    rm -f "$DUMP_FILE"
    exit 1
fi


# Архивиране на ключа за криптиране и променливите на средата
cp /home/n8nuser/n8n/.env "$BACKUP_DIR/n8n_env_$DATE.bak"
# Архивиране на тома n8n_data (конфигурация на инстанцията и инсталирани възли от общността)
docker run --rm -v n8n_n8n_data:/data -v "$BACKUP_DIR":/backup alpine \
  tar czf /backup/n8n_data_$DATE.tar.gz -C /data .


# Компресиране на извлечението от базата данни
gzip "$DUMP_FILE"


# Запазване само на резервните копия от последните 7 дни
find "$BACKUP_DIR" -name "*.sql.gz" -mtime +7 -delete
find "$BACKUP_DIR" -name "*.bak" -mtime +7 -delete
find "$BACKUP_DIR" -name "n8n_data_*.tar.gz" -mtime +7 -delete


echo "Архивирането приключи: n8n_db_$DATE.sql.gz" >> "$LOG_FILE"

Името на тома n8n_n8n_data идва от Docker Compose, който поставя като префикс към тома името на папката на проекта (n8n). Проверете вашето с docker volume ls.

Направете скрипта изпълним и го планирайте с cron:

    chmod +x ~/n8n/backup.sh
    crontab -e

Добавете този ред, за да се изпълнява архивирането всеки ден в 2 часа сутринта:

    0 2 * * * /home/n8nuser/n8n/backup.sh >> /home/n8nuser/backups/backup.log 2>&1

За резервиране извън локацията обмислете да синхронизирате директорията с резервните копия към доставчик на обектно хранилище, съвместим с S3, като използвате rclone или aws s3 sync.

Стъпка 10: Активиране на основни мерки за засилване на сигурността

Настройте защитна стена

Инсталирайте UFW и разрешете само портовете, от които сървърът ви се нуждае:

    sudo ufw allow OpenSSH
    sudo ufw allow 'Nginx Full'
    sudo ufw enable

Проверете дали правилата са активни:

    sudo ufw status verbose

Трябва да видите, че портове 22 (SSH), 80 (HTTP) и 443 (HTTPS) са разрешени. Едно предупреждение: Docker записва свои собствени правила за защитна стена и заобикаля UFW за публикуваните портове на контейнерите. Порт 5678 остава частен, защото файлът compose го свързва с 127.0.0.1, а не заради UFW, така че никога не променяйте това свързване на 0.0.0.0.

Деактивирайте удостоверяването с парола за SSH

Ако използвате SSH ключове (което би трябвало да правите), деактивирайте напълно влизането в SSH чрез парола. Първо се уверете, че акаунтът n8nuser може да влезе с вашия ключ. От локалния си компютър изпълнете:

    ssh-copy-id n8nuser@your_server_ip

След това редактирайте конфигурацията на SSH сървъра:

    sudo nano /etc/ssh/sshd_config

Задайте следните стойности:

    PasswordAuthentication no
    PermitRootLogin no
    sudo systemctl restart ssh

В много облачни образи на Ubuntu файл в /etc/ssh/sshd_config.d/ (често 50-cloud-init.conf) задава PasswordAuthentication yes и той има предимство, тъй като sshd използва първата стойност, която прочете. Проверете коя настройка действително е в сила:

    sudo sshd -T | grep -i passwordauthentication

Трябва да се изведе passwordauthentication no. Ако това не се случи, променете стойността във файла за преопределяне и рестартирайте SSH отново.

Не затваряйте текущата си SSH сесия, докато не се уверите, че влизането с ключ работи в нов терминален прозорец.

Ограничаване на скоростта на страницата за вход в n8n

Добавете ограничение на скоростта, за да забавите атаките с груба сила срещу крайната точка за вход в n8n.

**Важно: **Директивата limit_req_zone трябва да бъде поставена в блока http {} във вашата основна конфигурация на Nginx — а не в блока server. Отворете основната конфигурация:

    sudo nano /etc/nginx/nginx.conf

Добавете този ред в съществуващия блок http {}:

    http {
        ...
        limit_req_zone $binary_remote_addr zone=n8n_login:10m rate=5r/m;
        ...
    }

След това в конфигурацията на вашия n8n сайт (/etc/nginx/sites-available/n8n) добавете този блок location вътре в блока server, който слуша на порт 443 (Certbot го е създал в стъпка 6), до съществуващия location /. Nginx не пренася прокси заглавията от location /, затова те се повтарят тук:

    location /rest/login {
        limit_req zone=n8n_login burst=5 nodelay;
        proxy_pass http://127.0.0.1:5678;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

Презаредете Nginx, за да приложите промените:

    sudo nginx -t && sudo systemctl reload nginx

Това ограничава всеки IP адрес до около 5 опита за вход на минута, с малък допустим пик.

Поддържайте n8n и PostgreSQL актуализирани

Редовно изтегляйте и рестартирайте с най-новите образи:

    cd ~/n8n
    docker compose pull
    docker compose up -d

Docker ще изтегли най-новите образи n8nio/n8n и postgres и ще рестартира само контейнерите, за които има налична по-нова версия.

За производствена среда обмислете да фиксирате образа на n8n към конкретен таг на версия (docker.n8n.io/n8nio/n8n:<version>, взет от бележките към версията на n8n) и да извършвате ъпгрейди целенасочено, така че рутинното изтегляне никога да не прескача основна версия, преди да сте прочели списъка с промените.

Отстраняване на често срещани проблеми

Контейнерът на n8n продължава да се рестартира

Проверете логовете на контейнера веднага след като започне цикълът на рестартиране:

    docker compose logs n8n --tail=100

Чести причини:

• Грешка при свързване с базата данни: Уверете се, че PostgreSQL работи нормално с docker compose ps. Проверете дали POSTGRES_PASSWORD във вашия .env файл съвпада с паролата, с която е инициализирана базата данни.
• Липсващ или променен ключ за криптиране: Ако N8N_ENCRYPTION_KEY не е зададен или е бил променен след първото стартиране, n8n не може да декриптира съхранените идентификационни данни и ще се срине.
• Недостатъчна RAM: PostgreSQL и n8n заедно могат да използват 1–1,5 GB RAM. Проверете наличната памет с free -h.

Уебхуковете не работят

Уебхуковете изискват n8n да е достъпен от интернет на вашия домейн. Проверете:

1. A записът в DNS на вашия домейн сочи към IP адреса на вашия VPS: dig n8n.yourdomain.com
2. Nginx работи: sudo systemctl status nginx
3. Порт 443 е отворен: sudo ufw status
4. Променливата на средата WEBHOOK_URL съвпада точно с публичния ви домейн, включително и накрайната наклонена черта

Редакторът на n8n не се зарежда правилно

Ако визуалният редактор се зарежда, но показва празно платно за работния поток или актуализациите в реално време престанат да работят, това означава, че връзката през WebSocket не работи. Проверете дали в конфигурацията на Nginx има блок $http_upgrade и дали използвате променливата $connection_upgrade — а не буквалния низ „upgrade“ — в реда proxy_set_header Connection.

Грешки със SSL сертификатите

Ако Certbot даде грешка при валидирането на домейна, проверете дали порт 80 е достъпен от интернет:

    curl -I http://n8n.yourdomain.com

Ако заявката изтече, е възможно защитната стена на вашия VPS доставчик да блокира порт 80. Проверете правилата на защитната стена в облачната конзола, както и в UFW.

Заключение

Самостоятелното хостинг на n8n на Linux VPS ви предоставя платформа за автоматизация на работния поток, готова за производствена употреба, без ограничения за изпълнение, с пълна поверителност на данните и гъвкавост за изпълнение на всяка интеграция, от която се нуждаете. Настройката, описана в това ръководство — Docker, PostgreSQL, обратен прокси Nginx, SSL сертификат от Let’s Encrypt, автоматични архивирания и засилване на сигурността — е същата като тази, използвана в производствени среди, и ви осигурява стабилна и сигурна основа, върху която да градите.

За разлика от минималната инсталация чрез командата „run“ в Docker, тази конфигурация е създадена да издържа на рестартиране на сървъра, да се справя с едновременното изпълнение на работни потоци и да се възстановява безпроблемно след сривове. Вашите идентификационни данни са криптирани, данните ви се архивират всяка нощ, а крайната точка за вход е защитена с ограничение на честотата на опитите срещу брут-форс атаки.

След като инстанцията ви заработи, разгледайте вградените възли на n8n за бази данни, API-та, уебхукове и AI интеграции, за да започнете незабавно да автоматизирате работните си потоци. Самохостният форум на общността на community.n8n.io също е отличен източник за идеи за работни потоци, отстраняване на проблеми с възлите и съвети за внедряване.