n8n 中文文档

支持的数据库

默认情况下,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=postgresdb
  • DB_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 工作流库 找现成的中文工作流。