Teadmistebaas

n8n — это популярная платформа для автоматизации задач, интеграций и бизнес-процессов. Если вам нужен собственный self-hosted экземпляр без ограничений стороннего облака, удобнее всего развернуть n8n на VPS или выделенном сервере с Docker.

В этой инструкции разберем установку n8n на Debian 13 через Docker и выполним первую настройку до момента входа в веб-интерфейс.

Что понадобится перед началом

• Сервер с Debian 13
• Пользователь с правами sudo
• Минимум 2 ГБ RAM для базового запуска
• Открытый доступ к серверу по SSH
• Желательно домен или поддомен, если вы планируете использовать n8n не только локально

Для стабильного размещения n8n обычно выбирают VPS с постоянным публичным IPv4 и нормальной сетевой доступностью. Если нужен готовый сервер под такие задачи, у XHost24 доступны VPS и dedicated-серверы с быстрым стартом, крипто-оплатой и размещением в NL и DE.

Шаг 1. Обновите систему

Подключитесь к серверу по SSH и обновите список пакетов:

sudo apt update && sudo apt upgrade -y

Шаг 2. Установите Docker

Сначала установите пакеты, которые нужны для подключения официального репозитория Docker:

sudo apt install -y ca-certificates curl gnupg

Создайте каталог для ключей:

sudo install -m 0755 -d /etc/apt/keyrings

Добавьте официальный GPG-ключ Docker:

curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

Подключите официальный репозиторий Docker:

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian \
  $(. /etc/os-release && echo $VERSION_CODENAME) stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Обновите список пакетов и установите Docker Engine:

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Проверьте, что Docker работает:

sudo systemctl enable docker
sudo systemctl start docker
sudo docker --version

Шаг 3. Создайте каталог для n8n

Создадим отдельную директорию, в которой будут храниться конфигурация и docker-compose файл:

mkdir -p ~/n8n
cd ~/n8n

Шаг 4. Создайте docker-compose.yml

Откройте редактор и создайте файл:

nano docker-compose.yml

Вставьте в него следующий конфиг:

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n:latest
    container_name: n8n
    restart: unless-stopped
    ports:
      - "5678:5678"
    environment:
      - TZ=UTC
      - N8N_HOST=0.0.0.0
      - N8N_PORT=5678
      - N8N_PROTOCOL=http
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  n8n_data:

Сохраните файл.

Шаг 5. Запустите контейнер

sudo docker compose up -d

Проверьте, что контейнер поднялся:

sudo docker ps

Если всё в порядке, вы увидите контейнер n8n в списке активных.

Шаг 6. Проверьте доступность n8n

Если вы открываете сервис локально или через прямой IP, используйте адрес:

http://IP_ВАШЕГО_СЕРВЕРА:5678

Если порт 5678 закрыт фаерволом, его нужно разрешить отдельно.

После открытия страницы вы попадете на первый экран n8n и сможете перейти к созданию владельца рабочего пространства через веб-интерфейс.

Что важно сделать сразу после запуска

• Проверить, что данные сохраняются после перезапуска контейнера
• Не удалять volume с данными без резервной копии
• Не использовать тестовую схему как финальную production-конфигурацию
• Подготовить домен и reverse proxy, если планируются webhooks и внешние интеграции

Почему у многих возникают проблемы уже на старте

Чаще всего сложности появляются не из-за самой установки n8n, а из-за окружения. Пользователи забывают про постоянное хранение данных, запускают контейнер без понятной схемы обновления, не открывают нужный порт или позже пытаются подключить домен и webhooks без корректной сетевой настройки.

Если вы планируете использовать n8n для реальных задач, а не только для локального теста, лучше сразу размещать его на сервере с постоянным IPv4, стабильным каналом и понятным доступом по SSH. Это избавляет от большинства проблем уже на первом этапе.

Установка n8n на Debian 13 через Docker занимает немного времени и подходит даже для первого самостоятельного запуска. Базовая схема проста: обновить систему, установить Docker, создать docker-compose файл, запустить контейнер и открыть сервис в браузере.

Если позже вы захотите перевести n8n в полноценный публичный режим, следующим шагом обычно становится настройка домена, SSL, reverse proxy и корректной работы webhook-ов.

Если вам нужен сервер под n8n без лишней бюрократии, обратите внимание на VPS и dedicated-решения XHost24. Для таких задач обычно важны быстрый старт, стабильный IPv4, понятный доступ и адекватная поддержка, а не просто минимальная цена.