Краткое резюме: Для локального запуска n8n требуется либо npm (Node.js 20.19-24.x), либо Docker. Самый быстрый способ — использовать npx n8n для немедленного тестирования без установки, тогда как Docker обеспечивает лучшую изоляцию и готовность к продакшену. Оба метода предоставляют полный доступ к возможностям автоматизации рабочих процессов n8n без периодических затрат на облако.
Настройка n8n на локальном компьютере позволяет избежать периодических платежей за подписку, предоставляя полный контроль над автоматизацией рабочих процессов. Согласно официальной документации n8n, для установок через npm платформе требуется версия Node.js от 20.19 до 24.x, или Docker для развертывания в контейнерах.
Выбор между локальным хостингом и облачными сервисами влияет как на бюджет, так и на гибкость. По данным обсуждений в сообществе, локальные установки обрабатывают неограниченное количество рабочих процессов, тогда как облачные планы включают ценообразование на основе количества выполнений (начиная с 24 долларов в месяц за 2500 выполнений, согласно некоторым отчетам пользователей).
Предварительные требования для локальной установки
Перед установкой n8n локально системе требуется определенное программное обеспечение в зависимости от выбранного метода.
Требуемая версия Node.js для установки через npm полностью зависит от конкретных требований развертываемой версии n8n, поскольку сам npm совместим со всеми поддерживаемыми LTS-версиями Node.js. Официальная документация указывает этот точный диапазон версий для совместимости. Проверьте текущую версию, выполнив в терминале команду `node --version`.
Для установки Docker требуется Docker Engine или Docker Desktop. Команда n8n рекомендует Docker для большинства задач самостоятельного хостинга, поскольку он обеспечивает чистую изоляцию и избегает несовместимости с операционной системой.
Системные требования
Локальные экземпляры n8n работают в системах Windows, macOS и Linux. В официальной документации не указаны минимальные требования к ОЗУ, но сложность рабочего процесса определяет фактические потребности в ресурсах.
Установка изначально занимает минимальное дисковое пространство. Требования к хранилищу растут в зависимости от данных рабочего процесса, истории выполнений и пользовательских пакетов узлов.
Метод 1: Запуск n8n с помощью npm
Установка через npm предоставляет самый быстрый путь к запуску n8n локально. Этот метод работает непосредственно в хост-системе без контейнеризации.
Быстрый старт с npx
Самый простой способ — использовать npx без постоянной установки. Откройте терминал и выполните:
| npx n8n |
Эта команда загрузит все необходимое и автоматически запустит n8n. Интерфейс станет доступен по адресу localhost:5678 в течение нескольких секунд.
Метод npx отлично подходит для тестирования и оценки. Он не требует глобальных пакетов npm или постоянных изменений в системе.
Глобальная установка npm
Для постоянной установки глобальный пакет npm обеспечивает последовательный доступ:
| npm install n8n -g |
После завершения установки запустите n8n в любое время, выполнив:
| n8n |
Текущая основная стабильная версия n8n — 2.x (например, 2.10.4). Бета-версии могут содержать нестабильные функции и их следует избегать для рабочих процессов в продакшене.
Конфигурация и хранение данных
По умолчанию установки npm хранят данные рабочих процессов в каталоге ~/.n8n. Это место содержит учетные данные, определения рабочих процессов и историю выполнений.
Переменные окружения управляют поведением n8n. Установите переменную N8N_PORT, чтобы изменить порт по умолчанию 5678. Другие переменные настраивают соединения с базами данных, URL-адреса веб-хуков и параметры аутентификации.
Метод 2: Запуск n8n с помощью Docker
Установка Docker является рекомендуемым подходом для локального хостинга n8n. Официальная документация подчеркивает использование Docker для нужд самостоятельного хостинга в продакшене.
Базовая команда запуска Docker
Запустите n8n с помощью одной команды Docker:
| docker run -it --rm --name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n |
Эта команда создает контейнер с именем n8n, сопоставляет порт 5678 с хостом и сохраняет данные в каталоге ~/.n8n.
Контейнер работает в интерактивном режиме с флагом -it. Удалите --rm, чтобы сохранить контейнер после его остановки.
Docker Compose для настройки продакшена
Конфигурации Docker Compose обеспечивают лучший контроль для производственных сред. Репозиторий n8n-hosting на GitHub содержит готовые к использованию файлы Docker Compose для различных архитектур.
Базовая конфигурация docker-compose.yml выглядит следующим образом:
| version: '3.8' services: n8n: image: n8nio/n8n restart: always ports: - "5678:5678" environment: - N8N_BASIC_AUTH_ACTIVE=true - N8N_BASIC_AUTH_USER=admin - N8N_BASIC_AUTH_PASSWORD=password volumes: - ~/.n8n:/home/node/.n8n |
Запустите стек командой:
| docker-compose up -d |
Флаг -d запускает контейнеры в detached-режиме, позволяя использовать терминал для других задач.
Первоначальная настройка и доступ
После запуска n8n любым из методов перейдите по адресу localhost:5678 в веб-браузере. На экране первоначальной настройки будет предложено ввести адрес электронной почты и пароль для учетной записи администратора.
Этот первый пользователь станет владельцем экземпляра с полными административными привилегиями. Дополнительные пользователи могут быть добавлены позже через интерфейс управления пользователями.
Настройка аутентификации
Для безопасности включите аутентификацию даже при локальных установках. Конфигурации Docker Compose принимают переменные окружения для аутентификации напрямую:
| N8N_BASIC_AUTH_ACTIVE=true N8N_BASIC_AUTH_USER=admin N8N_BASIC_AUTH_PASSWORD=strongpassword |
Эти переменные активируют базовую HTTP-аутентификацию, требуя учетные данные для всех попыток доступа.
Тестирование пользовательских узлов локально
Официальная документация объясняет, как тестировать пользовательские узлы во время разработки. Сначала установите n8n глобально, затем соберите и привяжите пакет пользовательского узла.
В каталоге пользовательского узла выполните:
| npm run build npm link |
Затем перейдите в каталог узлов n8n (обычно ~/.n8n/custom/) и привяжите пакет:
| npm link <node-package-name> |
Пользовательский узел появится в интерфейсе n8n после перезапуска экземпляра.
Полезные ресурсы для автоматизации, используемые с n8n
Если вы учитесь запускать n8n локально и тестируете рабочие процессы на своей машине, вам также могут быть полезны внешние помощники и шаблоны, которые облегчают автоматизацию распространенных задач. Get AI Perks предлагает библиотеку шаблонов рабочих процессов и инструменты с поддержкой ИИ, которые вы можете использовать вместе с n8n или для прототипирования идей автоматизации, прежде чем создавать их самостоятельно.
С Get AI Perks вы можете:
- Начинать с готовых шаблонов рабочих процессов
- Получать помощь ИИ для рутинной логики и контента
- Изучать распространенные шаблоны автоматизации перед их внедрением в n8n
- Комбинировать шаблоны с вашей локальной настройкой n8n
Откройте для себя Get AI Perks, чтобы найти помощников по автоматизации, которые поддерживают ваши рабочие процессы n8n.
Устранение распространенных проблем
Конфликты портов представляют собой наиболее частую проблему при установке. Если порт 5678 уже используется, либо остановите конфликтующий сервис, либо измените порт n8n, используя переменную окружения N8N_PORT.
Несовместимость версий Node
Использование версий Node.js вне диапазона 20.19-24.x вызывает сбои при установке. Репозиторий n8n на GitHub документирует проблемы, возникающие, когда разработчики пытаются настроить локальные среды разработки, подчеркивая важность совместимости версий Node.
Проверьте совместимость версий Node перед устранением других проблем. При необходимости переключайте версии Node с помощью nvm (Node Version Manager).
Ошибки разрешений томов Docker
Проблемы с разрешениями при подключении тома ~/.n8n препятствуют сохранению данных. Контейнеры Docker запускаются от имени пользователя node, у которого может не быть прав на запись в каталог хоста.
Создайте каталог с соответствующими разрешениями перед запуском контейнера:
| mkdir ~/.n8n chmod 777 ~/.n8n |
Часто задаваемые вопросы
Может ли n8n работать без доступа к Интернету?
Да, n8n полностью функционирует в автономном режиме для локальных рабочих процессов. Подключение к Интернету становится необходимым только тогда, когда рабочие процессы взаимодействуют с внешними API или облачными сервисами.
Сколько стоит запуск n8n локально?
Локальные установки бесплатны. Community Edition предоставляет все основные функции без лицензионных платежей. Облачный хостинг начинается с ограничений по количеству выполнений и ежемесячной платы, но локальный хостинг полностью устраняет эти ограничения, согласно обсуждениям в сообществе.
Должны ли новички использовать npm или Docker?
Новичкам, тестирующим n8n, следует начать с npx для немедленного доступа. Docker имеет больше смысла для постоянного использования, поскольку он обеспечивает лучшую изоляцию и более простые обновления.
Где n8n хранит данные рабочих процессов локально?
По умолчанию каталог данных находится в ~/.n8n в домашней папке пользователя. Это место содержит файлы базы данных SQLite, учетные данные и журналы выполнений, если не настроено иначе.
Могут ли несколько экземпляров n8n работать на одной машине?
Да, но каждому экземпляру требуется уникальный порт. Установите разные порты, используя переменную окружения N8N_PORT для каждого экземпляра. Docker упрощает это благодаря сопоставлению портов в отдельных контейнерах.
Как работают обновления для локальных установок?
Установки npm обновляются через `npm update -g n8n` или `npm install -g n8n@latest`. Пользователи Docker получают последний образ командой `docker pull n8nio/n8n`, а затем пересоздают контейнеры. Всегда делайте резервную копию каталога ~/.n8n перед обновлением.
Соображения по продакшену
Официальная документация n8n подчеркивает, что самостоятельный хостинг требует технических знаний. Настройка серверов, управление ресурсами и защита приложений требуют опыта системного администрирования.
Для развертывания в продакшене Docker Compose обеспечивает основу. Добавьте обратный прокси, такой как nginx или Caddy, для поддержки HTTPS. Репозиторий n8n-hosting включает конфигурации Caddy, готовые к развертыванию.
Выбор базы данных имеет значение для больших нагрузок. База данных SQLite по умолчанию подходит для умеренного использования, но PostgreSQL обеспечивает лучшую производительность для высокообъемной автоматизации, согласно официальным рекомендациям.
Выбор: локальный или облачный
Локальный хостинг n8n подходит для команд с техническими возможностями и специфическими требованиями к безопасности. Данные остаются на контролируемой инфраструктуре, а ограничения по количеству выполнений исчезают.
Однако локальный хостинг требует обслуживания, резервного копирования и мониторинга. Облачный хостинг передает эти обязанности команде инфраструктуры n8n. Проверьте официальный веб-сайт для получения информации о текущих ценах на облачные услуги и сравнения функций.
Запуск n8n локально предоставляет полный контроль над инфраструктурой автоматизации рабочих процессов. Независимо от того, используете ли вы npm для быстрого тестирования или Docker для развертывания в продакшене, оба метода обеспечивают полную платформу без периодических затрат. Начните с npx для немедленного исследования, а затем переходите к Docker, когда рабочие процессы приближаются к использованию в продакшене.
