1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

---|---
该命令会创建一个用于存储持久化数据的卷，下载所需的 n8n 镜像，并使用以下配置启动容器：
  * 映射并暴露主机上的端口 `5678`。
  * 设置容器的时区：
    * `TZ` 环境变量设置系统时区，以控制 `date` 等脚本和命令返回的时间。
    * `GENERIC_TIMEZONE` 环境变量 为面向调度的节点（如 Schedule Trigger 节点）设置正确的时区。
  * 强制执行安全的文件权限，保护 n8n 配置文件。
  * 启用 任务运行器（task runners），这是在 n8n 中执行任务的推荐方式。
  * 将 `n8n_data` 卷挂载到 `/home/node/.n8n` 目录，以便在容器重启后保留您的数据。

启动后，您可以通过访问以下地址使用 n8n：<http://localhost:5678>
## 与 PostgreSQL 一起使用#
默认情况下，n8n 使用 SQLite 来保存凭证（credentials）、历史执行记录和工作流。n8n 也支持 PostgreSQL，可通过环境变量进行配置，如下所述。

**仍建议持久化 `.n8n` 目录**
使用 PostgreSQL 时，n8n 不再需要使用 `.n8n` 目录中的 SQLite 数据库文件。但该目录仍包含其他重要数据，例如加密密钥、实例日志以及源代码管理功能的相关资源。虽然您可以绕过其中部分需求（例如通过设置 `N8N_ENCRYPTION_KEY` 环境变量），但为了防止潜在问题，最佳做法仍是继续为该目录映射一个持久化卷。

要将 n8n 与 PostgreSQL 一起使用，请执行以下命令，并将占位符（用尖括号表示，例如 `<POSTGRES_USER>`）替换为实际值：

| ```
docker\
\
5678:5678\
GENERIC_TIMEZONE="<YOUR_TIMEZONE>"\
TZ="<YOUR_TIMEZONE>"\
N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true\
N8N_RUNNERS_ENABLED=true\
DB_TYPE=postgresdb\
DB_POSTGRESDB_DATABASE=<POSTGRES_DATABASE>\
DB_POSTGRESDB_HOST=<POSTGRES_HOST>\
DB_POSTGRESDB_PORT=<POSTGRES_PORT>\
DB_POSTGRESDB_USER=<POSTGRES_USER>\
DB_POSTGRESDB_SCHEMA=<POSTGRES_SCHEMA>\
DB_POSTGRESDB_PASSWORD=<POSTGRES_PASSWORD>\
\

1
2
3
4
5
6
7
8

---|---
拉取更新后的镜像后，停止你的 n8n 容器并重新启动。你也可以使用命令行操作。将以下命令中的 `<container_id>` 替换为第一条命令中查到的容器 ID：

| ```
# 查找你的容器 ID
docker# 停止具有 `<container_id>` 的容器
docker# 删除具有 `<container_id>` 的容器
docker# 启动容器
docker=<container_name>[options]

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

---|---
## 带隧道的 n8n#
警告
仅用于本地开发和测试。在生产环境中使用是不安全的。
为了使 GitHub 等外部服务的触发节点（trigger nodes）能够使用 webhook，n8n 必须可以从公网访问。n8n 内置了一个 隧道服务，可以将来自 n8n 服务器的请求转发到你的本地 n8n 实例。
通过运行以下命令并添加 `--tunnel` 参数来启动 n8n：

| ```
docker\
\
5678:5678\
GENERIC_TIMEZONE="<YOUR_TIMEZONE>"\
TZ="<YOUR_TIMEZONE>"\
N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true\
N8N_RUNNERS_ENABLED=true\
\
\