Полное руководство по установке n8n: пошаговая инструкция для всех операционных систем
n8n — это мощный инструмент для автоматизации рабочих процессов с открытым исходным кодом. Он позволяет соединять различные приложения, сервисы и API без необходимости написания сложного кода. Данное руководство предоставляет детальные пошаговые инструкции по скачиванию и установке n8n на различные операционные системы, а также альтернативные методы развертывания.
Выбор метода установки n8n
Перед началом установки необходимо определиться с подходящим методом. Выбор зависит от ваших технических навыков, целей использования (тестирование или production) и доступных ресурсов.
| Метод установки | Сложность | Рекомендуется для | Ключевые особенности |
|---|---|---|---|
| npm / Node.js | Средняя | Разработчиков, пользователей, желающих глубокой интеграции | Прямой контроль, возможность модификации, обновление через npm |
| Docker | Низкая/Средняя | Большинства пользователей, production-сред | Изоляция, простота обновления, консистентность окружения |
| Desktop приложение | Очень низкая | Новичков, быстрого локального тестирования | Простота установки, автономная работа, встроенная база данных SQLite |
| Развертывание в облаке | Зависит от платформы | Команд, production-развертывания без управления сервером | Масштабируемость, высокая доступность, отсутствие забот об инфраструктуре |
Предварительные требования и подготовка
Вне зависимости от выбранного метода, убедитесь, что ваша система соответствует минимальным требованиям:
- Оперативная память (RAM): не менее 2 ГБ (рекомендуется 4+ ГБ для сложных воркфлоу).
- Свободное место на диске: 1 ГБ и более.
- Стабильное интернет-соединение для загрузки пакетов и работы с нодами.
- Права администратора/root для установки системных пакетов (для некоторых методов).
node --versionnpm --versionnpm install n8n -gn8n start- Установите и настройте PostgreSQL, создайте базу данных для n8n.
- Запустите n8n с параметрами:
export DB_TYPE=postgresdb; export DB_POSTGRESDB_HOST=localhost; export DB_POSTGRESDB_PORT=5432; export DB_POSTGRESDB_DATABASE=n8n; export DB_POSTGRESDB_USER=ваш_пользователь; export DB_POSTGRESDB_PASSWORD=ваш_пароль; n8n start docker --versiondocker run -it --rm --name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n-it: Интерактивный режим с выводом логов.--rm: Удалить контейнер после остановки (для тестов).--name n8n: Имя контейнера.-p 5678:5678: Проброс порта с хоста на контейнер.-v ~/.n8n:/home/node/.n8n: Монтирование тома для сохранения данных на хост-машине.n8nio/n8n: Имя официального образа.- Создайте сеть Docker:
docker network create n8n-network - Запустите PostgreSQL:
docker run -d --name n8n-postgres --network n8n-network -e POSTGRES_USER=n8n -e POSTGRES_PASSWORD=секретный_пароль -e POSTGRES_DB=n8n -v pgdata:/var/lib/postgresql/data postgres:13 - Запустите n8n, подключившись к этой базе:
docker run -d --name n8n --network n8n-network -p 5678:5678 -v ~/.n8n:/home/node/.n8n -e DB_TYPE=postgresdb -e DB_POSTGRESDB_HOST=n8n-postgres -e DB_POSTGRESDB_PORT=5432 -e DB_POSTGRESDB_DATABASE=n8n -e DB_POSTGRESDB_USER=n8n -e DB_POSTGRESDB_PASSWORD=секретный_пароль -e N8N_BASIC_AUTH_ACTIVE=true -e N8N_BASIC_AUTH_USER=admin -e N8N_BASIC_AUTH_PASSWORD=пароль n8nio/n8n - Для Windows:
n8n-x.x.x-win-x64.exe(где x.x.x — версия) - Для macOS:
n8n-x.x.x-mac-x64.dmgили.zip - Для Linux:
n8n-x.x.x-linux-x64.AppImageили.deb,.rpm
Установка n8n с помощью npm (Node.js)
Этот метод предполагает прямую установку пакета n8n через менеджер пакетов Node.js. Он подходит, если вы планируете разрабатывать кастомные ноды или хотите тесную интеграцию с существующей Node.js средой.
Шаг 1: Установка Node.js и npm
n8n требует Node.js версии 18.x или выше. Перейдите на официальный сайт nodejs.org и скачайте LTS-версию (Long Term Support) для вашей операционной системы. Установщик включает в себя и npm. После установки откройте терминал (командную строку) и выполните команды для проверки:
Команды должны отобразить установленные версии без ошибок.
Шаг 2: Установка пакета n8n глобально
В терминале выполните следующую команду. Флаг -g указывает на глобальную установку, что делает команду n8n доступной из любого места в системе.
Процесс загрузки и установки может занять несколько минут.
Шаг 3: Запуск n8n
После успешной установки запустите n8n командой:
По умолчанию n8n запустит веб-сервер на порту 5678 и будет использовать встроенную базу данных SQLite. Откройте браузер и перейдите по адресу: http://localhost:5678. Вы увидите интерфейс n8n, где можно начать создавать рабочие процессы.
Шаг 4: Настройка и сохранение данных (опционально, но рекомендуется)
При стандартном запуске данные (воркфлоу, учетные данные) сохраняются в SQLite файл в домашней директории пользователя. Для настройки внешней базы данных (например, PostgreSQL) или изменения порта, используйте переменные окружения или конфигурационный файл. Пример запуска с PostgreSQL:
Установка n8n с помощью Docker
Docker — это наиболее предпочтительный и гибкий способ установки, обеспечивающий изолированное и воспроизводимое окружение.
Шаг 1: Установка Docker Engine
Скачайте и установите Docker Desktop для Windows или Mac с официального сайта docker.com. Для Linux следуйте инструкциям для вашего дистрибутива (например, для Ubuntu: sudo apt-get install docker.io). После установки убедитесь, что Docker запущен, проверив версию в терминале:
Шаг 2: Запуск контейнера n8n
Самый простой способ запустить n8n в Docker — использовать официальный образ с Docker Hub. Выполните команду:
Разбор команды:
Шаг 3: Запуск в фоновом режиме и с базой данных
Для production-использования запускайте контейнер в фоновом режиме (-d) и с внешней базой данных. Пример с PostgreSQL в отдельном контейнере:
Установка n8n Desktop приложения
Наиболее простой способ для быстрого старта и локального тестирования воркфлоу.
Шаг 1: Скачивание установщика
Перейдите на страницу релизов n8n на GitHub (github.com/n8n-io/n8n/releases) или на официальный сайт n8n.io. В разделе «Assets» найдите установщик для вашей ОС:
Шаг 2: Установка и запуск
Запустите скачанный установщик и следуйте стандартным инструкциям для вашей операционной системы. После установки найдите приложение «n8n Desktop» в меню «Пуск», Launchpad или списке приложений и запустите его. Приложение откроет окно браузера с интерфейсом n8n, работающим локально. Все данные по умолчанию сохраняются в папке пользователя.
Развертывание n8n в облаке
Для публичного доступа и командной работы n8n необходимо развернуть на облачном сервере.
Шаг 1: Выбор облачного провайдера
Вы можете использовать любую платформу: DigitalOcean, AWS (EC2), Google Cloud Platform, Microsoft Azure, или даже VPS от других хостинг-провайдеров.
Шаг 2: Создание виртуальной машины (VM)
Создайте новую виртуальную машину (инстанс) с минимальными характеристиками: 1-2 vCPU, 2-4 ГБ RAM, 20+ ГБ SSD. В качестве операционной системы выберите Ubuntu 22.04 LTS или другую популярную дистрибуцию Linux.
Шаг 3: Установка на сервер с помощью Docker Compose (рекомендуемый способ)
Подключитесь к серверу по SSH. Установите Docker и Docker Compose. Создайте файл docker-compose.yml:
version: '3.8'
services:
n8n:
image: n8nio/n8n
container_name: n8n
restart: unless-stopped
ports:
- "5678:5678"
environment:
- N8N_PROTOCOL=https
- N8N_HOST=ваш_домен_или_ip
- N8N_PORT=5678
- N8N_WEBHOOK_URL=https://ваш_домен_или_ip/
- WEBHOOK_URL=https://ваш_домен_или_ip/
- N8N_BASIC_AUTH_ACTIVE=true
- N8N_BASIC_AUTH_USER=admin
- N8N_BASIC_AUTH_PASSWORD=надёжный_пароль
- DB_TYPE=postgresdb
- DB_POSTGRESDB_HOST=postgres
- DB_POSTGRESDB_PORT=5432
- DB_POSTGRESDB_DATABASE=n8n
- DB_POSTGRESDB_USER=n8n
- DB_POSTGRESDB_PASSWORD=секретный_пароль_для_БД
- N8N_METRICS=true
- N8N_METRICS_INCLUDE_DEFAULT_METRICS=true
volumes:
- n8n_data:/home/node/.n8n
depends_on:
- postgres
networks:
- n8n_network
postgres:
image: postgres:13
container_name: n8n_postgres
restart: unless-stopped
environment:
- POSTGRES_USER=n8n
- POSTGRES_PASSWORD=секретный_пароль_для_БД
- POSTGRES_DB=n8n
volumes:
- postgres_data:/var/lib/postgresql/data
networks:
- n8n_network
volumes:
n8n_data:
postgres_data:
networks:
n8n_network:
driver: bridge
Запустите стек командой: docker-compose up -d.
Шаг 4: Настройка обратного прокси и SSL (обязательно для production)
Настройте Nginx или Apache в качестве обратного прокси для порта 5678. Получите бесплатный SSL-сертификат от Let’s Encrypt с помощью Certbot для обеспечения безопасного соединения (HTTPS).
Настройка n8n после установки
После первого входа в интерфейс n8n выполните следующие действия:
- Смена учетных данных по умолчанию: Если вы не установили переменные
N8N_BASIC_AUTH_*, немедленно перейдите в Settings > User Management и смените пароль. - Настройка внешнего хранилища файлов: В Settings > Files可以考虑 подключение S3-совместимого хранилища (AWS S3, MinIO, DigitalOcean Spaces) для сохранения вложений и данных.
- Настройка SMTP для уведомлений: Укажите параметры почтового сервера в Settings > Host settings, чтобы получать уведомления об ошибках воркфлоу.
- Установка сообщества нод (Community Nodes): В Settings > Community Nodes можно добавить пользовательские ноды, расширяющие функционал.
Ответы на часто задаваемые вопросы (FAQ)
Какой метод установки лучше для начинающего?
Для абсолютного новичка, который хочет быстро познакомиться с функционалом, лучше всего подходит Desktop приложение. Оно не требует знаний командной строки, Docker или Node.js и работает «из коробки».
Почему n8n не запускается после установки через npm?
Наиболее распространенные причины:
- Порт 5678 занят: Используйте переменную окружения
N8N_PORT=5679для запуска на другом порту. - Отсутствие прав: При глобальной установке npm на Linux/Mac могут потребоваться права sudo или настройка прав на каталог npm.
- Конфликт версий Node.js: Убедитесь, что у вас установлена Node.js версии 18 или выше. Используйте менеджер версий Node.js (nvm) для переключения между версиями.
Чем отличается установка через Docker от установки через npm?
Установка через npm помещает исполняемые файлы и зависимости прямо в вашу операционную систему. Docker запускает n8n в изолированном контейнере со всеми зависимостями внутри. Docker-подход чище, проще в обновлении и обеспечивает идентичную работу на любой системе. Для production-среды Docker является стандартом де-факто.
Как обновить n8n до последней версии?
Способ обновления зависит от метода установки:
- npm: Выполните команду
npm update n8n -g. - Docker: Остановите контейнер, удалите образ и пересоздайте его с тегом
latestили конкретной версии:docker pull n8nio/n8n:latest && docker-compose down && docker-compose up -d. - Desktop приложение: Скачайте новую версию установщика и установите поверх старой (данные сохраняются).
Всегда делайте резервную копию базы данных или тома Docker перед обновлением.
Где хранятся мои рабочие процессы и настройки?
При установке по умолчанию (без внешней БД) данные хранятся:
- npm / Desktop App: В папке
~/.n8n(домашняя директория пользователя). Файл базы данных SQLite:~/.n8n/database.sqlite. - Docker (с томом): В смонтированной директории на хосте (например,
~/.n8n).
Для переноса данных скопируйте эту папку или дамп внешней базы данных.
Как открыть доступ к n8n из интернета?
Запустите n8n на облачном сервере (VPS) с помощью Docker Compose, как описано выше. Критически важно:
- Настроить обратный прокси (Nginx) с HTTPS (SSL).
- Активировать базовую аутентификацию (
N8N_BASIC_AUTH_ACTIVE=true). - Настроить корректные переменные
N8N_HOSTиN8N_WEBHOOK_URLс вашим доменом. - Открыть в брандмауэре облачного провайдера только порты 80 и 443 для Nginx, но не порт 5678 напрямую.
Никогда не открывайте порт 5678 в интернет без прокси и аутентификации.
Какие есть альтернативы самостоятельной установке?
Компания n8n предлагает облачный хостированный сервис с бесплатным тарифным планом — n8n.cloud. Это избавляет от необходимости устанавливать и обслуживать сервер. Также существуют готовые образы для развертывания в один клик на DigitalOcean, Railway и других платформах.
Добавить комментарий