N8n работа с файлами

N8n: Полное руководство по работе с файлами

N8n — это инструмент автоматизации с открытым исходным кодом, который использует подход, основанный на узлах (нодах). Работа с файлами является одной из ключевых задач в автоматизации бизнес-процессов. N8n предоставляет широкий набор встроенных узлов и методов для чтения, записи, преобразования и передачи файлов между различными сервисами и локальной файловой системой.

Основные узлы для работы с файлами

В N8n существует несколько категорий узлов, предназначенных для операций с файлами. Их можно разделить на узлы-триггеры, узлы действий и узлы преобразования.

1. Узлы для чтения и записи файлов

Эти узлы взаимодействуют непосредственно с файловой системой сервера, на котором развернут n8n.

Read Binary Files: Этот узел считывает один или несколько файлов в бинарном формате. Каждый файл становится отдельным элементом в выходных данных. Узел полезен для последующей обработки или загрузки файлов в облачные хранилища. Важно указать корректный путь к файлу относительно директории n8n или использовать абсолютный путь.

Write Binary File: Узел записывает бинарные данные, полученные из предыдущего узла, в указанную директорию. Он может создавать новые файлы или перезаписывать существующие. Позволяет задавать имя файла динамически, используя выражения и данные из рабочего процесса.

2. Узлы для преобразования данных в файлы и обратно

Эти узлы не работают с файловой системой напрямую, а преобразуют данные внутри рабочего процесса.

Spreadsheet File: Один из самых мощных узлов. Он конвертирует данные между форматами CSV, HTML, ODS, RTF, XLS, XLSX и JSON. Может как читать данные из файла (например, CSV) в структурированный JSON для обработки в n8n, так и записывать JSON-данные, полученные из других узлов, в файл электронной таблицы.
Binary/Text Converter: Выполняет критически важную функцию преобразования между строковым (текстовым) и бинарным представлением данных. Например, конвертирует текст в бинарные данные для создания текстового файла или преобразует бинарные данные (из узла Read Binary Files) в текст для парсинга.

3. Узлы интеграции с облачными хранилищами и передачей файлов

N8n поддерживает десятки коннекторов для обмена файлами с внешними сервисами.

Облачные хранилища: Узлы для Google Drive, Dropbox, Nextcloud, S3-совместимых хранилищ (Amazon S3, MinIO), OneDrive и других. Позволяют загружать, скачивать, искать и удалять файлы.
Файловые протоколы: Узлы для работы по FTP, SFTP и SCP. Полезны для взаимодействия с legacy-системами или безопасной передачи файлов.
Мессенджеры и почта: Узлы для Telegram, Email (SMTP), Discord и других могут отправлять и принимать файлы в качестве вложений.

Структура данных файла в n8n

Для корректной работы с файлами необходимо понимать, как n8n представляет файл внутри рабочего процесса. Файловые данные передаются между узлами в специальном формате.

Поле (JSON property)	Тип данных	Описание	Пример
binary	Объект	Контейнер для бинарных данных файла. Содержит одну или несколько пар ключ-значение (например, `data`).	`"binary": { "data": {...} }`
data.mimeType	Строка	MIME-тип файла. Определяет природу данных.	`"image/png", "application/json", "text/csv"`
data.fileType	Строка	Расширение файла без точки.	`"png", "pdf", "csv"`
data.data	Строка	Сами бинарные данные файла, закодированные в формате Base64.	`"iVBORw0KGgoAAAANSUhEUgAA..."`
json	Объект/Массив	Содержит небинарные метаданные элемента. Для файловых операций здесь часто хранится имя файла.	`"json": { "fileName": "report.pdf" }`

Практические сценарии и рабочие процессы

Сценарий 1: Ежедневное создание отчета в CSV и отправка по почте

Trigger: Узел Schedule Trigger запускает workflow каждый день в 8:00.
Data Source: Узел HTTP Request или базы данных (PostgreSQL, MySQL) получает данные за прошедший день.
Transformation: Узел Spreadsheet File получает JSON-данные и конвертирует их в формат CSV. На выходе узла формируется бинарный объект с файлом.
Attachment: Узел Email (SMTP) использует бинарные данные из предыдущего узла в качестве вложения. Имя файла можно задать динамически, например, report-{{ $now.format('YYYY-MM-DD') }}.csv.

Сценарий 2: Обработка входящих файлов из Google Drive

Trigger: Узел Google Drive Trigger отслеживает появление новых файлов в определенной папке.
Download: Узел Google Drive (узел действия) скачивает обнаруженный файл. На выходе — бинарный объект.
Condition: Узел IF проверяет расширение файла (например, .csv).
Branch 1 (для CSV): Узел Spreadsheet File читает бинарные CSV-данные и конвертирует их в JSON. Далее следует обработка данных.
Branch 2 (для изображений): Узел HTTP Request отправляет бинарный файл на внешний API для обработки изображений (например, распознавания текста).

