n8n на Proxmox, QNAP и Raspberry Pi: homelab-деплой без иллюзий ¶

Обновлено: 2026-05-29

Proxmox, QNAP и Raspberry Pi подходят для обучения, домашних автоматизаций и малого внутреннего контура. Но это не магический production: слабый диск, отсутствие бэкапов, динамический IP, перегрев Raspberry Pi или странные права Container Station легко убьют n8n быстрее, чем ошибка в workflow. Поэтому цель этой статьи — не “запустить любой ценой”, а выбрать правильный homelab-профиль и понимать его ограничения.

Какой вариант выбрать ¶

Платформа	Лучше использовать	Когда не стоит
Proxmox	VM с Docker Compose	если нет опыта backup/snapshot/firewall
Proxmox LXC	лёгкий dev-стенд	для сложного Docker без понимания nesting/cgroups
QNAP	Container Station application	если NAS слабый, занят файлами и без UPS
Raspberry Pi 4/5	домашние автоматизации, обучение	для AI/RAG, тяжёлых PDF, больших executions

Proxmox: VM вместо хрупкого LXC ¶

Для большинства пользователей проще и надёжнее создать небольшую Ubuntu/Debian VM и запустить n8n через Docker Compose. Так меньше сюрпризов с правами, Docker nesting, cgroups и обновлениями Proxmox.

# внутри VM
sudo apt update
sudo apt install -y ca-certificates curl git
# затем установите Docker по официальной инструкции для вашей ОС
git clone https://your-repo/n8n-stack.git
cd n8n-stack
cp .env.example .env
docker compose up -d

QNAP: Container Station ¶

На QNAP используйте Container Station Applications и вставляйте Docker Compose как приложение. Не храните секреты в публичных заметках NAS, проверьте volume paths и заранее решите, где лежит Postgres backup.

создайте отдельную папку для n8n data;
не давайте контейнеру лишние host mounts;
обновление делайте через новый compose pull/up, а не хаотичное пересоздание контейнера;
NAS должен быть под UPS, если workflow важные.

Raspberry Pi: только с SSD и 64-bit OS ¶

Raspberry Pi можно использовать для обучения и домашних сценариев: Home Assistant, Telegram alerts, локальные webhook, простые API. Для стабильности ставьте 64-bit OS, SSD, нормальное питание и ограничьте executions retention.

services:
  n8n:
    image: n8nio/n8n:latest
    restart: unless-stopped
    environment:
      DB_TYPE: postgresdb
      DB_POSTGRESDB_HOST: postgres
      GENERIC_TIMEZONE: Europe/Moscow
    volumes:
      - n8n_data:/home/node/.n8n
  postgres:
    image: postgres:16-alpine
    restart: unless-stopped
    volumes:
      - postgres_data:/var/lib/postgresql/data
volumes:
  n8n_data:
  postgres_data:

Smoke-test после запуска ¶

Откройте UI n8n по HTTPS/VPN.
Создайте тестовый Webhook workflow.
Отправьте curl-запрос на production URL.
Проверьте, что execution появился и сохранился.
Перезапустите контейнеры и убедитесь, что данные не пропали.
Запустите backup script и попробуйте восстановить dump в отдельную папку/VM.

Типовые ошибки homelab ¶

Симптом	Причина	Решение
после перезапуска всё пропало	не подключён volume	проверить volumes и backup
webhook ведёт на localhost	не задан WEBHOOK_URL	настроить домен/туннель/reverse proxy
Raspberry Pi зависает	SD-карта, перегрев, нехватка RAM	SSD, охлаждение, меньше executions, без тяжёлого AI
QNAP не даёт права на папку	UID/GID и Container Station paths	проверить владельца volume и путь mount

Операционный runbook для self-hosted ¶

Для темы «n8n на Proxmox, QNAP и Raspberry Pi» важно разделять настройку и эксплуатацию. Настройка отвечает на вопрос “запустилось ли”, эксплуатация — “сможем ли мы восстановиться, обновиться и расследовать инцидент без потери credentials и execution history”.

Перед изменениями проверьте бэкап базы, значение N8N_ENCRYPTION_KEY, состояние volume, логи web-процесса и worker-процесса. Главный риск — поменять настройку только в одном контейнере, забыть про worker или потерять volume/encryption key.

Слой	Что зафиксировать	Зачем
Вход	состояние контейнеров, очередь, переменные окружения, volume и последние строки логов	позволяет повторить проблему без доступа к production-секретам
Контроль	restart_count, memory_usage, queue_depth, worker_concurrency, failed_executions	показывает деградацию раньше, чем пользователи начинают писать в поддержку
Безопасность	поменять настройку только в одном контейнере, забыть про worker или потерять volume/encryption key	снижает риск скрытых дублей, утечки данных и неконтролируемых write-действий
Готовность	есть тест на happy path, пустой вход, повтор и сбой внешнего сервиса для «n8n на Proxmox, QNAP и Raspberry Pi»	делает статью пригодной для runbook, а не только для чтения

Пример безопасного входного контракта ¶

docker compose ps
docker compose logs --tail=200 n8n
docker compose logs --tail=200 n8n-worker
printenv | grep -E 'N8N_|WEBHOOK_|DB_|QUEUE_'
# перед изменениями: backup базы + проверка N8N_ENCRYPTION_KEY

Критерий готовности ¶

есть свежий backup базы и проверено значение N8N_ENCRYPTION_KEY
web, worker, queue и database используют согласованные переменные окружения
после изменения проверены логи, healthcheck и запуск критичных workflow
записан rollback-план с командами и ответственным

Связанные материалы ¶

Документация и источники ¶

Вопросы и ответы ¶

Можно ли держать n8n на Raspberry Pi? ¶

Да, для обучения и домашних сценариев. Для стабильности используйте 64-bit OS, SSD, нормальное питание, backup и не запускайте тяжёлые AI/RAG workflow.

Что лучше в Proxmox: VM или LXC? ¶

Для большинства пользователей надёжнее VM с Docker Compose. LXC легче, но чаще требует понимания Docker nesting, cgroups и прав.

Можно ли ставить n8n на QNAP? ¶

Да, через Container Station и Docker Compose. Но нужно внимательно настроить volumes, backup, права папок и не публиковать n8n в интернет без HTTPS/VPN.