Как запустить ИИ-агент Nod от n8n на собственном VPS
Установите ИИ-агент Nod на VPS с помощью Docker Compose. В руководстве описана настройка приватного порта 4310, создание SSH-туннеля и обязательное сохранение ключа Vault.
Что такое Nod и что именно вы создаете
Nod — это персональный ИИ-агент от команды разработчиков n8n. Его можно запустить на VPS с помощью набора Docker Compose из официального репозитория. В этом руководстве мы фиксируем версию набора на теге nod-v0.8.1 и оставляем приложение на приватном порту. Доступ к нему осуществляется через SSH-туннель или по протоколу HTTPS. Этап резервного копирования включен в процесс установки, так как сохраненные учетные данные невозможно восстановить без ключа.
В README Nod описывается как агент, обладающий собственным компьютером и браузером: «Он обрабатывает счета, готовит вас к звонкам и отменяет подписки на реальных веб-сайтах. Он работает на вашей машине с выбранной вами моделью и запрашивает подтверждение перед выполнением действий от вашего имени». Вы взаимодействуете с ним через единый чат. У него есть собственное рабочее пространство Linux и браузер, а также возможность подключения к Gmail, Calendar, Slack, Notion и сети Интернет.
Два факта помогут сформировать ожидания перед началом установки. Во-первых, в README Nod помечен как «исследовательская версия» (research preview). На сайте документации также присутствует баннер «Ранняя версия» (Early preview), предупреждающий: «Ожидайте недоработок и критических изменений». Во-вторых, в README указано, что проверка безопасности Nod «основана на суждении модели». Относитесь к нему как к инструменту на стадии предварительного тестирования. Предоставляйте ему доступ только к тем учетным записям, которые вы готовы использовать для экспериментов.
VPS подходит для Nod по одной простой причине. Согласно документации, запланированные задачи выполняются только тогда, когда машина, на которой запущен Nod, включена. Ноутбук уходит в спящий режим. Сервер — нет.
Чем Nod отличается от рабочих процессов AI Agent в n8n
Nod — это не AI Assistant в n8n, и для его работы n8n не требуется. В файле README на вопрос «Нужен ли мне n8n?» дан ответ: «Нет. Nod — это самостоятельное приложение, созданное командой разработчиков n8n. Это не AI Assistant для n8n».
В документации n8n узел AI Agent описывается так: «Подключите языковую модель и один или несколько инструментов, и агент сам решит, какие инструменты вызвать для выполнения задачи». Вы создаете такого агента внутри редактора n8n и должны подключить к нему как минимум один вспомогательный узел (tool sub-node). Если ваша задача именно такая, создание рабочего процесса с узлом AI Agent в n8n содержит все необходимые инструкции. Самостоятельный хостинг n8n на VPS с использованием Docker и HTTPS поможет развернуть сервер n8n, на котором вы сможете это реализовать.
Вот как мы интерпретируем эти два набора документации. Узел AI Agent — это агент, которого вы проектируете узел за узлом внутри n8n. Nod — это готовое чат-приложение с собственным рабочим пространством и браузером, которому вы даете задания на обычном языке. Ни на одной странице поставщика нет прямого сравнения этих продуктов, поэтому воспринимайте это как краткий обзор, а не как официальную позицию.
Эти два инструмента могут работать вместе. На странице Nod, посвященной n8n, сказано: «Подключите свой n8n один раз, а затем вызывайте его по имени в чате». После этого Nod может создать «агента n8n с инструментами и каналами, которые вы укажете». Если в вашем запросе n8n не упоминается, Nod использует собственные задачи и расписания.
Лицензирование: Nod распространяется под Apache-2.0, n8n — нет
Репозиторий Nod, github.com/n8n-io/nod, распространяется на условиях лицензии Apache License 2.0, правообладателем является n8n GmbH. В нижней части README указано: "Copyright 2026 n8n GmbH · Apache License 2.0". Сторонние компоненты, включенные в состав продукта, такие как шрифт Geist, логотипы провайдеров и компоненты среды выполнения для настольных систем, сохраняют свои собственные условия использования.
Сам n8n использует другую лицензию. Его код, за исключением файлов, помеченных .ee., распространяется на условиях Sustainable Use License. Основное ограничение сформулировано так: "Вы можете использовать или изменять программное обеспечение только для собственных внутренних бизнес-целей либо для некоммерческого или личного использования". Лицензия Apache-2.0 не накладывает подобных ограничений на использование Nod. Если вы решаете, что можно создавать на базе n8n, ознакомьтесь с разъяснением лицензии n8n Sustainable Use License перед тем, как планировать создание продукта на его основе.
Требования к VPS для запуска Nod
В документации по self-hosted установке указаны Docker Engine версии 25 или новее с поддержкой Compose v2, OpenSSL, а также sha256sum или shasum. Для сборки из исходного кода также потребуется Git. Поддерживаются хосты на Linux с архитектурой AMD64 или ARM64, либо Mac с установленным Docker Desktop.
Что касается ресурсов, в документации сказано: «Начните с двух ядер CPU, 8 ГБ оперативной памяти и 50 ГБ дискового пространства». Это рекомендуемая отправная точка, а не измеренный минимум. В документации добавлено, что одновременное выполнение задач в браузере и работа с локальными моделями требуют больше ресурсов. В compose.yaml комплекта объясняется большая часть объема оперативной памяти. Лимиты установлены на уровне 2 ГБ для контейнера сервера, 3 ГБ для браузера и 2 ГБ для рабочей области. Вы можете изменить эти лимиты с помощью NOD_SERVER_MEMORY, NOD_BROWSER_MEMORY и NOD_WORKSPACE_MEMORY в файле .env. Для Postgres и Caddy лимиты не установлены.
Для установки API-ключ модели не требуется. Вы подключите модель в приложении после его запуска.
Если на сервере еще нет Docker, установите его. В руководстве Основы Docker Compose на VPS описан этот процесс. Затем проверьте версии и установите остальные инструменты:
docker version
docker compose version
sudo apt update && sudo apt install -y git opensslВ разделе Server: файла docker version должна отображаться версия 25 или новее, а команда docker compose version должна выполниться успешно. Приведенные ниже команды предполагают, что ваш пользователь может запускать docker без sudo. Если это не так, добавьте sudo перед каждой командой docker и sh.
Клонирование репозитория Nod с использованием зафиксированного тега
Комплект находится в deployment/self-host/, и образы Nod собираются из вашей локальной копии. Никакие компоненты Nod не загружаются из реестра, поэтому версия, которую вы используете, определяется выбранным тегом.
git clone https://github.com/n8n-io/nod.git
cd nod
git checkout nod-v0.8.1
cd deployment/self-host
lsВ ls должны отображаться setup.sh, compose.yaml, Caddyfile, backup.sh и restore.sh, помимо других файлов. Теги nod-v0.8.0 и nod-v0.8.1 были созданы 16 ноября 2026 года. Они не являются самыми новыми. По состоянию на 21 ноября 2026 года, версия nod-v0.9.1 (от 20 ноября) помечена как Latest. Данное руководство было проверено на комплекте nod-v0.8.1, поэтому в нем зафиксирован именно этот тег. В разделе обновлений ниже показано, как перейти на более новую версию.
Сторонние образы в compose.yaml зафиксированы по хешу (digest), а не по :latest: postgres:17-alpine, node:24.21.0-bookworm-slim и caddy:2.11.7-alpine. Образы Nod по умолчанию помечаются тегом local через NOD_IMAGE_TAG. Установка этой переменной не приводит к загрузке опубликованного релиза.
Генерация секретов с помощью setup.sh
sh setup.shsetup.sh не принимает никаких флагов. Скрипт копирует .env.example в приватный файл .env и заполняет четыре сгенерированных значения: имя проекта Compose, NOD_AUTH_TOKEN (из openssl rand -hex 32), NOD_VAULT_KEY (из openssl rand -base64 32) и NOD_POSTGRES_PASSWORD. Затем выполняется chmod 600 .env, чтобы доступ к файлу имел только ваш пользователь.
В завершение выводится Ready. Run: docker compose --file compose.yaml --env-file .env up -d --build --wait. Если .env уже существует, скрипт сохраняет его и выводит Using the existing .env. Its keys and data are unchanged.. Скрипт прерывает работу, если NOD_AUTH_TOKEN, NOD_VAULT_KEY или NOD_POSTGRES_PASSWORD уже заданы в вашей оболочке. Если вы экспортировали любую из этих переменных, сначала выполните unset для них. В старых версиях Docker выполнение останавливается с ошибкой Use Docker Engine 25 or newer..
Сборка и запуск стека
docker compose up -d --build --wait
docker compose psПервая сборка выполняется медленно, так как комплект собирает образы Nod из исходного кода. Не закрывайте терминал до завершения выполнения команды. --wait ожидает, пока сервисы с проверками работоспособности (health checks) не перейдут в состояние healthy, поэтому отсутствие ошибок означает, что стек запущен. docker compose ps должен показать, что server, postgres, browser и другие сервисы запущены, а server имеет статус healthy.
Если запустить docker compose up до setup.sh, Compose откажется запускаться и выведет Run sh setup.sh first. Это происходит потому, что compose.yaml помечает NOD_AUTH_TOKEN как обязательный, а записывает его только setup.sh.
Для чтения логов сервера:
docker compose logs --tail 100 serverВ документации указано, что токен никогда не выводится в логах при запуске.
Порт 4310 остается на loopback, и ufw не обеспечивает его защиту
Сервер публикует порт хоста следующим образом в compose.yaml:
'${NOD_BIND_ADDRESS:-127.0.0.1}:${PORT:-4310}:${PORT:-4310}'Таким образом, Nod ожидает подключений на порту 4310, а сторона хоста привязана к 127.0.0.1. Подключиться могут только процессы, запущенные на самом сервере. Оставьте эту конфигурацию без изменений.
Это важнее, чем кажется, поскольку порты, опубликованные через Docker, обходят ufw. В документации Docker указано, что трафик к опубликованному порту контейнера «перенаправляется до того, как попадет в настройки брандмауэра ufw», «фактически игнорируя конфигурацию вашего брандмауэра». Правило ufw deny 4310 не защитит порт, опубликованный на всех интерфейсах. Привязка к loopback — это то, что сохраняет приватность порта 4310. Почему порты Docker обходят ufw описывает механизм этого процесса и способы проверки вашего сервера.
Docker добавляет одно предостережение относительно версий. В релизах старше 28.0.0 хосты в том же сегменте сети уровня 2 могут получить доступ к портам, опубликованным на localhost. На VPS этот сегмент является сетью вашего провайдера, поэтому по возможности используйте Docker версии 28 или новее.
Не меняйте NOD_BIND_ADDRESS на 0.0.0.0 для удаленного доступа к приложению. В документации сказано: «Никогда не открывайте доступ к PostgreSQL, браузеру, рабочей области или Docker-соединению». Используйте один из двух способов доступа, описанных ниже.
Открытие Nod через SSH-туннель
Для туннеля не требуется домен или открытые порты, кроме SSH. Выполните следующую команду на своем компьютере, а не на сервере:
ssh -L 4310:127.0.0.1:4310 user@203.0.113.10Не закрывайте сессию и перейдите по адресу http://localhost:4310 в локальном браузере. Для данной настройки оставьте NOD_PUBLIC_URL со значением по умолчанию http://localhost:4310. Если вы изменили PORT, обновите настройки с обеих сторон туннеля и адрес в браузере в соответствии с изменениями.
Приложение запросит токен доступа. Выведите его на сервере:
grep NOD_AUTH_TOKEN .envВставьте значение после = в форму доступа, затем завершите начальную настройку и подключите модель. Токен требуется даже при использовании туннеля.
Если вы подключаетесь к своим серверам через Tailscale, ознакомьтесь с разделом Tailscale Serve и Funnel перед тем, как размещать что-либо перед Nod, так как Funnel публикует сервис в общедоступном интернете.
Запуск Nod по HTTPS с использованием профиля Caddy
Для публичного доступа в комплекте предусмотрен профиль https. Он добавляет контейнер Caddy, который получает и обновляет TLS-сертификат (transport layer security) и перенаправляет трафик на сервер. Вам потребуется домен, DNS-запись которого указывает на ваш VPS. Также необходимо открыть входящие TCP-порты 80 и 443 в сетевом брандмауэре вашего провайдера, если таковой имеется.
Отредактируйте файл .env и укажите точный адрес источника:
NOD_PUBLIC_URL=https://nod.example.comNOD_PUBLIC_URL — это «точный адрес источника, по которому вы открываете Nod». Указывайте только схему и хост. Пути, параметры запроса и фрагменты не допускаются. Профиль требует указания источника https:// на порту 443 с использованием доменного имени или IPv4-адреса. После этого запустите стек с данным профилем:
docker compose --profile https up -d --build --waitПродолжайте добавлять --profile https к последующим командам запуска, остановки и проверки статуса, иначе Compose проигнорирует контейнер Caddy. Откройте https://nod.example.com и вставьте токен, как описано выше.
Учитывайте последствия этого действия. Сервис Caddy публикует порты 80:80, 443:443 и 443:443/udp без привязки к конкретному адресу, поэтому они прослушиваются на всех интерфейсах. Они всегда используют порты хоста 80 и 443, независимо от настроек PORT. Из-за описанного выше обхода Docker, ufw не сможет их закрыть. Если вы уже используете обратный прокси-сервер, пропустите этот профиль. Направьте прокси на 127.0.0.1:4310 и установите NOD_PUBLIC_URL в значение HTTPS-источника вашего прокси-сервера.
Использование данных и обратная связь: проверка текущих настроек
Включение обмена данными об использовании
В документации указано, что обмен данными об использовании включен для новых владельцев по умолчанию. Данные передаются в проект PostHog команды Nod, размещенный в ЕС, включая данные от независимых установок. Развертывание также должно поддерживать эту функцию, а NOD_ANALYTICS_ENABLED=false всегда отключает её.
nod-v0.8.1 поставляет NOD_ANALYTICS_ENABLED=false в .env.example, а setup.sh копирует эту строку в ваш .env. Таким образом, чистая установка по этому руководству начинается с отключенной аналитикой на уровне сервера. Проверьте это:
grep -n NOD_ANALYTICS_ENABLED .envЕсли эта строка отсутствует или пуста, сервер считает, что аналитика разрешена, если он работает в режиме production. Это может произойти при использовании старого или написанного вручную .env. В таком случае установите значение строки на false самостоятельно.
Сборщик обратной связи работает отдельно. NOD_FEEDBACK_ENABLED отсутствует в .env.example, при этом документация указывает, что он включен по умолчанию. В документации приведено полное описание процесса отказа от участия: установите параметры analytics и feedback в false, а NOD_ONBOARDING_EMAIL_URL оставьте пустым.
echo 'NOD_FEEDBACK_ENABLED=false' >> .env
grep -n -e NOD_ANALYTICS_ENABLED -e NOD_FEEDBACK_ENABLED -e NOD_ONBOARDING_EMAIL_URL .env
docker compose up -d --wait serverПоследняя команда пересоздает сервер с новыми значениями. Добавьте --profile https, если используете её. Владельцы также могут изменить настройки общего доступа в приложении в разделе Settings, Privacy & data, Share usage data. Прекращение обмена данными не удаляет информацию, которая уже была отправлена.
Резервное копирование ключа Vault и данных: этот шаг обязателен
NOD_VAULT_KEY — это 32-байтовый ключ в формате base64, который шифрует сохраненные учетные данные. Он находится в .env, вне базы данных. В документации Vault сказано: «Без него сохраненные учетные данные прочитать невозможно». Nod не создает новый ключ, если зашифрованные данные уже существуют. На странице self-host указано: «одной базы данных недостаточно для восстановления сохраненных учетных данных». Если вы потеряете ключ, все логины, добавленные в Nod, будут утрачены, даже при наличии идеального дампа базы данных.
Поэтому сначала сохраните ключ отдельно — в менеджере паролей или другом безопасном месте вне сервера:
grep NOD_VAULT_KEY .envЗатем выполните полное резервное копирование с помощью скрипта из комплекта поставки. Путь назначения должен быть абсолютным и еще не существовать:
mkdir -p "$HOME/nod-backups"
chmod 700 "$HOME/nod-backups"
sh backup.sh "$HOME/nod-backups/nod-2026-11-21"Скрипт останавливает сервер, браузер и рабочую область на время копирования, а затем запускает их снова. Он выводит Backup saved: и путь. В директории находятся .env, source-commit, postgres.dump, архивы сервера, рабочей области, инструментов и данных браузера, а также файл-маркер complete. Убедитесь в наличии маркера, прежде чем полагаться на эту резервную копию.
В документации сказано: «Резервная копия содержит секреты». В ней хранятся все сгенерированные секреты, включая ключ Vault. Храните ее в зашифрованном виде и ограничьте доступ к ней. Скопируйте ее с сервера, так как резервная копия на том же диске будет потеряна вместе с самим диском. TLS-сертификаты в резервную копию не включаются.
Восстановление Nod в чистую рабочую копию
Процесс восстановления выполняется в новой папке и новом проекте Compose. Узнайте коммит, на котором был сделан бэкап, а затем переключитесь (checkout) именно на этот коммит:
commit="$(cat "$HOME/nod-backups/nod-2026-11-21/source-commit")"
git clone https://github.com/n8n-io/nod.git nod-restored
cd nod-restored
git checkout "$commit"
cd deployment/self-host
sh restore.sh "$HOME/nod-backups/nod-2026-11-21" nod-restoredНе запускайте setup.sh заранее. Для restore.sh требуется рабочая копия без файла .env, а также source-commit, соответствующий выбранной ревизии. Скрипт создает новые тома, восстанавливает базу данных и не запускает приложение. В конце он выполняет Restored into a new project. Review .env before starting Nod..
Остановите исходный сервер перед запуском восстановленного. Затем выполните docker compose up -d --build --wait, указав --profile https для публичного адреса. Никогда не запускайте docker compose down --volumes на сервере, данные которого вы хотите сохранить. Эта команда удаляет тома с данными.
Обновление Nod до новой версии
Сначала создайте резервную копию. Затем, находясь в nod/deployment/self-host:
docker compose stop
git fetch origin --tags
git checkout nod-v0.9.1
docker compose up -d --build --waitМиграции базы данных выполняются при запуске Nod, поэтому отменить обновление путем переключения на старый тег невозможно. В документации указано: «Не используйте старую версию приложения с уже обновленной базой данных». Откат означает восстановление резервной копии, сделанной до обновления, в свежую копию репозитория. Перед каждым обновлением читайте примечания к выпуску, так как метка preview означает возможные критические изменения. Не изменяйте COMPOSE_PROJECT_NAME во время обновления.
Чтобы сменить токен доступа, выполните openssl rand -hex 32, замените значение NOD_AUTH_TOKEN в .env и выполните docker compose up -d --wait server. Старый токен перестанет работать. Никогда не заменяйте NOD_VAULT_KEY для смены доступа.
FAQ
Нужно ли мне устанавливать n8n для работы Nod?
Нет. В файле README указано, что Nod — это самостоятельное приложение, созданное командой n8n, и оно не является AI-ассистентом n8n. Оно работает в собственном стеке Docker Compose. Вы можете подключить экземпляр n8n позже и указать Nod использовать его по имени, но процесс установки никак не зависит от n8n.
Является ли Nod открытым ПО с той же лицензией, что и n8n?
Нет. Nod распространяется по лицензии Apache License 2.0, авторское право принадлежит n8n GmbH, а сторонние компоненты сохраняют свои собственные условия использования. Код n8n, за исключением файлов .ee., распространяется по лицензии Sustainable Use License, которая ограничивает использование внутренними бизнес-целями, некоммерческими или личными нуждами. Лицензия Apache-2.0 не содержит подобных ограничений.
Как открыть Nod на VPS без доменного имени?
Используйте SSH-туннель с вашего компьютера: ssh -L 4310:127.0.0.1:4310 user@203.0.113.10. Оставьте его открытым, перейдите по адресу http://localhost:4310 и вставьте NOD_AUTH_TOKEN из файла .env на сервере. Оставьте NOD_PUBLIC_URL со значением по умолчанию. Порт 4310 остается привязанным к интерфейсу loopback на сервере, поэтому новые порты не открываются для внешнего доступа.
Что произойдет, если я потеряю ключ NOD_VAULT_KEY?
Сохраненные учетные данные невозможно будет прочитать повторно. Ключ используется для их шифрования и хранится в .env, вне базы данных. Nod не создаст новый ключ, если зашифрованные данные уже существуют, поэтому дамп базы данных сам по себе не поможет. Храните копию ключа вне сервера. Запускайте sh backup.sh с указанием абсолютного пути, так как резервная копия содержит .env вместе с ключом.
Защищает ли ufw порты Nod?
Не те порты, которые публикует Docker. Docker направляет трафик на опубликованные порты контейнеров в обход правил ufw. Порт 4310 остается приватным только потому, что compose.yaml привязывает его к 127.0.0.1. Профиль https публикует порты 80, 443 и 443/udp на всех интерфейсах, поэтому ufw не может их закрыть. В версиях Docker старше 28.0.0 хосты в том же сегменте уровня 2 (layer 2) также могут получить доступ к портам, опубликованным на localhost.