使用 Docker 安装
警告
此内容已过时。 建议的安装方法请参阅使用 Docker Compose 安装。
Docker 安装
n8n 建议大多数自托管场景使用 Docker{:target=_blank .external-link}。Docker 提供干净、隔离的环境,可避免操作系统和工具不兼容,并简化数据库和环境管理。
您也可以在 Docker 中使用 Docker Compose 运行 n8n。您可以在 n8n-hosting 存储库 中找到适用于各种架构的 Docker Compose 配置。
提示
Self-hosting knowledge prerequisites 自托管知识先决条件
自托管 n8n 需要技术知识,包括:
- 设置和配置服务器和容器
- 管理应用程序资源和扩展
- 保护服务器和应用程序
- 配置 n8n
n8n 建议专家用户使用自托管。错误可能会导致数据丢失、安全问题和停机。如果您没有管理服务器的经验,n8n 推荐 n8n Cloud。
您也可以观看此视频指南:
https://www.youtube.com/embed/6ET3G7GiqZA?si=mwCKbtyLqNCRc2pa
先决条件
继续之前,请安装 Docker:
- Docker Desktop{:target=_blank .external-link} 适用于 Mac、Windows 和 Linux,并包含 Docker Engine 和 Docker Compose。
- Docker Engine{:target=_blank .external-link} 和 Docker Compose{:target=_blank .external-link} 也可作为 Linux 的独立软件包使用。没有图形界面,或不想使用 Docker Desktop UI 的 Linux 机器可选择此方式。
提示
稳定版和测试版
n8n 每周都会发布新的次要版本。 stable 版本用于生产用途。 beta 是最新版本。 beta版本可能不稳定。要报告问题,请使用 论坛。
当前 stable:2.47.7
当前 beta:2.48.4
启动 n8n
在终端运行以下命令,并将 <YOUR_TIMEZONE> 占位符替换为您的时区{:target=_blank .external-link}:
docker volume create n8n_data
docker run -it --rm \
--name n8n \
-p 5678:5678 \
-e GENERIC_TIMEZONE="<YOUR_TIMEZONE>" \
-e TZ="<YOUR_TIMEZONE>" \
-e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
-v n8n_data:/home/node/.n8n \
n8nio/n8n
此命令会创建用于存储持久数据的卷,下载所需的 n8n 镜像,并使用以下设置启动容器:
- 映射并公开主机上的端口
5678。 - 设置容器的时区:
TZ环境变量设置系统时区来控制date等脚本和命令返回的内容。GENERIC_TIMEZONE环境变量 为面向计划的节点(如 Schedule Trigger 节点)设置正确的时区。- 强制 n8n 配置文件的安全文件权限。
- 将
n8n_data卷装载到/home/node/.n8n目录,以便在容器重新启动后保留数据。
警告
功能可用性
n8n 2.0 中已弃用 N8N_RUNNERS_ENABLED。您不再需要设置它。 n8n 1.x 中仍然支持它,您必须将其设置为 true 才能启用任务运行程序。
启动后,打开 http://localhost:5678 即可访问 n8n。
与 PostgreSQL 一起使用
n8n 默认使用 SQLite 保存凭据[^1]、过去的执行记录和工作流。n8n 也支持 PostgreSQL,可按下文所述使用环境变量进行配置。
提示
Persisting the .n8n directory still recommended 仍建议持久化 .n8n 目录
使用 PostgreSQL 时,n8n 不需要 .n8n 目录中的 SQLite 数据库文件。不过,该目录仍包含加密密钥、实例日志和源代码控制功能资产等重要数据。虽然可以通过设置 N8N_ENCRYPTION_KEY 环境变量 等方式绕过部分要求,但最好继续为该目录挂载持久卷,以避免潜在问题。
要将 n8n 与 PostgreSQL 一起使用,请执行以下命令,并将尖括号中的占位符(例如 <POSTGRES_USER>)替换为实际值:
docker volume create n8n_data
docker run -it --rm \
--name n8n \
-p 5678:5678 \
-e GENERIC_TIMEZONE="<YOUR_TIMEZONE>" \
-e TZ="<YOUR_TIMEZONE>" \
-e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
-e DB_TYPE=postgresdb \
-e DB_POSTGRESDB_DATABASE=<POSTGRES_DATABASE> \
-e DB_POSTGRESDB_HOST=<POSTGRES_HOST> \
-e DB_POSTGRESDB_PORT=<POSTGRES_PORT> \
-e DB_POSTGRESDB_USER=<POSTGRES_USER> \
-e DB_POSTGRESDB_SCHEMA=<POSTGRES_SCHEMA> \
-e DB_POSTGRESDB_PASSWORD=<POSTGRES_PASSWORD> \
-v n8n_data:/home/node/.n8n \
n8nio/n8n
您可以在 n8n hosting 存储库{:target=_blank .external-link} 中找到完整的 PostgreSQL docker-compose 文件。
更新
要更新 n8n,请在 Docker Desktop 中打开 Images 选项卡,从上下文菜单选择 Pull,下载最新的 n8n 镜像:

