Установка n8n на компьютер

Установка n8n на компьютер: Полное руководство

n8n — это инструмент с открытым исходным кодом для оркестрации рабочих процессов (workflow automation), который позволяет соединять различные приложения, API и сервисы между собой. В отличие от некоторых облачных конкурентов, n8n можно развернуть на собственном сервере или компьютере, что обеспечивает полный контроль над данными и процессами. Данное руководство детально описывает процесс установки n8n на локальную машину под управлением Windows, macOS и Linux, а также последующую настройку и использование.

Предварительные требования и подготовка

Перед началом установки необходимо убедиться, что на вашем компьютере выполнены следующие условия. n8n требует наличия Node.js (среды выполнения JavaScript) и менеджера пакетов npm, которые поставляются вместе.

Операционная система: Windows 10/11, macOS 10.14+, или дистрибутив Linux (Ubuntu 20.04+, Debian 10+, Fedora 32+ и аналоги).
Node.js: Версия 18.x или 20.x. Версии 19 и 21 не поддерживаются. Рекомендуется использовать LTS-релиз.
Память (ОЗУ): Минимум 2 ГБ, рекомендуется 4 ГБ и более для сложных workflow.
Свободное место на диске: Не менее 1 ГБ.
Доступ в интернет: Для загрузки пакетов и работы с внешними API.

Проверка установки Node.js и npm

Откройте терминал (Command Prompt, PowerShell, или терминал Linux/macOS) и выполните команды:

node --version
npm --version

Если команды возвращают ошибку или показывают устаревшую версию Node.js (ниже 18), необходимо установить или обновить Node.js. Для этого рекомендуется скачать установщик с официального сайта nodejs.org или использовать менеджер версий Node, такой как nvm (Node Version Manager).

Способ 1: Установка n8n с помощью npm (базовый метод)

Это самый прямой способ установки, который подходит для быстрого начала работы и тестирования.

Шаг 1: Установка глобального пакета n8n

В терминале с правами администратора (на Linux/macOS может потребоваться sudo) выполните команду:

npm install n8n -g

Флаг -g указывает на глобальную установку, что делает команду n8n доступной из любого места в системе.

Шаг 2: Запуск n8n

После успешной установки запустите n8n простой командой:

n8n start

При первом запуске n8n создаст необходимые конфигурационные файлы и папку для данных в домашнем каталоге пользователя (~/.n8n).

Шаг 3: Доступ к веб-интерфейсу

По умолчанию веб-интерфейс n8n будет доступен по адресу: http://localhost:5678. Откройте этот адрес в браузере. Вы увидите страницу приветствия, где можно создать учетную запись первого пользователя. Эта учетная запись будет использоваться для входа в ваш локальный экземпляр.

Способ 2: Установка с помощью Docker (рекомендуемый для production)

Использование Docker обеспечивает изоляцию, простоту обновления и консистентность среды. Этот метод предпочтителен для долгосрочного использования.

Шаг 1: Установка Docker

Необходимо установить Docker Desktop для Windows/macOS или Docker Engine для Linux. Инструкции доступны на официальном сайте docker.com.

Шаг 2: Запуск контейнера n8n

Выполните следующую команду в терминале. Она скачает официальный образ n8n и запустит контейнер.

docker run -it --rm --name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n

Разбор команды:

-p 5678:5678: Пробрасывает порт 5678 из контейнера на хост.
-v ~/.n8n:/home/node/.n8n: Монтирует директорию данных из контейнера в локальную папку, обеспечивая сохранность данных после остановки контейнера.
--rm: Удаляет контейнер после остановки (опционально, для тестирования).

Для фонового запуска замените флаг -it на -d.

Способ 3: Установка на Windows с помощью исполняемого файла

Для пользователей Windows, которые предпочитают избегать командной строки, доступен установщик.

Скачайте последнюю версию установщика n8n-windows-setup.exe со страницы релизов на GitHub.
Запустите исполняемый файл и следуйте инструкциям мастера установки.
После установки n8n будет добавлен в автозагрузку и запущен как служба Windows. Интерфейс будет доступен по тому же адресу http://localhost:5678.

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

После первого входа в n8n необходимо выполнить первоначальную настройку.

1. Настройка базы данных

По умолчанию n8n использует встроенную SQLite, что удобно для начала. Для серьезных нагрузок рекомендуется перейти на PostgreSQL. Для этого остановите n8n и задайте переменные окружения перед запуском.

Пример для Docker:

docker run -d --name n8n -p 5678:5678 -e DB_TYPE=postgresdb -e DB_POSTGRESDB_HOST=localhost -e DB_POSTGRESDB_PORT=5432 -e DB_POSTGRESDB_DATABASE=n8n -e DB_POSTGRESDB_USER=postgres -e DB_POSTGRESDB_PASSWORD=пароль -v ~/.n8n:/home/node/.n8n n8nio/n8n

2. Настройка режима работы

n8n может работать в двух режимах:

Режим production: Требует настройки шифрования для учетных данных (переменная N8N_ENCRYPTION_KEY).
Режим development: Более простой, но менее безопасный.

3. Конфигурация через environment variables

Ключевые переменные окружения для настройки:

