Skip to content

Read/Write Files from Disk 节点#

使用 Read/Write Files from Disk 节点从运行 n8n 的计算机读取和写入文件。

此节点可访问的路径取决于你的 n8n 部署。详情请参阅文件位置。

操作#

有关为每个操作配置节点的更多信息，请参阅以下部分。

Read File(s) From Disk 从磁盘读取文件#

使用以下参数配置此操作：

  • File(s) Selector 文件选择器：输入您要读取的文件的路径。
    • 要输入多个文件，请输入页面路径模式。您可以使用这些字符来定义路径模式：
      • *：匹配任何字符零次或多次，排除路径分隔符。
      • **：匹配任何字符零次或多次，包括路径分隔符。
      • ?：匹配除路径分隔符外的任何字符一次。
      • []：匹配括号内的任何字符。例如，[abc] 将匹配字符 a、b 或 c，不匹配其他字符。

有关这些字符及其预期行为的更多信息，请参阅 Picomatch 的基本 globbing 文档。

Read File(s) From Disk options 从磁盘读取文件选项#

您还可以使用这些 Options 选项 配置此操作：

  • File Extension 文件扩展名：在节点输出中输入文件的扩展名。
  • File Name 文件名：在节点输出中输入文件的名称。
  • MIME Type MIME 类型：在节点输出中输入文件的 MIME 类型。有关文件扩展名及其 MIME 类型的列表，请参阅 Common MIME types。
  • Put Output File in Field 将输出文件放入字段：输入输出数据中包含文件的字段名称。

Write File to Disk 将文件写入磁盘#

使用以下参数配置此操作：

  • File Path and Name 文件路径和名称：输入文件的目标、文件名和文件扩展名。
  • Input Binary Field 输入二进制字段：输入节点输入数据中将包含二进制文件的字段名称。

Write File to Disk options 将文件写入磁盘选项#

您还可以使用这些 Options 选项 配置此操作：

此操作包含一个选项，即是否 Append 追加 数据到现有文件而不是创建新文件（开启）或创建新文件而不是追加到现有文件（关闭）。

模板和示例#

Template widget placeholder.

文件位置#

此节点可读取和写入的路径取决于你的 n8n 部署。

n8n Cloud#

在 n8n Cloud 上，该节点只能访问 /home/node/ 下的路径。此目录之外的路径（例如 /tmp/ 或 /data/）会因访问错误而失败。

Cloud 上的字段占位符

节点的 File(s) Selector 文件选择器和 File Path and Name 文件路径和名称字段中的默认占位符（例如 /home/user/Pictures/**/*.png 和 /data/example.jpg）只是示例。在 Cloud 上，请将它们替换为 /home/node/ 下的路径。

Cloud 文件系统是临时的

该节点在 Cloud 上写入的文件不保证在工作流执行、worker 重启或实例重新部署之间持久保留。不要使用此节点存储需要长期保留的文件。

n8n 将 /home/node/.n8n/ 目录保留给其内部状态使用。不要在那里写入你自己的文件。

如需在 Cloud 上持久处理文件，请使用云存储节点，例如 AWS S3、Google Drive 或 FTP。

自托管 n8n#

在自托管 n8n 上，默认情况下，该节点可以访问 n8n 进程可到达的任何路径。若要限制访问，请将 N8N_RESTRICT_FILE_ACCESS_TO 环境变量设置为一个或多个允许的目录（用分号分隔）。

n8n 2.0 中的默认值变更

从 n8n 2.0 开始，N8N_RESTRICT_FILE_ACCESS_TO 默认值为 ~/.n8n-files。若要允许在其他位置执行文件操作，请显式设置该变量。详情请参阅 n8n 2.0 破坏性变更。

如果你在 Docker 中运行 n8n，路径指的是 n8n 容器的文件系统，而不是 Docker 主机。若要让此节点访问主机目录，请将这些目录作为卷挂载到容器中。

n8n 建议使用绝对文件路径以防止错误。