用途
n8n-impl-deployment 用于在将 n8n v1.x 部署到生产环境,或配置 Docker、队列模式(queue mode)时提供操作参考。其核心目标是避免因缺少卷挂载或数据库配置错误而造成数据丢失。
主要能力
- Docker 部署参考:提供基础 Docker 运行命令,以及接入 PostgreSQL 的 Docker 运行命令。
- 配置方式说明:以环境变量为主要配置手段,支持在 Compose 中通过 environment 设置,也支持使用 _FILE 后缀从文件加载密钥(如 Docker Secrets、Kubernetes Secrets)。
- 卷挂载指引:说明 n8n_data 挂载到 /home/node/.n8n(SQLite 数据库、加密密钥、设置),./local-files 挂载到 /files 供工作流访问文件,traefik_data 挂载到 /letsencrypt 存放 TLS 证书。
- 队列模式架构:给出主实例、Webhook 处理器、Redis(BullMQ)、多个 Worker 与 PostgreSQL 的分层架构,并列出队列模式要求:PostgreSQL 13+、Redis、S3 兼容存储、所有实例版本一致、N8N_ENCRYPTION_KEY 一致、多主实例需会话持久化负载均衡。
- CLI 命令参考:涵盖工作流执行与启停、工作流与凭据导出导入、安全审计(n8n audit)、许可证信息、用户管理重置、MFA 禁用等命令。
- 备份策略:给出三种策略——CLI 导出(小型实例)、数据库转储(生产环境 pg_dump)、卷备份(仅 SQLite),并列出必须备份的关键项:工作流定义、凭据、N8N_ENCRYPTION_KEY、数据库、二进制数据。
- 决策树:根据是否需要队列模式或多实例、预期工作流规模,指导选择数据库类型与部署模式(单容器、Docker Compose、队列模式、多主高可用)。
- 生产检查清单:列出 PostgreSQL、加密密钥、NODE_ENV=production、HTTPS、WEBHOOK_URL、执行数据修剪、自动化备份等检查项。
使用方式
资料以参考文档形式提供操作命令与配置示例,包括 Docker 运行命令、Worker 与 Webhook 处理器启动命令、CLI 导出导入命令和备份命令。附带的参考文件包括:references/methods.md(100 多个环境变量分类参考)、references/examples.md(生产 Compose 配置、队列模式、CLI 脚本、备份自动化)、references/anti-patterns.md(部署错误、安全配置错误、扩展陷阱)。具体使用步骤需结合实际环境执行。
适用场景
适合将 n8n 工作流自动化平台部署到生产环境的团队,尤其是需要 Docker 化部署、队列模式扩展、多实例运行、定期备份与安全审计的场景。
限制
资料未提供具体的收费、价格、平台兼容性细节或效果保证;部分内容(如许可证、MFA、用户管理命令)仅列出命令,未展开说明。实际部署效果取决于环境配置与运维实践。