支持的数据库
默认情况下,n8n 使用 SQLite 保存凭据、历史执行记录和工作流。n8n 还支持 PostgresDB。有关 n8n 的 PostgreSQL 版本政策,请参阅支持的 PostgreSQL 版本。
数据库类型按 n8n 安装
使用的数据库类型根据您的 n8n 安装而有所不同:
自托管 n8n
默认情况下,自托管安装使用 SQLite。您可以通过设置相应的环境变量来配置 PostgreSQL(请参阅PostgresDB 配置)。
n8n Cloud
n8n Cloud 根据您的计划层级使用不同的数据库:
- SQLite:入门版、专业版和旧版企业版计划
- PostgreSQL:仅限企业扩展计划
共享设置
所有数据库都会使用以下环境变量:
DB_TABLE_PREFIX(默认值:-)- 表名前缀
PostgresDB
支持的 PostgreSQL 版本
n8n 支持:
- 最新的两个积极维护的 PostgreSQL 主版本(截至 2026 年 7 月为 17 和 18)。
- 另一个用于兼容的主版本(16)。
请在所用主版本中运行最新的次要版本。
Amazon Aurora PostgreSQL 是实验性功能。n8n 的托管模板在高可用性设置中提供此选项;当主数据库停机时,Aurora 的恢复速度更快。n8n 不会测试或认证 Aurora,n8n 的 PostgreSQL 版本支持也不适用于 Aurora。除非确实需要 Aurora 提供的功能,否则请使用上游 PostgreSQL。
n8n 不支持其他 PostgreSQL 兼容的衍生产品,例如 AlloyDB、CockroachDB 或 YugabyteDB。
PostgreSQL 项目每年 11 月会停止维护最旧的主版本并发布一个新的主版本,因此 n8n 支持的版本范围也会逐年调整。请在此页面查看当前支持的版本,不要依赖在其他位置看到的某个具体版本号。
要使用 PostgresDB 作为数据库,您可以提供以下环境变量:
DB_TYPE=postgresdbDB_POSTGRESDB_DATABASE(默认值:'n8n')DB_POSTGRESDB_HOST(默认值:'localhost')DB_POSTGRESDB_PORT(默认值:5432)DB_POSTGRESDB_USER(默认值:'postgres')DB_POSTGRESDB_PASSWORD(默认值:空)DB_POSTGRESDB_SCHEMA(默认值:'public')DB_POSTGRESDB_SSL_CA(默认值:undefined):用于验证连接的服务器 CA 证书路径(不支持机会加密)DB_POSTGRESDB_SSL_CERT(默认值:未定义):客户端 TLS 证书的路径DB_POSTGRESDB_SSL_KEY(默认值:undefined):与证书对应的客户端私钥路径DB_POSTGRESDB_SSL_REJECT_UNAUTHORIZED(默认值:true):如果验证失败的 TLS 连接应被拒绝
export DB_TYPE=postgresdb
export DB_POSTGRESDB_DATABASE=n8n
export DB_POSTGRESDB_HOST=postgresdb
export DB_POSTGRESDB_PORT=5432
export DB_POSTGRESDB_USER=n8n
export DB_POSTGRESDB_PASSWORD=n8n
export DB_POSTGRESDB_SCHEMA=n8n
# optional: <a href="#optional" id="optional"></a>
export DB_POSTGRESDB_SSL_CA_FILE=$(pwd)/ca.crt
export DB_POSTGRESDB_SSL_REJECT_UNAUTHORIZED=false
n8n start
所需权限
n8n 需要创建并修改其使用的表结构(schema)。
推荐权限:
CREATE DATABASE n8n-db;
CREATE USER n8n-user WITH PASSWORD 'random-password';
GRANT ALL PRIVILEGES ON DATABASE n8n-db TO n8n-user;
TLS
您可以在以下配置之间进行选择:
- 不声明(默认):使用
SSL=off连接。 - 仅声明 CA 与未授权标志:使用
SSL=on连接,并验证服务器签名。 - 声明
_{CERT,KEY}并结合上述设置:使用证书和密钥进行客户端 TLS 身份验证。
SQLite
如果未定义任何内容,则这是使用的默认数据库。
数据库文件位于:
~/.n8n/database.sqlite
相关资源
不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。