如何升级 N8N 版本并完整还原工作流数据（新手不丢数据指南）
一、你最担心的不是升级，是“升级后东西还在不在”
当你已经用 n8n 跑了一段时间之后，
里面一定已经有了不少“值钱的东西”：
- 已经调通的工作流
- 账号、密钥、授权信息
- 历史执行记录
- 各种配置好的节点参数
这时候你再看到「有新版本可以升级」，
第一反应往往不是兴奋，而是担心：
升级了，我之前做的这些，会不会没了？
这个担心非常正常，
而且如果方法不对，确实是会出问题的。
这一篇，我们只解决一个核心问题：
👉 升级 n8n 版本，但工作流和数据一条都不丢。
二、先搞清楚一件事：升级到底在“升什么”
这里一定要先把概念理清楚，不然后面容易慌。
n8n 的升级，本质只有一件事：
👉 换一个“更新的软件版本”，
👉 而不是重做你的数据。
真正决定你数据在不在的，不是版本，
而是——数据文件夹有没有被保留下来。
只要你是按「本地部署 + Docker + 本地映射目录」的方式装的，
那升级这件事，本身是非常安全的。
三、什么时候该升级？新手的建议频率
你在 n8n 左下角，通常能看到类似这样的提示：
- 当前版本：1.xx.x
- 最新稳定版：1.xx.x
建议频率：
- 不用天天升
- 大概 1 个月左右升级一次 就够了
原因很简单：
- 版本差太多，可能有功能或节点不兼容
- 但频繁升级，对新手来说也没必要
四、正式升级前，你只需要确认一件事
在升级之前，你只要确认下面这一点：
👉 你之前部署时，数据是映射到本地文件夹的
也就是你电脑里，有类似这样的目录：
n8n（运行数据、数据库）n8n-data（文件、素材、输出内容）
只要这两个文件夹还在，
升级就等于“换软件，不动数据”。
五、升级实操：一步一步来（Docker 方式）
下面这套流程，你以后每次升级都可以照着来。
第一步：找到你要升级的版本
- 打开 n8n 在 Docker Hub 的页面
- 往下找到 Tags（版本列表）
- 你会看到：
- 稳定版（推荐）
- 测试版 / Beta 版（不建议新手用）
👉 日常使用，选稳定版就好。
第二步：先拉取新版本镜像
打开终端（PowerShell / 终端），
执行拉取镜像的命令。
你只需要改一件事：
- 把最后的版本号，换成你想升级到的版本
这一步做的事情是：
👉 只是把新版本“下载到本地”，还没动你现在在跑的 n8n。
第三步：停止正在运行的旧容器
确认你当前的 n8n 正在运行后：
- 用命令把它 停止
这一步的作用是：
👉 确保升级过程中，不会有进程在占用。
第四步：移除旧容器（不是删数据）
接下来这一步，很多新手会害怕，但其实很安全：
- 移除旧的 n8n 容器
注意：
👉 这里只是移除“容器”，不是删数据文件夹。
你的工作流、账号、执行记录，
都还在本地映射的文件夹里。
第五步：用新版本重新启动 n8n
接下来，执行和你第一次安装时几乎一模一样的启动命令：
- 容器名：n8n
- 端口：5678
- 时区：和之前一致
- 数据目录：映射到原来的
n8n/n8n-data文件夹 - 镜像版本：换成刚刚拉取的新版本
回车之后，Docker 会启动一个新的 n8n。
第六步：打开浏览器检查结果
访问：
http://localhost:5678
你应该看到：
- 熟悉的登录界面
- 原来的账号还能登录
- 所有工作流都还在
- 左下角版本号已经变成新版本
如果是这样，
👉 升级完成，而且数据完整无损。
六、升级完成后，顺手做一件“小清理”
升级完成后，你的 Docker 里通常会多出一些：
- 旧版本的镜像
- 已经不用的版本文件
你可以：
- 删除不用的旧镜像
- 节省几百 MB 的磁盘空间
这个不是必须，但长期用下来很有价值。
七、新手最容易误解的几个点
误解一：升级=重装=数据没了
👉 错，只要数据目录映射正确，升级很安全。
误解二：看到 Docker rm 就慌
👉 删的是容器，不是你的工作流数据。
误解三：一定要用最新 Beta 版
👉 日常生产，稳定版更靠谱。
八、结尾：能安全升级，说明你已经走在“正确的路”上
如果你能顺利完成一次升级，
其实说明一件很重要的事：
👉 你的 n8n 部署方式，是可长期使用的。
你现在解决的，
不只是“升级一次软件”，
而是建立了一种：
- 数据可控
- 流程可复用
- 系统可持续维护
的自动化基础。
后面不管你跑多少工作流、
做多少自动化场景，
都不用再担心“一升级就重来”。
下一步，你要做的，
是继续把更多重复工作，
放心地交给这个已经稳定运行的 n8n。
