场景导入：当 n8n 遇上 Docker 的“次元壁”

兄弟们，我是 N8N大学 的主编。今天咱们来聊一个在 Docker 部署 n8n 时几乎人人都会遇到的“灵魂拷问”。

你兴冲冲地用 Docker 跑起了 n8n，想写个定时任务，每天把数据导出存到宿主机的硬盘上做备份。结果你添加了 Write Binary File 节点，填上路径 /root/data/report.xlsx，运行工作流，满屏的绿色（成功），但你去宿主机对应的文件夹一看——空空如也。

反过来也一样，你想读取宿主机上的一个配置文件，n8n 却一脸懵逼：“/etc/config.json: no such file or directory”。

这就是容器的“次元壁”。默认情况下，Docker 容器是一个封闭的沙盒，它根本看不到宿主机的文件系统。对于习惯了本地部署 n8n 的老玩家来说，这种“隔阂感”简直让人抓狂。今天，笔者就带你彻底打破这层限制，让 n8n 自由地读写宿主机文件。

核心原理：一句话点破“卷挂载”

解决这个问题的核心技术只有一个：Volume Mounting（卷挂载）。

你可以把它想象成在容器和宿主机之间修了一条“隧道”或者建了一座“共享文件夹”。

当你把宿主机的 /home/n8n_data 目录挂载到容器内部的 /data 目录时，容器里的 n8n 只要往 /data 里写文件，其实数据直接就流淌到了宿主机的 /home/n8n_data 中。反之亦然。这不仅仅是文件共享，更是让 n8n 感知物理世界的关键一步。

实战操作：修改 Docker 配置（docker-compose.yml）

绝大多数 n8n 玩家都是通过 docker-compose 启动的。如果你还在用 docker run 命令，笔者强烈建议你转用 compose，管理起来方便太多。

找到你的 docker-compose.yml 文件，定位到 volumes: 部分。我们需要在这里添加映射规则。

步骤 1：定义宿主机目录（绝对路径是关键）

首先，在宿主机上创建一个专门用于 n8n 读写的目录。比如：

mkdir -p /opt/n8n/files

记住这个绝对路径，Docker 非常讨厌相对路径，一定要写全。

步骤 2：编写挂载规则

在 docker-compose.yml 中，找到 n8n 服务下的 volumes 配置项。标准的写法是 宿主机路径:容器内路径。

假设我希望 n8n 在容器内的 /data 目录操作文件，配置如下：

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n
    # ... 其他配置 ...
    volumes:
      - /opt/n8n/files:/data  # <-- 这就是我们要加的核心代码
      - ./n8n:/home/node/.n8n # <-- 这是你原本可能就有的持久化配置

注意：一定要确保 /opt/n8n/files 这个路径在宿主机上真实存在，且 Docker 有读写权限（通常 chmod 777 暴力解决，或者 chown 1000:1000 更优雅）。

步骤 3：重启容器生效

修改完配置文件后，执行以下命令让配置生效：

docker-compose down
docker-compose up -d

至此，物理层面的“隧道”已经打通了。

n8n 工作流实操：读写不再是难题

现在，回到 n8n 的界面，让我们验证一下成果。

场景 A：写入文件到宿主机

假设你想把抓取的数据存为 CSV。

1. 添加 Write Binary File 节点。
2. File Name/Basename：这里填入的是容器内的路径。因为我们挂载了 /data，所以填 /data/my_report.csv。
3. Binary Data：连接上游节点生成的二进制数据流。

运行之后，赶紧去宿主机的 /opt/n8n/files 目录看一眼，你会发现 my_report.csv 已经静静地躺在那里了。

场景 B：读取宿主机的文件（如 Excel 模板）

你需要读取宿主机上的一个 Excel 模板进行填充。

1. 添加 Read Binary File 节点。
2. File Location：同样填容器内的路径 /data/template.xlsx。
3. n8n 会读取这个文件，变成二进制流，你可以传给 Spreadsheet File 节点去处理。

避坑指南：权限与路径的爱恨情仇

虽然操作很简单，但笔者见过太多人在权限问题上翻车。这里分享两个最典型的坑：

坑点 1：Permission Denied (权限被拒)

现象：n8n 报错 Error: EACCES: permission denied, open '/data/test.txt'。

原因：Docker 容器默认以非 root 用户（通常是 UID 1000）运行。如果你在宿主机上用 root 创建了目录，容器内的用户没权限写入。

解决办法：

在宿主机上执行：

sudo chown -R 1000:1000 /opt/n8n/files

或者在 docker-compose 中明确指定用户（如果你不确定容器内 UID，最简单的就是给目录 777 权限：`chmod 777 /opt/n8n/files`，虽然不安全，但在个人小环境里最快捷）。

坑点 2：路径填错导致“空跑”

现象：工作流显示成功，文件却不在宿主机上。

原因：新手容易混淆 容器路径 和 宿主机路径。

金标准：在 n8n 的节点配置里，永远只写你在 docker-compose 里设定的 容器内路径（比如 /data）。宿主机路径只用于 docker-compose 的配置，千万别写到 n8n 节点里去。

FAQ 问答

Q1: 我用的是官方提供的 Docker 一键安装命令，没有 docker-compose.yml 怎么办？

A: 如果你用的是类似 docker run -d --name n8n ... 的命令，你需要在命令中加入 -v 参数。例如：-v /opt/n8n/files:/data。但为了长期维护，笔者强烈建议你转为 docker-compose 管理。

Q2: 这种方式会影响 n8n 的升级吗？

A: 不会。文件挂载是独立于容器镜像的。当你升级 n8n 版本时，只要保证 docker-compose.yml 中的 volumes 部分不动，你存放在宿主机 /opt/n8n/files 里的文件就绝对安全。

Q3: 我可以挂载多个目录吗？

A: 当然可以。你可以在 volumes 列表下添加多行，比如同时挂载脚本目录、日志目录等。格式都是一样的 宿主机路径:容器路径。

总结与资源

打破容器的“次元壁”，让 n8n 具备读写宿主机文件的能力，是进阶自动化玩家的必经之路。核心就在于理解并熟练使用 docker volume 挂载。

一旦打通了这一步，无论是生成日报推送到本地、读取本地脚本执行，还是进行复杂的文件清洗，n8n 在 Docker 环境下都能像原生应用一样丝滑。

如果你在配置过程中遇到了其他奇怪的报错，欢迎在 N8N大学 的评论区留言，笔者会第一时间帮你排查。下期见！