跳到主要内容

数据库环境变量#

基于文件的配置

您可以在个别变量后添加 _FILE 后缀，通过独立文件提供配置。详情请参阅在独立文件中保存敏感数据。

n8n 默认使用 SQLite 数据库，同时支持 PostgreSQL。n8n 在 v1.0 版本中已弃用对 MySQL 和 MariaDB 的支持。

本文档说明为自托管 n8n 实例配置数据库所需的环境变量。

变量名类型默认值描述
DB_TYPE /_FILE枚举字符串: sqlite, postgresdbsqlite使用的数据库类型
DB_TABLE_PREFIX*-数据表名前缀
DB_PING_INTERVAL_SECONDS数值2数据库连接存活检查的 ping 间隔（单位：秒）

PostgreSQL#​

变量名类型默认值描述
DB_POSTGRESDB_DATABASE /_FILE字符串n8nPostgreSQL 数据库名称
DB_POSTGRESDB_HOST /_FILE字符串localhostPostgreSQL 主机地址
DB_POSTGRESDB_PORT /_FILE数值5432PostgreSQL 端口号
DB_POSTGRESDB_USER /_FILE字符串postgresPostgreSQL 用户名
DB_POSTGRESDB_PASSWORD /_FILE字符串-PostgreSQL 密码
DB_POSTGRESDB_POOL_SIZE /_FILE数值2控制 n8n 可并行打开的 Postgres 连接数。增加该值可能提升资源利用率，但连接数过多可能导致性能下降
DB_POSTGRESDB_CONNECTION_TIMEOUT /_FILE数值20000Postgres 连接超时时间（毫秒）
DB_POSTGRESDB_IDLE_CONNECTION_TIMEOUT /_FILE数值30000空闲连接被回收前的存活时间
DB_POSTGRESDB_SCHEMA /_FILE字符串publicPostgreSQL 模式名
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是否拒绝未授权的 SSL 连接：true（拒绝）/false（不拒绝）

SQLite#​

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