Бекап воркфлоу n8n у GitHub: розбір нашого шаблону з Telegram-командою

n8n не має вбудованого бекапу. Воркфлоу лежать у базі інстансу, і якщо база померла, впав диск або хтось видалив не той воркфлоу — відновлювати нема з чого. Кнопки «скасувати» тут немає, а історії змін — тим паче.

Найтиповіший сценарій навіть не про катастрофу. Ви правите бойовий воркфлоу, щось ламається, і ви хочете повернути вчорашню версію. У n8n ви цього не зробите. Саме тому ми зібрали шаблон бекапу й виклали його публічно.

Чому ручний експорт не працює

n8n дозволяє вивантажити воркфлоу в JSON руками. На практиці цей спосіб має три вади.

• Його забувають. Бекап, який треба робити самому, робиться перед великими змінами й ніколи — перед дрібними. А ламають зазвичай саме дрібні.
• Немає історії. Файл на диску — це один зріз. Побачити, що саме змінилося між двома версіями, неможливо.
• Не масштабується. Коли воркфлоу за сорок, вивантажувати їх поштучно ніхто не буде.

Як працює шаблон

У воркфлоу два входи. Перший — розклад щодня о 03:00. Другий — команда /backup у Telegram, коли бекап потрібен просто зараз, перед ризикованою правкою.

• Перевірка команди. Якщо запуск прийшов з Telegram, воркфлоу спершу переконується, що повідомлення починається з /backup, і лише тоді працює далі.
• Вивантаження воркфлоу. Через n8n API забираються всі воркфлоу інстансу — не список, а повні визначення з нодами й зв'язками.
• Складання файлу. Усе зводиться в один JSON, а шлях у репозиторії формується як backups/YYYY-MM-DD/workflows.json — тобто по каталогу на кожен день.
• Перевірка в GitHub. Воркфлоу дивиться, чи існує вже файл за цим шляхом.
• Коміт. Якщо файл є — оновлюється, якщо немає — створюється, з датованим повідомленням коміту.
• Звіт у Telegram. Приходить повідомлення з кількістю воркфлоу й посиланням на коміт.

Чому саме GitHub, а не диск чи хмара

Копія на Google Drive відповідає на питання «чи є в мене бекап». Git відповідає на значно кориснішs питання — «що змінилося і коли». Кожен коміт дає diff, тож ви бачите, яка саме нода зникла й якого дня, а не просто маєте вчорашній архів.

Друга причина прозаїчніша: репозиторій уже є майже в кожної команди, він безкоштовний для приватних проєктів і не потребує окремого сервісу для зберігання.

Важливо: креденшели в бекап не потрапляють

Це головне, що варто зрозуміти до запуску. n8n API віддає структуру воркфлоу — ноди, параметри, зв'язки — але не віддає самі креденшели. Вони зберігаються зашифрованими окремо.

З цього випливає дві речі. Хороша: ваш репозиторій не перетворюється на сховище паролів, і навіть якщо він витече, ключів там не буде. Незручна: відновлення з бекапу — це не один клік. Воркфлоу повернуться повністю, але підключення до сервісів доведеться прив'язати заново.

Тому репозиторій під бекапи все одно тримайте приватним: у параметрах нод часто лежать ID таблиць, адреси вебхуків і внутрішні URL, які світити назовні не варто.

Що треба налаштувати

• n8n API — ключ із правами на читання воркфлоу.
• GitHub — доступ до репозиторію, а також owner і repo у відповідних нодах.
• Telegram-бот — з увімкненим вебхуком для тригера. Окремо: у Code-ноді треба підставити свій chat ID, інакше нічні бекапи за розкладом нікому не звітуватимуть.

Де це ламається

• Бекап, який ніхто не перевіряв. Класика жанру: бекапи йдуть рік, а при першій же спробі відновлення з'ясовується, що вони порожні. Один раз імпортуйте JSON у тестовий інстанс і переконайтесь, що воркфлоу піднімаються.
• Тиша замість помилки. Якщо API-ключ протермінувався, воркфлоу може падати мовчки. Варто налаштувати Error Workflow — щоб про зламаний бекап ви дізналися одразу, а не в момент, коли він знадобився.
• Публічний репозиторій. Параметри нод містять чимало внутрішньої інформації. Приватний репозиторій — не паранойя, а мінімум.
• Один файл на день. Якщо ви правите воркфлоу кілька разів на день, денний зріз перезапише проміжні стани. Для активної розробки має сенс частіший розклад.

Кому це потрібно

Якщо у вас у n8n більше ніж кілька воркфлоу, і хоча б один із них бойовий, бекап потрібен уже зараз. Це той випадок, коли вартість налаштування — пів години, а вартість відсутності вимірюється тижнями відновлення по пам'яті.

Особливо це стосується self-hosted інсталяцій: у хмарному n8n частину відповідальності за збереження бере на себе платформа, на власному сервері — не бере ніхто.

Забрати шаблон

Шаблон опублікований у бібліотеці n8n і імпортується одним кліком: Back up all workflows to GitHub with daily schedule and Telegram /backup.

Якщо потрібно налаштувати n8n під ваші процеси, розгорнути self-hosted інстанс або навести лад у наявних воркфлоу — напишіть нам.