从磁盘读取/写入文件
使用“从磁盘读取/写入文件”节点从运行 n8n 的计算机读取文件或将文件写入到运行 n8n 的计算机。
该节点可以访问的路径取决于您的 n8n 部署。详情请参阅文件位置。
操作
有关为每个操作配置节点的更多信息,请参阅以下部分。
从磁盘读取文件
使用以下参数配置此操作:
- 文件选择器:输入要读取的文件的路径。
- 要输入多个文件,请输入页面路径模式。您可以使用这些字符来定义路径模式:
*:匹配任何字符零次或多次,不包括路径分隔符。**:匹配任何字符零次或多次,包括路径分隔符。?:匹配除路径分隔符之外的任何字符一次。[]:匹配括号内的任何字符。例如,[abc]将匹配字符a、b或c,仅此而已。
有关这些字符及其预期行为的更多信息,请参阅 Picomatch 的基本通配符 文档。
从磁盘读取文件选项
您还可以使用以下选项配置此操作:
- 文件扩展名:在节点输出中输入文件的扩展名。
- 文件名:输入节点输出中文件的名称。
- MIME 类型:在节点输出中输入文件的 MIME 类型。有关文件扩展名及其 MIME 类型的列表,请参阅 常见MIME类型。
- 将输出文件放入字段:输入输出数据中包含文件的字段名称。
将文件写入磁盘
使用以下参数配置此操作:
- 文件路径和名称:输入文件的目标位置、文件名和文件扩展名。
- 输入二进制字段:输入将包含二进制文件的节点输入数据中的字段名称。
将文件写入磁盘选项
您还可以使用以下选项配置此操作:
此操作包括一个选项,是否将数据追加到现有文件而不是创建新文件(打开)或创建新文件而不是追加到现有文件(关闭)。
模板和示例
文件位置
该节点可以读取和写入的路径取决于您的 n8n 部署。
n8n 云
在n8n云上,节点只能访问/home/node/下的路径。此目录之外的路径(例如,/tmp/ 或 /data/)会失败并出现访问错误。
提示
云上的字段占位符
节点的 文件选择器 和 文件路径和名称 字段中的默认占位符(例如 /home/user/Pictures/**/*.png 和 /data/example.jpg)是示例。在云上,将其替换为 /home/node/ 下的路径。
警告
云文件系统是短暂的
不保证此节点在云上写入的文件在工作流程执行、工作线程重新启动或实例重新部署过程中持续存在。不要使用此节点来存储您需要保留的文件。
n8n 为其内部状态保留 /home/node/.n8n/ 目录。不要在那里编写您自己的文件。
对于云上的持久文件处理,请使用云存储节点,例如 AWS S3、Google驱动器 或 FTP。
自托管 n8n
在自托管 n8n 上,默认情况下,节点可以访问 n8n 进程可以到达的任何路径。要限制访问,请将 N8N_RESTRICT_FILE_ACCESS_TO 环境变量设置为一个或多个允许的目录(以分号分隔)。
提示
功能可用性
从 n8n 2.0 开始,N8N_RESTRICT_FILE_ACCESS_TO 默认为 ~/.n8n-files。要允许其他地方的文件操作,请显式设置该变量。详情请参阅n8n 2.0 重大变更。
如果您在 Docker 中运行 n8n,路径是指 n8n 容器的文件系统,而不是 Docker 主机。要使主机目录可供该节点使用,请将它们作为卷安装到容器中。
n8n 建议使用绝对文件路径以防止错误。