如何正确升级 n8n？ | 简单易懂的现代魔法

↕️如何正确升级 n8n？

type

status

date

slug

summary

n8n 的所有工作流、凭据等数据，默认存储在容器的本地目录中。如果你没有将这些目录映射到主机（即没有做“持久化存储”），一旦升级或重建容器，所有数据都会消失，无法找回。因此，升级前务必确认已经将 n8n 的数据目录（如 ~/.n8n）做了持久化挂载。

如何实现持久化存储？

如果你按照本教程的方法进行部署，那意味着你已经完成了持久化存储，也就是你可以在宿主机里看到你 n8n 运行时产生的各种数据。

如果你是自己使用 Docker 命令行部署的 n8n，那么请确认你在部署时使用了类似如下的 -v 参数将 n8n 的数据目录映射到了宿主机：

这样，无论容器如何重启或升级，主机上的 ~/.n8n 目录都会保存你的所有数据。请务必在升级前检查该目录是否已挂载，并定期做好备份。

如果，你在最初部署的时候，没有进行持久化存储，你需要先将数据备份出来再升级，否则你的所有数据都会消失。具体的方法是：

1.备份容器内数据：使用 Docker 的 cp 命令将容器内的数据复制到宿主机：

这将把容器内的 /home/node/.n8n 目录复制到宿主机当前目录下的 n8n-backup 文件夹中。

2.检查备份是否完整：

确认备份中包含 .n8n 目录下的所有重要文件，如 database.sqlite、workflows 等文件夹。

3.升级后恢复数据：在新容器启动时，使用 -v 参数将备份的数据挂载到容器中：

这种方法适用于初次部署时没有做持久化存储的情况。完成备份后，你就可以安全地升级 n8n，并将备份的数据恢复到新容器中。

如果你使用本教程的方法进行部署，那么你的升级是真正的“一键”。

你只需要在 1Panel 中选择【容器】，找到 n8n 对应的容器，在操作一列中选择【更多】>【升级】，在弹出的界面中勾选【强制拉取镜像】，然后点击确认即可：

如果你使用的是 docker 命令行部署的 n8n，可以准许以下流程进行升级：

如此操作即可实现 n8n 的“无缝一键升级”，所有数据和配置都不会丢失。如果你用的是 Docker Compose，同样只需更新 image 字段并执行 docker-compose pull && docker-compose up -d 即可完成升级。

升级 n8n 时，很多人会疑惑：为什么我拉取了最新版（latest），但官网却有更高版本（如 next）？这涉及到 n8n 镜像的版本语义控制。

因此，正常升级建议使用 latest，保证稳定性。如果你希望体验最新功能，可以指定 next 标签：

但需注意，next 版本可能会有变动或不兼容风险。生产环境建议始终使用 latest，这样即使不是“绝对最新版”，也能确保安全可靠。

关于 n8n 的版本更新，可以查看这里。

升级 n8n 的正确姿势，首要是做好数据目录的持久化存储，避免因升级导致数据丢失。其次，利用 Docker 的一键命令可以轻松拉取和部署新版。最后，理解 n8n 的版本标签含义，根据实际需求选择合适的版本进行升级。掌握这三点，你就能安全、稳定地享受 n8n 持续带来的新功能和优化体验。