Переменная	Описание	Пример значения
N8N_BASIC_AUTH_ACTIVE	Включение HTTP Basic аутентификации для всего интерфейса	true
N8N_BASIC_AUTH_USER	Логин для Basic аутентификации	admin
N8N_BASIC_AUTH_PASSWORD	Пароль для Basic аутентификации	secure_password
WEBHOOK_URL	Публичный URL для вызова вебхуков (если n8n за reverse proxy)	https://n8n.yourdomain.com
N8N_ENCRYPTION_KEY	Ключ для шифрования учетных данных (обязателен в production)	my_secret_key_32_chars

Создание первого рабочего процесса (Workflow)

После настройки можно приступить к созданию automation.

В веб-интерфейсе нажмите кнопку «New Workflow».
Перетащите ноду (узел) из левой панели в рабочую область. Например, ноду «Schedule» для триггера по времени.
Настройте ноду: для «Schedule» выберите интервал, например, «Every hour».
Добавьте следующую ноду, например, «HTTP Request» для получения данных с публичного API.
Соедините ноды, перетащив точку соединения от триггера к следующей ноде.
Настройте «HTTP Request»: укажите метод GET и URL, например, https://api.exchangerate.host/latest.
Добавьте ноду «Code» для обработки полученных данных (опционально).
Нажмите кнопку «Execute Workflow» для тестирования. Если все настроено верно, вы увидите успешное выполнение и данные от API.

Обновление n8n до новой версии

Регулярное обновление важно для получения новых функций и исправлений безопасности.

Для установки через npm: Выполните команду npm update n8n -g.
Для установки через Docker: Остановите текущий контейнер, удалите его образ и запустите команду заново с тем же томом данных. Docker автоматически скачает последний образ.
- docker stop n8n
- docker rm n8n
- docker pull n8nio/n8n
- Запустите команду docker run заново.
Для Windows установщика: Запустите новый установщик поверх старой версии.

Резервное копирование и восстановление данных

Основные данные n8n хранятся в директории ~/.n8n (или в указанной вами папке для Docker volume). Для резервного копирования необходимо сохранить эту папку целиком. Особое внимание уделите файлу database.sqlite (если используется SQLite) или дампу базы данных PostgreSQL. Также экспортируйте важные workflow через встроенную функцию экспорта в интерфейсе n8n (кнопка «Export» на странице workflow).

Ответы на часто задаваемые вопросы (FAQ)

Как изменить порт, на котором работает n8n?

Используйте переменную окружения N8N_PORT. Например, для запуска на порту 8080: n8n start --port=8080 или в Docker добавьте -e N8N_PORT=8080 и измените проброс портов на -p 8080:8080.

n8n не запускается, выдает ошибку о порте. Что делать?

Ошибка «Port 5678 is already in use» означает, что порт занят другим приложением. Вы можете завершить процесс, использующий порт 5678, или запустить n8n на другом порту, как описано выше.

Где хранятся мои логины и пароли от подключенных сервисов?

Учетные данные (credentials) по умолчанию шифруются и хранятся в базе данных n8n. В режиме development шифрование отключено. Для production обязательно задайте свою N8N_ENCRYPTION_KEY.

Можно ли запускать n8n как службу (фоновую службу)?

Да. На Linux для этого можно использовать systemd. Создайте файл службы /etc/systemd/system/n8n.service с конфигурацией, указывающей на исполняемый файл Node.js и n8n. На Windows при установке через .exe-файл служба создается автоматически.

Как организовать многопользовательский доступ?

Локальная установка n8n по умолчанию поддерживает несколько пользователей. Администратор может пригласить других пользователей через интерфейс «Settings» -> «Users». Каждому пользователю будет отправлена ссылка для регистрации.

Чем отличается локальная установка от облачной версии n8n?

Локальная установка (self-hosted) дает полный контроль над инфраструктурой и данными, не имеет ограничений на количество операций (executions) и может быть полностью изолирована от интернета. Облачная версия (n8n.cloud) управляется командой n8n, не требует администрирования сервера, но имеет тарифные планы, ограничивающие количество workflow и операций.

Как решить проблему с ошибками при установке через npm (например, права доступа)?

На Linux/macOS избегайте использования sudo с npm. Вместо этого настройте права на директорию глобальной установки npm для вашего пользователя. Альтернативно, используйте менеджер версий Node (nvm), который управляет правами корректно. На Windows запускайте командную строку от имени администратора только если это действительно необходимо.

Как добавить собственные узлы (custom nodes) в n8n?

Пользовательские узлы можно устанавливать через npm. Поместите папку с узлом в директорию ~/.n8n/custom и перезапустите n8n. Убедитесь, что узел совместим с вашей версией n8n.

Заключение

Установка n8n на локальный компьютер — это процесс, доступный пользователям с разным уровнем технической подготовки. Выбор метода установки (npm, Docker, установщик) зависит от ваших целей: быстрый старт, изолированное тестирование или развертывание для постоянного использования. Последующая настройка через переменные окружения и выбор подходящей базы данных позволяют оптимизировать работу платформы под конкретные задачи. Регулярное обновление и правильное резервное копирование обеспечат стабильность и сохранность ваших рабочих процессов. n8n, будучи установленным локально, предоставляет мощный, гибкий и конфиденциальный инструмент для автоматизации, свободный от ограничений облачных подписок.