N8n яндекс диск

N8n и Яндекс.Диск: Полное руководство по автоматизации работы с файлами

N8n — это платформа с открытым исходным кодом для оркестрации рабочих процессов (workflow automation), которая позволяет соединять различные приложения и сервисы между собой без необходимости писать код. Яндекс.Диск — облачное файловое хранилище, предоставляющее API для управления файлами и папками. Интеграция N8n с Яндекс.Диском создает мощный инструмент для автоматизации рутинных операций с файлами: резервного копирования, синхронизации, обработки загружаемых данных, организации контента и многого другого. Это достигается через использование официального узла (ноды) Яндекс.Диска в N8n, который предоставляет набор триггеров и операций для взаимодействия с API сервиса.

Архитектура и принципы взаимодействия

Взаимодействие между N8n и Яндекс.Диском строится на модели REST API. Пользователь создает в интерфейсе N8n рабочий процесс (workflow), состоящий из узлов. Узел Яндекс.Диска выполняет роль коннектора, преобразуя действия в рабочем процессе в конкретные HTTP-запросы к API Яндекс.Диска. Для авторизации используется OAuth 2.0, где N8n выступает в роли клиента, получая токен доступа от Яндекс ID. Этот токен позволяет рабочему процессу выполнять разрешенные действия с файлами и папками на Диске пользователя.

Настройка учетных данных Яндекс.Диска в N8n

Перед созданием рабочих процессов необходимо добавить учетные данные (credentials) для доступа к Яндекс.Диску.

• В интерфейсе N8n перейдите в раздел «Credentials» (Учетные данные) в боковом меню.
• Нажмите «Add Credential» (Добавить учетные данные) и выберите из списка «Yandex Disk OAuth2 API».
• Вам потребуется создать OAuth-приложение в Яндекс ID. Для этого:
  • Перейдите на https://oauth.yandex.ru.
  • Создайте новое приложение. В поле «Callback URI» (Redirect URI) укажите: https://your-n8n-domain.com/rest/oauth2-credential/callback (замените на актуальный адрес вашего N8n).
  • Скопируйте «ID приложения» (Client ID) и «Пароль» (Client Secret).
• Вставьте Client ID и Client Secret в соответствующие поля в N8n.
• Нажмите «Connect account» (Подключить аккаунт). Откроется окно авторизации Яндекс, где необходимо предоставить запрашиваемые права вашему приложению N8n.
• После подтверждения учетная запись будет сохранена и доступна для выбора в узлах Яндекс.Диска.

Узлы (ноды) Яндекс.Диска в N8n и их функционал

Узел Яндекс.Диска в N8n является универсальным и может выполнять множество операций. Тип операции выбирается в настройках узла.

Триггеры (Trigger)

Триггеры запускают рабочий процесс при наступлении определенного события.

• File/Folder Updated: Активирует workflow при изменении (создании, изменении содержимого, переименовании) файла или папки в указанной директории Яндекс.Диска. Это основной триггер для реактивной автоматизации.

Операции (Actions)

Операции выполняются как часть рабочего процесса по цепочке.

• Copy: Копирует файл или папку внутри Яндекс.Диска.
• Create Folder: Создает новую папку.
• Delete: Удаляет файл или папку.
• Download: Загружает файл с Яндекс.Диска. Данные файла становятся доступны для последующих узлов (например, для обработки в узле «Read PDF» или «Spreadsheet File»).
• Get: Получает метаданные (размер, тип, путь, дата изменения) о файле или папке.
• Move: Перемещает файл или папку.
• Search: Выполняет поиск файлов по имени.
• Upload: Загружает файл на Яндекс.Диск. Файл может быть получен из предыдущего узла (например, из вложения email, сгенерированного отчета или скачанного из другого сервиса).

Практические примеры рабочих процессов (Workflows)

Пример 1: Автоматическое резервное копирование вложений электронной почты на Яндекс.Диск

Цель: Все вложения, приходящие на определенный email-ящик, должны сохраняться в папку Яндекс.Диска с датой в названии.

