# Установка N8N на VPS-сервере

### Архитектура решения

Стек состоит из двух **основных контейнеров**:

* **Caddy**: Edge-сервер, отвечающий за терминацию TLS и перенаправление трафика.
* **n8n**: Основной узел автоматизации *(Low-code платформа).*

{% hint style="info" icon="rotate" %}
Трафик поступает на **80/443** порты хоста -> **Caddy** *(авто-SSL)* -> Внутренняя сеть **Docker** -> **n8n** *(порт **5678**)*.
{% endhint %}

#### Шаг 1: Подготовка сервера и системные требования

Для обеспечения **стабильной** и **бесперебойной** работы сервиса **n8n** требуется развертывание на виртуальном выделенном сервере **(VPS)**. В качестве **надежной** инфраструктуры **мы рекомендуем** использовать **наши сервера** [**U1HOST**](https://u1host.com/?ref=wiki) — они полностью **соответствуют системным требованиям** проекта и обеспечивают идеальную **совместимость с инструкциями**, изложенными ниже.

| Параметр                | Минимальные требования                    |
| ----------------------- | ----------------------------------------- |
| vCPU (виртуальное ядро) | Минимум 2 ядра.                           |
| RAM                     | От 4 ГБ.                                  |
| Накопитель              | От 40 ГБ SSD.                             |
| Операционная система    | ОС*:* Ubuntu 24.04 (рекомендуется). |

> Для комфортной и быстрой работы n8n мы советуем обратить внимание на конфигурации DE-5950X-2, NL-5950X-2 или FI-5950X-2. Эти серверы базируются на мощных процессорах, которые отлично справляются с фоновыми задачами и полностью покрывают системные требования проекта. Вы можете выбрать любую из доступных локаций: Германию (DE), Нидерланды (NL) или Финляндию (FI).

#### Шаг 2: Выбор конфигурации сервера

После входа или регистрации в панели [**U1HOST**](https://wiki.u1host.com/client-area/registration) нажмите кнопку <kbd>Заказать услугу</kbd>, чтобы перейти к выбору сервера.

<figure><img src="https://wiki.u1host.com/~gitbook/image?url=https%3A%2F%2F4013008081-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FUZCon1KDFCWX5Lp410mU%252Fuploads%252FLNFlMLsfjQxHaqKUEHVB%252FGroup%252022.png%3Falt%3Dmedia%26token%3D8558b2a2-f3cb-4d62-b9a1-fd115a55b0f6&#x26;width=768&#x26;dpr=3&#x26;quality=100&#x26;sign=f00fa008&#x26;sv=2" alt=""><figcaption></figcaption></figure>

* В меню <kbd>**Заказ услуги**</kbd> отображаются основные тарифы, подходящие для скорости до **100 Мбит в секунду**. Для просмотра полного списка нажмите **Смотреть все.**

Как выбрать сервер:

* На карточке **DE-5950X-2, NL-5950X-2 или FI-5950X-2.** нажмите кнопку <kbd>**Заказать**</kbd>.
* В конфигурации сервера выберите операционную систему <kbd>**Ubuntu 24.04**</kbd> .
* Нажмите кнопку <kbd>**Оплатить**</kbd>, чтобы завершить заказ.

<figure><img src="https://wiki.u1host.com/~gitbook/image?url=https%3A%2F%2F4013008081-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FUZCon1KDFCWX5Lp410mU%252Fuploads%252FIMcgyDhlyuaQ7js3oE17%252FGroup%252023.png%3Falt%3Dmedia%26token%3D351d93d5-2cb4-4db0-bbcb-0ba05557dd1c&#x26;width=768&#x26;dpr=3&#x26;quality=100&#x26;sign=410000cc&#x26;sv=2" alt=""><figcaption><p>Картинка служит примером как оформить сервер, в вашем случае нужно выбрать Ubuntu 24.04 а не Debian.</p></figcaption></figure>

#### Шаг 3: Активация сервера

После оплаты начинается автоматическая обработка заказа. Активация сервера обычно занимает не более **120 секунд**.

<figure><img src="https://wiki.u1host.com/~gitbook/image?url=https%3A%2F%2F4013008081-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FUZCon1KDFCWX5Lp410mU%252Fuploads%252F7LwPhaFG5AcF4PX7U8u2%252Fimage%252017.png%3Falt%3Dmedia%26token%3D993b4a35-d09d-40a6-b8a9-adc0f3230fe0&#x26;width=768&#x26;dpr=3&#x26;quality=100&#x26;sign=db55cf73&#x26;sv=2" alt=""><figcaption><p><em>Статус сервера "обрабатывается", нужно немного подождать.</em></p></figcaption></figure>

Текущий статус можно отслеживать в **панели управления**. Как только сервер будет готов к работе, статус изменится на <kbd>**Активен**</kbd>.

{% hint style="info" %}
Иногда активация может занять немного больше времени из-за повышенной нагрузки и очереди на обработку заказов в выбранной локации. Если сервер не активировался в течение 10 минут – пожалуйста, напишите в тикеты, и мы оперативно проверим статус заказа.
{% endhint %}

#### Шаг 4: Получаем данные сервера

1. Подождите пока сервер будет полностью активирован.
2. В личном кабинете отметьте чек-бокс напротив нужного сервера и нажмите кнопку <kbd>**Инструкция**</kbd> в верхнем меню.
3. <kbd>**Скопируйте данные для подключения**</kbd>, указанные в инструкции:
   * <kbd>IP-адрес сервера</kbd> .
   * <kbd>Имя пользователя</kbd> .
   * <kbd>Пароль</kbd> .

На скриншоте ниже показано, где именно можно найти эту информацию.

<figure><img src="https://wiki.u1host.com/~gitbook/image?url=https%3A%2F%2F4013008081-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FUZCon1KDFCWX5Lp410mU%252Fuploads%252FWcFSueCBKPdJrovv4Ar8%252FGroup%252010.png%3Falt%3Dmedia%26token%3D165ec302-e235-463d-a5fd-4540348290ce&#x26;width=768&#x26;dpr=1&#x26;quality=100&#x26;sign=9a5e526&#x26;sv=2" alt=""><figcaption></figcaption></figure>

<figure><img src="https://wiki.u1host.com/~gitbook/image?url=https%3A%2F%2F4013008081-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FUZCon1KDFCWX5Lp410mU%252Fuploads%252F8VmoOz7sQnvGZAr0LfhW%252FGroup%252024.png%3Falt%3Dmedia%26token%3D3cc78518-688c-49c4-9f2a-520729b1c714&#x26;width=768&#x26;dpr=1&#x26;quality=100&#x26;sign=bc74e6df&#x26;sv=2" alt=""><figcaption><p>Данные от сервера так-же отправляются на вашу почту.</p></figcaption></figure>

#### Шаг 5: Подготовка файловой структуры

Для корректного монтирования томов необходимо **создать рабочую директорию** и файлы конфигурации.

```
apt update && apt upgrade -y
```

```
reboot ## После перезагрузки продолжите дальнейшую настройку.
```

```
mkdir -p /opt/n8n && cd /opt/n8n
```

```
touch Caddyfile docker-compose.yml
```

#### Шаг 6: Конфигурация Reverse Proxy (Caddyfile)

Использование внешнего `Caddyfile` предпочтительнее **инлайн-команд** в **Compose** для удобства отладки и поддержки.

```
nano /opt/n8n/Caddyfile
```

Вставьте следующее значение:

```
ваш-домен.зона {
    reverse_proxy n8n:5678
}
```

{% hint style="success" %}
**Caddy** автоматически определит необходимость выпуска сертификата через **Let's Encrypt** или **ZeroSSL** при запуске.
{% endhint %}

#### Шаг 7: Описание сервисов (Docker Compose)

Файл оркестрации определяет лимиты, сети и правила перезапуска.

```
/opt/n8n/docker-compose.yml
```

Вставьте следующее содержимое, не забудьте изменить под свои значения.

```
services:
  caddy:
    image: caddy:latest
    container_name: n8n-caddy
    restart: always
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - caddy_data:/data
      - caddy_config:/config
    networks:
      - n8n_net

  n8n:
    image: n8nio/n8n:latest
    container_name: n8n-app
    restart: always
    environment:
      - N8N_HOST=свой-домен.зона
      - N8N_PORT=5678
      - N8N_PROTOCOL=https
      - NODE_ENV=production
      - WEBHOOK_URL=https://свой-домен.зона/
    volumes:
      - n8n_data:/home/node/.n8n
    networks:
      - n8n_net

networks:
  n8n_net:

volumes:
  caddy_data:
  caddy_config:
  n8n_data:
```

#### Шаг 8: Развертывание и верификация

1. Запуск стека в detach-режиме:

```
docker compose up -d
```

2. Мониторинг процесса выпуска SSL-сертификата:

```
docker compose logs -f caddy
```

3. Проверка доступности **n8n:** *Ответ должен содержать `HTTP/2 200` .*

```
curl -I https://ваш-домен.зона
```

#### Шаг 9: Регистрация в панели **n8n**

1. При первом посещении страницы вы увидите форму регистрации.

* **Имя и Фамилия**: Используются для отображения внутри панели.
* **Email:** Это ваш логин. На него будут приходить уведомления о критических ошибках в сценариях и запросы на сброс пароля.
* **Пароль:** Минимум 8 символов. Поскольку **n8n** будет иметь доступ к вашим **API-ключа**м, серверам и **Telegram-ботам**, используйте **максимально сложную комбинацию**.

2. После создания аккаунта n8n предложит пройти короткий опрос.

* **Роль** *(What is your role?)*: Выберите `Engineer` или `DevOps`. **Это влияет на то**, какие шаблоны воркфлоу система **будет предлагать вам на стартовой странице.**
* **Usage Data**: Система спросит разрешение на отправку анонимной статистики. **Как специалисту по безопасности**, вам может быть комфортнее **отключить эту опцию**, чтобы минимизировать исходящий трафик на сторонние серверы.

3. Как только вы попадете в основной интерфейс, первым делом необходимо защи~~т~~ить вход:

* Перейдите в **Settings** *(шестеренка слева снизу)* -> **Personal.**
* Найдите раздел **Multi-factor authentication.**
* Нажмите **Enable 2FA** и отсканируйте QR-код любым аутентификатором.

  > Важно: Сохраните коды восстановления. В Docker-контейнере сбросить 2FA через базу данных без опыта работы с SQLite будет сложно.

#### Технические рекомендации

* **Данные n8n** *(воркфлоу, учетки)* хранятся в именованном томе `n8n_data`. Для бэкапа достаточно копировать содержимое `/var/lib/docker/volumes/n8n_n8n_data/`.
* Поскольку **Caddy** работает на **80/443** портах, убедитесь, что внешние **Firewall** *(ufw/iptables)* **разрешают входящий трафик на эти порты.**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.u1host.com/software-setup/ustanovka-n8n-na-vps-servere.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.