Критические аспекты и лучшие практики

Безопасность путей: При использовании узлов Read/Write Binary File избегайте использования пользовательского ввода для формирования путей без валидации, чтобы предотвратить уязвимости типа Path Traversal.
Производительность с большими файлами: N8n хранит данные рабочего процесса в памяти. Работа с файлами размером в сотни мегабайт может привести к исчерпанию памяти. Для больших файлов предпочтительнее использовать потоковую передачу через интеграции с облачными хранилищами или прямыми API.
Кодировка текстовых файлов: При работе с текстовыми файлами (через Binary/Text Converter или Spreadsheet File) всегда проверяйте кодировку (UTF-8, Windows-1251). Узел Spreadsheet File позволяет указать кодировку при чтении/записи.
Очистка временных файлов: Если workflow создает временные файлы на сервере, добавьте в конце узел для их удаления (через Execute Command или стандартные узлы файловой системы), чтобы не захламлять диск.
Именование файлов: Используйте выражения n8n для создания уникальных и понятных имен файлов, включающих дату, время или ID из данных: order_{{ $json.orderId }}_{{ $now.format('YYYYMMDDHHmmss') }}.pdf.

Ответы на часто задаваемые вопросы (FAQ)

Вопрос 1: Как ограничить размер загружаемых файлов в n8n?

Максимальный размер файла, который может обработать n8n, ограничен двумя параметрами: лимитом памяти Node.js и настройкой binary_data_max_size в файле конфигурации n8n (~/.n8n/config). По умолчанию это 250 МБ. Для увеличения лимита необходимо задать переменную окружения N8N_BINARY_DATA_MAX_SIZE=500 (значение в МБ) и, возможно, увеличить лимит памяти Node.js с помощью флага --max-old-space-size.

Вопрос 2: Можно ли работать с файлами, не сохраняя их на диск сервера n8n?

Да, это предпочтительный способ. Большинство операций (преобразование форматов, передача между сервисами) происходит в оперативной памяти. Физическая запись на диск сервера требуется только при использовании узлов Read/Write Binary File. Для обмена между сервисами (например, скачать из Dropbox, преобразовать и загрузить в Google Drive) файл на диск не сохраняется.

Вопрос 3: Почему узел Spreadsheet File не читает мой CSV-файл корректно (проблемы с разделителями, кодировкой)?

Узел Spreadsheet File имеет расширенные настройки для парсинга. При чтении CSV необходимо вручную указать:

Delimiter: Разделитель полей (запятая, точка с запятой, табуляция).
Encoding: Кодировка файла (например, UTF-8, Windows-1251 для кириллицы).
Include Empty Cells: Как обрабатывать пустые ячейки.
Header Row: Содержит ли первая строка заголовки столбцов.

Проверьте исходный файл в текстовом редакторе, чтобы точно определить эти параметры.

Вопрос 4: Как обработать несколько файлов одновременно в одном workflow?

N8n работает в концепции «items» (элементов). Если на вход узла, работающего с файлами (например, Binary/Text Converter), приходит несколько элементов, каждый из которых содержит бинарные данные файла, узел обработает их все. Например, узел Read Binary Files с маской *.png создаст на выходе несколько элементов. Последующий узел HTTP Request в режиме «Send All Items» отправит каждый файл отдельным запросом.

Вопрос 5: Как создать PDF-файл в n8n?

В n8n нет встроенного узла для генерации PDF «из коробки». Стандартное решение:

Сгенерировать HTML-шаблон отчета (используя узлы для работы со строками или шаблонизатор).
Передать этот HTML во внешний сервис через узел HTTP Request. Можно использовать специализированные API (вроде Gotenberg, Puppeteer в собственном микросервисе) или облачные функции.
Получить бинарные данные PDF в ответ и далее работать с ними как с файлом.

Альтернативно, можно использовать узлы для интеграции с документами Google, создавать документ там и экспортировать его в PDF.

Заключение

Работа с файлами в n8n является гибкой и мощной благодаря разделению данных на бинарные и JSON-компоненты, а также наличию специализированных узлов для преобразования и интеграции. Ключ к эффективной автоматизации файловых процессов лежит в понимании структуры данных n8n, правильном выборе узлов для конкретной задачи и следовании лучшим практикам, особенно в вопросах безопасности и производительности. Комбинируя встроенные возможности n8n с внешними API, можно выстроить сложные многоступенчатые процессы обработки файлов, минимизируя ручной труд и ошибки.