1. Узел «Email Trigger (IMAP)»: Настраивается на проверку почтового ящика. При получении нового письма, workflow запускается.
2. Узел «Extract from HTML» или «Convert to JSON»: (Опционально) Для обработки тела письма.
3. Узел «SplitInBatches» или «Iterator»: Если вложений несколько, этот узел разбивает их для обработки по одному.
4. Узел «Yandex Disk» (Операция: Upload): Для каждого вложения создается папка на Диске (если она не существует) по пути, например, /Backups/Attachments/{{% formatDate now 'YYYY-MM-DD' }}. Файл загружается в эту папку. Имя файла можно модифицировать, добавив дату получения.

Пример 2: Синхронизация новой загрузки с обработкой в Google Таблицах

Цель: При загрузке CSV-файла в папку «Загрузки» на Яндекс.Диске, его данные должны быть импортированы в Google Таблицу для дальнейшего анализа.

1. Узел «Yandex Disk» (Триггер: File/Folder Updated): Наблюдает за папкой /Загрузки. При появлении нового файла с расширением .csv запускает workflow.
2. Узел «Yandex Disk» (Операция: Download): Скачивает этот CSV-файл в память N8n.
3. Узел «Spreadsheet File»: Преобразует бинарные данные CSV в структурированный JSON, который может понять N8n.
4. Узел «Google Sheets» (Операция: Append): Добавляет полученные строки данных в указанный лист Google Таблицы.
5. Узел «Yandex Disk» (Операция: Move): Перемещает обработанный CSV-файл из папки «/Загрузки» в папку «/Архив» для избежания повторной обработки.

Пример 3: Ежедневное создание отчетов и сохранение на Диск

Цель: Каждый день в 9:00 формировать отчет на основе данных из базы данных и сохранять его в виде PDF на Яндекс.Диск, а также отправлять ссылку в Telegram.

1. Узел «Schedule Trigger»: Настраивается на ежедневный запуск в 9:00.
2. Узел «Postgres» или «MySQL»: Выполняет SQL-запрос для получения данных за прошедший день.
3. Узел «Generate HTML»: Форматирует полученные данные в HTML-шаблон отчета.
4. Узел «Convert to PDF»: (Через сторонний сервис или утилиту) Конвертирует HTML в PDF-файл.
5. Узел «Yandex Disk» (Операция: Upload): Загружает сгенерированный PDF-файл в папку /Отчеты/{{% formatDate now 'YYYY-MM' }} с именем Отчет_{{% formatDate now 'YYYY-MM-DD' }}.pdf.
6. Узел «Telegram»: Отправляет сообщение в чат со ссылкой на загруженный файл (ссылка публикуется через метод publish Яндекс.Диска или из метаданных после загрузки).

Таблица: Сравнение операций и их параметров

Операция	Ключевые параметры (Fields)	Входные данные (Input)	Выходные данные (Output)
Download	Путь к файлу на Яндекс.Диске.	—	Бинарные данные файла и метаинформация.
Upload	Путь для сохранения, имя файла, режим перезаписи.	Бинарные данные файла (из предыдущего узла).	Метаданные загруженного файла (путь, размер, ссылка).
Create Folder	Путь к создаваемой папке.	—	Метаданные созданной папки.
Copy / Move	Исходный путь, путь назначения.	—	Метаданные скопированного/перемещенного ресурса.
Search	Поисковый запрос (имя файла), ограничение по количеству.	—	Массив с метаданными найденных файлов.
File/Folder Updated (Trigger)	Путь к наблюдаемой папке, глубина сканирования.	—	Метаданные измененного файла/папки и тип события.

Обработка ошибок и отладка

При построении сложных рабочих процессов критически важна корректная обработка ошибок. В N8n для узла Яндекс.Диска можно настроить ветку «Error Trigger». Например, если операция загрузки (Upload) завершилась неудачей из-за сетевой проблемы, workflow можно направить по этой ветке, чтобы отправить уведомление администратору через Email или Telegram, а также повторить попытку через узел «Wait». Для отладки используйте функцию «Execute Node» для пошагового запуска и проверяйте данные, передаваемые между узлами, во встроенном редакторе JSON.

Ограничения и лучшие практики

