跳转至

配置#

您可以使用环境变量更改 n8n 的设置。有关可用配置的完整列表,请参阅环境变量

通过命令行设置环境变量#

npm#

对于 npm,请在终端中设置所需的环境变量。命令取决于您的命令行。

Bash 命令行:

1
export <variable>=<value>

在 cmd.exe 中:

1
set <variable>=<value>

在 PowerShell 中:

1
$env:<variable>=<value>

Docker#

在 Docker 中,您可以从命令行使用 -e 标志:

1
2
3
4
5
docker run -it --rm \
 --name n8n \
 -p 5678:5678 \
 -e N8N_TEMPLATES_ENABLED="false" \
 docker.n8n.io/n8nio/n8n

使用文件设置环境变量#

您也可以使用配置文件配置 n8n。

在配置文件中只定义需要与默认值不同的值。您可以使用多个文件。例如,您可以有一个包含通用基础设置的文件,以及包含不同环境特定值的文件。

npm#

使用环境变量 N8N_CONFIG_FILES 设置 JSON 配置文件的路径:

1
2
3
4
5
6
7
8
# Bash - Single file
export N8N_CONFIG_FILES=/<path-to-config>/my-config.json
# Bash - 多个文件用逗号分隔
export N8N_CONFIG_FILES=/<path-to-config>/my-config.json,/<path-to-config>/production.json

# PowerShell - Single file, persist for current user
# 注意:在 Unix 系统上设置范围(Process、User、Machine)不起作用
[Environment]::SetEnvironmentVariable('N8N_CONFIG_FILES', '<path-to-config>\config.json', 'User')

示例文件:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
{
 "executions": {
  "saveDataOnSuccess": "none"
 },
 "generic": {
  "timezone": "Europe/Berlin"
 },
 "nodes": {
  "exclude": "[\"n8n-nodes-base.executeCommand\",\"n8n-nodes-base.writeBinaryFile\"]"
 }
}

格式化为 JSON

您无法始终从环境变量参考中推导出正确的 JSON。例如,要将 N8N_METRICS 设置为 true,您需要:

1
2
3
4
5
6
7
{
	"endpoints": {
		"metrics": {
			"enable": true
		}
	}
}

有关预期设置的完整详细信息,请参阅源代码中的 Schema 文件

Docker#

在 Docker 中,您可以在 docker-compose.yaml 文件的 n8n: environment: 元素中设置环境变量。

例如:

1
2
3
n8n:
    environment:
      - N8N_TEMPLATES_ENABLED=false

将敏感数据保存在单独的文件中#

您可以在单个环境变量后面添加 _FILE 来在单独的文件中提供配置,从而避免使用环境变量传递敏感详细信息。n8n 从指定名称的文件中加载数据,使得从 Docker-SecretsKubernetes-Secrets 加载数据成为可能。

有关每个变量的详细信息,请参阅环境变量

虽然大多数环境变量都可以使用 _FILE 后缀,但对于敏感数据(如凭证和数据库配置)更有益。以下是一些示例:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
CREDENTIALS_OVERWRITE_DATA_FILE=/path/to/credentials_data
DB_TYPE_FILE=/path/to/db_type
DB_POSTGRESDB_DATABASE_FILE=/path/to/database_name
DB_POSTGRESDB_HOST_FILE=/path/to/database_host
DB_POSTGRESDB_PORT_FILE=/path/to/database_port
DB_POSTGRESDB_USER_FILE=/path/to/database_user
DB_POSTGRESDB_PASSWORD_FILE=/path/to/database_password
DB_POSTGRESDB_SCHEMA_FILE=/path/to/database_schema
DB_POSTGRESDB_SSL_CA_FILE=/path/to/ssl_ca
DB_POSTGRESDB_SSL_CERT_FILE=/path/to/ssl_cert
DB_POSTGRESDB_SSL_KEY_FILE=/path/to/ssl_key
DB_POSTGRESDB_SSL_REJECT_UNAUTHORIZED_FILE=/path/to/ssl_reject_unauth
此页面是否
💬 微信

🚀 与作者交流

关注公众号
n8n实战笔记公众号
n8n实战笔记
📚 教程 💡 案例 🔧 技巧
添加微信
添加作者微信
1对1 专业指导
⚡ 快答 🎯 定制 🚀 支持