使用 Docker 本地部署 n8n

type

status

date

slug

summary

Docker 安装优势

在干净的环境中安装 n8n。

更易于配置你偏好的数据库。

避免不同操作系统导致的问题，Docker 提供统一环境。

避免工具和系统间的兼容性问题。

更便于迁移到新主机或新环境。

你也可以通过 Docker Compose 使用 n8n，不同架构下的配置文件可在 n8n-hosting 仓库中找到。

本地部署前的知识要求

自托管部署 n8n 需要一定的技术知识，包括：

配置服务器和容器

管理应用资源与扩展

保障服务器与应用安全

配置 n8n

⚠️ n8n 推荐具有经验的用户自托管。如果你没有管理服务器的经验，建议使用 n8n Cloud。

前提条件

请先安装 Docker Desktop。

Linux 用户提示

Docker Desktop 仅适用于 Mac 和 Windows。Linux 用户需手动为对应发行版安装 Docker Engine 与 Docker Compose。

n8n 版本说明

n8n 每周发布一次小版本。

latest：适用于生产环境

next：最新 beta 版本，可能不稳定

当前版本：

latest：1.91.3

next：1.92.2

启动 n8n

创建数据卷 n8n_data 用于本地持久化数据。

镜像通过端口 5678 暴露容器。

访问地址：http://localhost:5678

使用 PostgreSQL

n8n 默认使用 SQLite 存储数据，也支持 PostgreSQL，通过环境变量进行配置。

即使使用 PostgreSQL，也 强烈建议保留 /home/node/.n8n 目录，用于保存用户数据及加密密钥（对凭据解密非常关键）。

如果启动时找不到该目录，n8n 会自动创建一个新的目录，此时原有凭据将无法使用。

❗你也可以通过 N8N_ENCRYPTION_KEY 环境变量显式提供加密密钥，无需挂载本地目录。

使用 PostgreSQL 示例：

可在 n8n-hosting 仓库中找到完整的 PostgreSQL Docker Compose 示例。

设置时区

你可以通过设置环境变量定义 n8n 使用的时区。

GENERIC_TIMEZONE：n8n 节点（如定时触发器）使用的时区

TZ：系统时区，用于 shell 命令等

更新 n8n

方法一：通过 Docker Desktop

在 "Images" 页签点击 "Pull" 拉取最新版本。

方法二：通过命令行

更新后重启容器：

更新 Docker Compose

如果你使用 docker-compose.yml 文件部署，按以下步骤更新：

使用 tunnel 进行外部服务测试

⚠️ 仅适用于本地开发和测试，请勿用于生产环境。

n8n 提供 tunnel 服务，用于接收外部服务（如 GitHub）的 webhook 请求。

延伸阅读

更多 Docker 安装说明请参阅：n8n Docker 镜像 README