• Ограничения API Яндекс.Диска: Имеются лимиты на количество запросов. Для бесплатного тарифа это примерно 10,000 запросов в сутки. Также есть ограничение на размер загружаемого файла (до 10 Гб за один запрос через API).
• Безопасность: Никогда не храните учетные данные OAuth в открытом виде. Используйте встроенную систему учетных данных N8n с шифрованием. Для публичных инстансов N8n настройте HTTPS.
• Производительность: При обработке большого количества файлов используйте пагинацию (если доступна) и узлы для пакетной обработки (SplitInBatches), чтобы не превысить лимиты памяти N8n.
• Идемпотентность: Стройте workflows так, чтобы их повторный запуск не приводил к дублированию данных или нежелательным эффектам (например, используйте операцию Move после обработки файла).

Часто задаваемые вопросы (FAQ)

Как часто триггер «File/Folder Updated» проверяет изменения на Яндекс.Диске?

Триггер в N8n работает на основе механизма опроса (polling). Частота опроса определяется настройками расписания (Schedule) самого workflow, в котором находится триггерный узел. Вы можете установить интервал, например, каждые 5 или 10 минут. Реального времени (real-time) достичь сложно, но для большинства бизнес-задач интервала в несколько минут достаточно.

Можно ли загружать на Яндекс.Диск файлы больше 10 ГБ через N8n?

Непосредственно через стандартную операцию Upload — нет, так как она использует API-метод, имеющий ограничение в 10 ГБ. Для загрузки очень больших файлов Яндекс.Диск предоставляет специальный механизм загрузки по частям (резумейбл-загрузка). В текущей стандартной ноде N8n эта возможность не реализована. Решением может быть использование кастомного узла через «HTTP Request» или модификация существующего.

Как организовать двустороннюю синхронизацию папки на сервере и Яндекс.Диске?

N8n не является специализированным инструментом для непрерывной двусторонней синхронизации, подобным Syncthing или rclone. Однако можно создать два отдельных workflow: один отслеживает изменения в локальной папке (с помощью узла «Watch Files» на сервере, где установлен N8n) и загружает новые/измененные файлы на Диск. Второй workflow использует триггер Яндекс.Диска для скачивания новых файлов из облака на сервер. Важно предусмотреть логику для избежания зацикливания.

Можно ли использовать одну учетную запись Яндекс.Диска для нескольких разных рабочих процессов?

Да, одни и те же учетные данные (Credentials), добавленные в N8n, можно выбирать в настройках любого количества узлов Яндекс.Диска в различных рабочих процессах. Все они будут иметь одинаковый уровень доступа, предоставленный при OAuth-авторизации.

Что делать, если узел Яндекс.Диска возвращает ошибку «401 Unauthorized»?

Ошибка 401 указывает на проблему с токеном доступа. Наиболее частая причина — истечение срока его действия (токены в Яндекс OAuth имеют ограниченное время жизни). N8n обычно должен автоматически обновлять токен с помощью refresh token. Если это не происходит:

1. Перейдите в «Credentials» и проверьте состояние вашей учетной записи Яндекс.Диска.
2. Попробуйте повторно авторизоваться, нажав «Update» для этих учетных данных.
3. Убедитесь, что OAuth-приложение в Яндекс ID активно и callback URI указан верно.

Как обработать файлы определенного типа, например, только изображения?

После триггера «File/Folder Updated» или операции «Search» добавьте узел «Filter» или «IF». В условии укажите проверку поля, содержащего расширение файла (например, {{ $json.name }}). Используйте операторы «ends with» или регулярные выражения для отбора нужных расширений: .jpg, .png, .gif. Далее соедините выход «true» этого узла с узлами для обработки изображений.

Заключение

Интеграция N8n с Яндекс.Диском открывает широкие возможности для автоматизации файловых операций, устраняя ручной труд и снижая вероятность ошибок. От простого копирования и резервного копирования до сложных процессов, включающих обработку данных, преобразование форматов и интеграцию с десятками других сервисов (от Google Workspace и Telegram до баз данных и CRM-систем). Гибкость N8n позволяет адаптировать рабочие процессы под точно заданные бизнес-требования, делая управление файлами в облаке эффективным, предсказуемым и контролируемым. Успешная реализация требует четкого планирования логики workflow, понимания ограничений API и применения лучших практик по обработке ошибок и безопасности.