您也可以使用命令行来拉取最新版本或特定版本:
# Pull latest (stable) version <a href="#pull-latest-stable-version" id="pull-latest-stable-version"></a>
docker pull n8nio/n8n
# Pull specific version <a href="#pull-specific-version" id="pull-specific-version"></a>
docker pull n8nio/n8n:1.81.0
# Pull next (unstable) version <a href="#pull-next-unstable-version" id="pull-next-unstable-version"></a>
docker pull n8nio/n8n:next
拉取更新的镜像后,停止并重新启动 n8n 容器。也可以使用命令行:将下列命令中的 <container_id> 替换为第一个命令找到的容器 ID。
# Find your container ID <a href="#find-your-container-id" id="find-your-container-id"></a>
docker ps -a
# Stop the container with the `<container_id>` <a href="#stop-the-container-with-the-lesscontaineridgreater" id="stop-the-container-with-the-lesscontaineridgreater"></a>
docker stop <container_id>
# Remove the container with the `<container_id>` <a href="#remove-the-container-with-the-lesscontaineridgreater" id="remove-the-container-with-the-lesscontaineridgreater"></a>
docker rm <container_id>
# Start the container <a href="#start-the-container" id="start-the-container"></a>
docker run --name=<container_name> [options] -d n8nio/n8n
更新 Docker Compose
如果您使用 Docker Compose 文件运行 n8n,请按照以下步骤更新 n8n:
# Navigate to the directory containing your docker compose file <a href="#navigate-to-the-directory-containing-your-docker-compose-file" id="navigate-to-the-directory-containing-your-docker-compose-file"></a>
cd </path/to/your/compose/file/directory>
# Pull latest version <a href="#pull-latest-version" id="pull-latest-version"></a>
docker compose pull
# Stop and remove older version <a href="#stop-and-remove-older-version" id="stop-and-remove-older-version"></a>
docker compose down
# Start the container <a href="#start-the-container" id="start-the-container"></a>
docker compose up -d
n8n 带隧道
危险
使用它进行本地开发和测试。在生产中使用它并不安全。
警告
Development tooling 开发工具
隧道功能是本地开发的便捷工具。n8n 版本之间的底层实现可能会发生变化。
观看一个使用 Cloudflare 或 ngrok 设置隧道的视频指南:
https://www.youtube.com/embed/O9dpO81dEQ0
要使用 GitHub 等外部服务的触发器节点的 webhook,n8n 必须可以从网络访问。n8n 使用 cloudflared 提供隧道服务,将网络请求重定向到你本地的 n8n 实例。隧道功能需要安装 Docker。
根据你运行 n8n 的方式,有两种使用隧道的方法:
Full stack 全栈
在容器中同时运行 n8n 和 cloudflared。启动时会打印隧道 URL,并自动完成所有配置:
pnpm stack --tunnel
Services only 仅服务
如果您希望通过 pnpm dev 或 pnpm start 在本地运行 n8n,可以将 cloudflared 作为独立服务启动:
# Terminal 1: Start the cloudflared tunnel service <a href="#terminal-1-start-the-cloudflared-tunnel-service" id="terminal-1-start-the-cloudflared-tunnel-service"></a>
pnpm --filter n8n-containers services --services cloudflared
# Terminal 2: Start n8n locally <a href="#terminal-2-start-n8n-locally" id="terminal-2-start-n8n-locally"></a>
pnpm dev
services 命令会:
- 启动 cloudflared,并将其指向
host.docker.internal:5678(本地 n8n)。 - 从 cloudflared 的指标端点获取公共隧道 URL。
- 将包含
WEBHOOK_URL和N8N_PROXY_HOPS=1的.env文件写入packages/cli/bin/.env。 pnpm dev和pnpm start使用 dotenv 自动加载该.env文件。
完成后清理:
pnpm --filter n8n-containers services:clean
后续步骤
-
在 Docker 镜像 的 README 中了解更多 Docker 设置。
- 或继续探索如何使用 n8n:试试 Quickstarts 快速入门。
[^1]:在 n8n 中,凭据存储用于连接特定应用和服务的身份验证信息。创建包含用户名和密码、API key、OAuth secret 等身份验证信息的凭据后,您可以使用关联的应用节点与服务交互。