如何以编程方式设置自托管n8n实例的所有者账户？

针对你用PostgreSQL自托管n8n的场景，以下是三种可自动化实现owner角色用户创建及API密钥生成的方案，解决官方文档仅提及SQL步骤但无自动化方法的问题：

方案1：PostgreSQL初始化脚本（直接操作数据库） #

利用你现有docker-compose中已挂载的./config/pg:/docker-entrypoint-initdb.d目录，编写初始化SQL脚本，在数据库启动时自动执行。

步骤： #

1. 在./config/pg下创建脚本文件01_init_n8n_user.sql
2. 写入以下SQL内容（替换占位符为你的实际信息）：

-- 确保n8n数据库存在
CREATE DATABASE IF NOT EXISTS n8n;
\c n8n;

-- 创建owner角色用户（密码需提前用bcrypt哈希）
INSERT INTO n8n_user (email, password, firstName, lastName, role)
VALUES (
    'admin@yourdomain.com',
    '$2a$10$abcdefghijklmnopqrstuv', -- 替换为bcrypt哈希后的密码
    'Admin',
    'Ops',
    'owner'
)
ON CONFLICT (email) DO NOTHING; -- 用户已存在时跳过

-- 生成永不过期的API密钥
INSERT INTO n8n_api_key (name, userId, token, expiresAt)
VALUES (
    'Deployment Pipeline Key',
    (SELECT id FROM n8n_user WHERE email = 'admin@yourdomain.com'),
    gen_random_uuid()::text, -- 自动生成随机token
    NULL
)
ON CONFLICT (name) DO NOTHING;

生成bcrypt哈希密码： #

用Node.js命令本地生成（n8n基于Node.js，确保环境已安装）：

node -e "console.log(require('bcrypt').hashSync('你的明文密码', 10))"

方案2：n8n CLI命令（版本兼容更可靠） #

直接调用n8n的CLI工具创建用户和API密钥，避免因n8n版本更新导致数据库表结构变化的问题。

修改docker-compose中n8n服务的配置：

n8n:
  image: docker.n8n.io/n8nio/n8n
  ports:
    - "5678:5678"
  environment:
    - DB_TYPE=postgresdb
    - DB_TABLE_PREFIX=n8n
    - DB_POSTGRESDB_DATABASE=n8n
    - DB_POSTGRESDB_HOST=db
    - DB_POSTGRESDB_PORT=5432
    - DB_POSTGRESDB_USER=postgres
    - DB_POSTGRESDB_PASSWORD=postgres
    - N8N_USER_EMAIL=admin@yourdomain.com
    - N8N_USER_PASSWORD=你的明文密码
  volumes:
    - ./DOCKER/n8n/data:/home/node/.n8n
    - ./DOCKER/n8n/files:/files
  command: >
    sh -c "
      # 等待PostgreSQL服务启动就绪
      until nc -z db 5432; do sleep 1; done;
      # 创建owner用户，已存在则跳过
      n8n user:create --email $N8N_USER_EMAIL --password $N8N_USER_PASSWORD --role owner || true;
      # 生成API密钥并保存到挂载目录的文件中，方便流水线读取
      n8n api-key:create --name 'Deployment Pipeline' --user $N8N_USER_EMAIL 2>&1 | grep 'API Key' > /home/node/.n8n/api-key.txt || true;
      # 启动n8n服务
      n8n start
    "

说明： #

• nc -z db 5432用于检测PostgreSQL是否就绪，避免n8n启动时数据库未就绪报错
• || true确保命令执行失败（如用户已存在）时不中断服务启动
• 生成的API密钥会保存到./DOCKER/n8n/data/api-key.txt文件中，可直接被部署流水线读取

方案3：环境变量自动初始化（最简方案） #

n8n支持通过环境变量自动创建初始owner用户，适合首次部署场景：

修改n8n服务的环境变量：

n8n:
  # ...其他配置不变
  environment:
    # ...原有数据库配置
    - N8N_USER_MANAGEMENT_DISABLED=false
    - N8N_USER_EMAIL=admin@yourdomain.com
    - N8N_USER_PASSWORD=你的明文密码

说明： #

• 当n8n启动检测到无用户时，会自动创建该owner用户
• 此方法无法自动生成API密钥，需后续通过CLI或UI手动生成，适合对自动化要求不高的场景

内容的提问来源于stack exchange，提问作者creyD