数据库环境变量

/// 注意 | 基于文件的配置 您可以在个别变量后添加 _FILE 后缀，通过单独的文件提供配置。详情请参阅将敏感数据保存在单独文件中。 ///

默认情况下，n8n 使用 SQLite。n8n 也支持 PostgreSQL。在 v1.0 版本中，n8n 移除了对 MySQL 和 MariaDB 的支持。

本页概述了为自托管 n8n 实例配置所选数据库的环境变量。

变量	类型	默认值	描述
DB_TYPE /_FILE	枚举字符串: sqlite, postgresdb	sqlite	要使用的数据库类型。
DB_TABLE_PREFIX	*	-	表名前使用的前缀。
DB_PING_INTERVAL_SECONDS	数字	2	向数据库发送 ping 以检查连接是否存活的间隔时间（秒）。

PostgreSQL

变量	类型	默认值	描述
DB_POSTGRESDB_DATABASE /_FILE	字符串	n8n	PostgreSQL 数据库名称。
DB_POSTGRESDB_HOST /_FILE	字符串	localhost	PostgreSQL 主机地址。
DB_POSTGRESDB_PORT /_FILE	数字	5432	PostgreSQL 端口号。
DB_POSTGRESDB_USER /_FILE	字符串	postgres	PostgreSQL 用户名。
DB_POSTGRESDB_PASSWORD /_FILE	字符串	-	PostgreSQL 密码。
DB_POSTGRESDB_POOL_SIZE /_FILE	数字	2	控制 n8n 应保持的并行 PostgreSQL 连接数。增加此值可能有助于提高资源利用率，但过多的连接可能会降低性能。
DB_POSTGRESDB_CONNECTION_TIMEOUT /_FILE	数字	20000	PostgreSQL 连接超时时间（毫秒）。
DB_POSTGRESDB_IDLE_CONNECTION_TIMEOUT /_FILE	数字	30000	空闲连接被回收前的空闲时间。
DB_POSTGRESDB_SCHEMA /_FILE	字符串	public	PostgreSQL 模式名称。
DB_POSTGRESDB_SSL_ENABLED /_FILE	布尔值	false	是否启用 SSL。如果定义了 DB_POSTGRESDB_SSL_CA、DB_POSTGRESDB_SSL_CERT 或 DB_POSTGRESDB_SSL_KEY 则会自动启用。
DB_POSTGRESDB_SSL_CA /_FILE	字符串	-	PostgreSQL SSL 证书颁发机构。
DB_POSTGRESDB_SSL_CERT /_FILE	字符串	-	PostgreSQL SSL 证书。
DB_POSTGRESDB_SSL_KEY /_FILE	字符串	-	PostgreSQL SSL 密钥。
DB_POSTGRESDB_SSL_REJECT_UNAUTHORIZED /_FILE	布尔值	true	控制 n8n 是否应拒绝未经授权的 SSL 连接（true 为拒绝，false 为不拒绝）。

SQLite

变量名	类型	默认值	描述
DB_SQLITE_POOL_SIZE	数值	0	控制是否以 WAL 模式 或 回滚日志模式 打开 SQLite 文件。设为 0 时使用回滚日志模式。大于 0 时使用 WAL 模式，该值决定配置的并行 SQL 读取连接数。WAL 模式比回滚日志模式性能更高且更可靠。
DB_SQLITE_VACUUM_ON_STARTUP	布尔值	false	在启动时执行 VACUUM 操作来重建数据库。可减小文件大小并优化索引。这是一个长时间运行的阻塞操作，会增加启动时间。