Все ноды/Integrations/Files

Локальная ФС (только DEV)

ТОЛЬКО DEV. Локальная папка на сервере как файловое хранилище для File Glob/Read/Write/Tool — аналог WebDAV Config на локальном диске. В production отключено и ограничено LOCAL_FS_ALLOWED_ROOTS.

Локальная ФС (только DEV)
Local FS Config

Тип в графе: local_fs_config

Как попробовать

Чтение из локального каталога

Файл читается из папки на диске сервера. Только для разработки.

Вход
Локальная ФС (только DEV)
Чтение файла
Выход
  • Исполнение
  • Данные
  • Исполнение + данные
Нажмите «Скопировать ноды», откройте редактор и нажмите Ctrl+V на холсте.

Перед запуском выберите своё подключение или базу знаний — в графе стоит REPLACE_ME. Перед запуском укажите: включённые локальные ФС-ноды, каталог на сервере.

Как применять

Нода делает корнем файлового хранилища каталог на диске сервера, где работает бэкенд. Она существует ради разработки и отладки — например, чтобы прогнать воркфлоу по папке с тестовыми файлами, не заводя внешний диск.

В production такие ноды отключены целиком. Постоянный внешний диск — это WebDAV-конфигурация, а файлы самой платформы — Хранилище workspace.

Как это работает

Секретов у локальной папки нет, поэтому путь пишется прямо в поле, без подключения. Перед чтением и записью платформа проверяет две вещи: включены ли локальные ФС-ноды вообще (отдельная настройка сервера, выключенная по умолчанию даже в разработке) и попадает ли указанный путь в список разрешённых корней, если он задан. Не прошло — отказ с объяснением, а не молчаливая работа с чужим каталогом.

Если разрешённый корень ровно один, поле «Корневой путь» подставляется само: это единственное значение, которое проверка всё равно приняла бы.

В production нода не показывается в палитре, но проверка живёт не в палитре, а в момент запуска: спрятать — не значит выключить, и импортированный граф отказывает так же.

Частые ошибки

  • Путь со своей машины. Каталог резолвится там, где выполняется бэкенд, — в типичной установке это файловая система внутри контейнера, а не ваш диск.
  • Расчёт на боевое окружение. Воркфлоу, работавший на локальной папке, при переносе в production перестаёт запускаться. Переключайте на WebDAV заранее.
  • Ожидание, что файлы появятся во вкладке «Файлы». Вкладка показывает только хранилище воркспейса, локальный каталог — отдельное дерево.
  • Локальный диск как долговременное хранилище. Он не переживает пересоздание контейнера и не общий для нескольких реплик воркера: одна и та же нода на разных репликах увидит разное.
  • Пустое поле «Корневой путь». Это ошибка конфигурации, она видна ещё до запуска.

Входы

Выходы

ПортПроводДанныеПримечания
Local FS ConfigoutputДанныеdataobject

Настройки

ПолеТипПо умолчаниюОписание
Корневой путьroot_pathstring

Абсолютный путь к каталогу на сервере, используемый как корень файлового хранилища (ТОЛЬКО DEV). Должен находиться внутри LOCAL_FS_ALLOWED_ROOTS, если этот список задан; в production ноды локальной ФС отключены целиком.