数据库环境变量#
基于文件的配置
你可以为单个变量添加 _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 应保持的并行 Postgres 连接数。增加该值可能有助于资源利用，但过多连接可能导致性能下降。
DB_POSTGRESDB_CONNECTION_TIMEOUT
/_FILE | 数字 | 20000 | Postgres 连接超时时间（毫秒）。
DB_POSTGRESDB_IDLE_CONNECTION_TIMEOUT
/_FILE | 数字 | 30000 | 空闲连接在被回收前可保持空闲的时间长度。
DB_POSTGRESDB_SCHEMA
/_FILE | 字符串 | public | PostgreSQL 模式（schema）。
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 证书颁发机构（CA）证书。
DB_POSTGRESDB_SSL_CERT
/_FILE | 字符串 | - | PostgreSQL SSL 证书。
DB_POSTGRESDB_SSL_KEY
/_FILE | 字符串 | - | PostgreSQL SSL 私钥。
DB_POSTGRESDB_SSL_REJECT_UNAUTHORIZED
/_FILE | 布尔值 | true | 是否拒绝未经授权的 SSL 连接（true 表示拒绝，false 表示允许）。
SQLite#
| 变量 | 类型 | 默认值 | 说明 |
|---|---|---|---|
DB_SQLITE_POOL_SIZE | 数字 | 0 | 控制 SQLite 文件是以 WAL 模式 还是 回滚日志模式 打开。设置为 0 时使用回滚日志模式；大于 0 时启用 WAL 模式，并指定可配置的并行 SQL 读取连接数量。WAL 模式在性能和可靠性方面远优于回滚日志模式。 |
DB_SQLITE_VACUUM_ON_STARTUP | 布尔值 | false | 启动时运行 VACUUM 操作以重建数据库，减小文件大小并优化索引。这是一个耗时且阻塞的操作，会延长启动时间。 |