Skip to content

Docker 安装#

n8n建议使用Docker来满足大多数自托管需求。它提供了一个干净、隔离的环境，避免了操作系统和工具的不兼容性，并使数据库和环境管理更简单。

您也可以使用Docker Compose在Docker中使用n8n。您可以在n8n-hosting仓库中找到各种架构的Docker Compose配置。

自托管知识先决条件

自托管 n8n 需要技术知识，包括：

  • 设置和配置服务器和容器
  • 管理应用程序资源和扩展
  • 保护服务器和应用程序
  • 配置 n8n

n8n 建议专业用户进行自托管。错误可能导致数据丢失、安全问题和停机。如果您在管理服务器方面缺乏经验，n8n 建议使用 n8n Cloud。

先决条件#

在继续之前，请安装Docker：

  • Docker Desktop适用于Mac、Windows和Linux。Docker Desktop包括Docker Engine和Docker Compose。
  • Docker Engine和Docker Compose也可作为Linux的单独包使用。对于没有图形环境的Linux机器或当您不想要Docker Desktop UI时使用此选项。

Latest 和 Next 版本

n8n 每周发布一个新的次要版本。latest 版本用于生产环境。next 是最新的发布版本。您应该将 next 视为测试版：它可能不稳定。要报告问题，请使用论坛。

Current latest: 1.112.4
Current next: 1.113.1

启动 n8n#

从您的终端运行以下命令，将<YOUR_TIMEZONE>占位符替换为您的时区：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
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 N8N_RUNNERS_ENABLED=true \
 -v n8n_data:/home/node/.n8n \
 docker.n8n.io/n8nio/n8n

此命令创建一个卷来存储持久数据，下载所需的n8n镜像，并使用以下设置启动容器：

  • 映射并暴露主机上的端口5678。
  • 为容器设置时区：
  • 强制执行n8n配置文件的安全文件权限。
  • 启用任务运行器，这是在n8n中执行任务的推荐方式。
  • 将n8n_data卷挂载到/home/node/.n8n目录，以便在容器重启时保持数据持久性。

运行后，您可以通过打开以下地址访问 n8n： http://localhost:5678

与 PostgreSQL 一起使用#

默认情况下，n8n使用SQLite来保存凭据、过去的执行和工作流。n8n也支持PostgreSQL，可以使用下面详述的环境变量进行配置。

仍然建议持久化.n8n目录

使用PostgreSQL时，n8n不需要使用.n8n目录来存储SQLite数据库文件。但是，该目录仍然包含其他重要数据，如加密密钥、实例日志和源代码控制功能资产。虽然您可以绕过其中一些要求（例如，通过设置N8N_ENCRYPTION_KEY环境变量），但最好继续为该目录映射持久卷以避免潜在问题。

要将n8n与PostgreSQL一起使用，请执行以下命令，将占位符（在尖括号内描述，例如<POSTGRES_USER>）替换为您的实际值：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
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 N8N_RUNNERS_ENABLED=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 \
 docker.n8n.io/n8nio/n8n

您可以在n8n托管仓库中找到PostgreSQL的完整docker-compose文件。

更新#

要更新n8n，在Docker Desktop中，导航到Images 镜像选项卡，并从上下文菜单中选择Pull 拉取来下载最新的n8n镜像：

Docker Desktop

您也可以使用命令行来拉取最新版本或特定版本：

1
2
3
4
5
6
7
8
# 拉取最新（稳定）版本
docker pull docker.n8n.io/n8nio/n8n

# 拉取特定版本
docker pull docker.n8n.io/n8nio/n8n:1.81.0

# 拉取next（不稳定）版本
docker pull docker.n8n.io/n8nio/n8n:next

拉取更新的镜像后，停止您的n8n容器并重新启动它。您也可以使用命令行。将下面命令中的<container_id>替换为您在第一个命令中找到的容器ID：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
# 查找您的容器ID
docker ps -a

# 使用`<container_id>`停止容器
docker stop <container_id>

# 使用`<container_id>`删除容器
docker rm <container_id>

# 启动容器
docker run --name=<container_name> [options] -d docker.n8n.io/n8nio/n8n

更新 Docker Compose#

如果您使用 Docker Compose 文件运行 n8n，请按照以下步骤更新 n8n：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
# 导航到包含您的 docker compose 文件的目录
cd </path/to/your/compose/file/directory>

# 拉取最新版本
docker compose pull

# 停止并移除旧版本
docker compose down

# 启动容器
docker compose up -d

使用隧道的 n8n#

Danger

仅用于本地开发和测试。在生产环境中使用不安全。

要为 GitHub 等外部服务的触发器节点使用 webhook，n8n 必须能够从网络访问。n8n 运行一个隧道服务，可以将请求从 n8n 的服务器重定向到您的本地 n8n 实例。

通过运行以下命令使用--tunnel启动n8n：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
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 N8N_RUNNERS_ENABLED=true \
 -v n8n_data:/home/node/.n8n \
 docker.n8n.io/n8nio/n8n \
 start --tunnel

后续步骤#