1. 为什么选择n8nDocker搭建自动化工作流如果你正在寻找一个既强大又灵活的工作流自动化工具n8n绝对值得一试。作为一个开源平台它完美结合了低代码可视化操作和专业级编程能力。我去年在帮一家电商公司搭建库存预警系统时就是用它把Shopify、Slack和内部ERP系统串联起来的整个过程比预想的简单得多。Docker化部署带来的好处更是不言而喻。记得第一次手动部署n8n时光是处理各种依赖就花了大半天。后来改用Docker从零到运行只用了不到10分钟。这种开箱即用的体验对于需要快速验证想法或者搭建临时自动化流程的场景特别友好。企业级场景下n8nDocker的组合优势更明显环境一致性开发、测试、生产环境完全一致再也不会出现在我机器上能跑的问题资源隔离每个工作流可以运行在独立的容器中避免相互干扰弹性扩展配合Kubernetes可以轻松实现横向扩展安全可控所有数据都在自己掌控中特别适合金融、医疗等敏感行业2. 部署前的环境准备2.1 Docker环境配置我强烈建议使用Linux系统进行部署特别是Ubuntu 20.04/22.04 LTS版本。最近在CentOS 7上遇到不少兼容性问题有些Docker特性需要较新的内核支持。下面是经过多次验证的安装脚本# 卸载旧版本 sudo apt-get remove docker docker-engine docker.io containerd runc # 安装依赖 sudo apt-get update sudo apt-get install -y \ apt-transport-https \ ca-certificates \ curl \ gnupg \ lsb-release # 添加Docker官方GPG密钥 curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg # 设置稳定版仓库 echo \ deb [archamd64 signed-by/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null # 安装Docker引擎 sudo apt-get update sudo apt-get install -y docker-ce docker-ce-cli containerd.io # 验证安装 sudo docker run hello-world安装完成后记得执行以下关键配置用户组设置把当前用户加入docker组避免每次都要sudosudo usermod -aG docker $USER newgrp docker镜像加速国内用户建议配置镜像加速源sudo mkdir -p /etc/docker sudo tee /etc/docker/daemon.json -EOF { registry-mirrors: [https://your-mirror.mirror.aliyuncs.com] } EOF sudo systemctl daemon-reload sudo systemctl restart docker2.2 硬件资源规划根据我的经验不同规模的工作流对资源需求差异很大小型工作流10个以内简单节点1核CPU/1GB内存足够中型工作流50个节点左右建议2核CPU/4GB内存复杂工作流含AI处理等至少4核CPU/8GB内存特别提醒如果计划使用PostgreSQL数据库需要额外预留存储空间初始10GB根据日志保留策略适当增加内存PostgreSQL容器至少分配2GB独立内存3. n8n镜像获取与配置3.1 镜像拉取策略官方镜像n8nio/n8n是最稳妥的选择但国内直接拉取可能会很慢。我测试过几种替代方案国内镜像源加速推荐docker pull registry.cn-hangzhou.aliyuncs.com/n8nio/n8n:latest docker tag registry.cn-hangzhou.aliyuncs.com/n8nio/n8n:latest n8nio/n8n:latest自建镜像缓存适合企业内网# 在能访问外网的机器上 docker pull n8nio/n8n:latest docker save -o n8n-latest.tar n8nio/n8n:latest # 在内网机器上 docker load -i n8n-latest.tar3.2 版本选择建议生产环境千万不要盲目使用latest标签我吃过这个亏。建议锁定具体版本docker pull n8nio/n8n:0.226.0版本选择原则稳定版末尾为偶数的版本如0.226.0尝鲜版末尾为奇数的版本如0.227.1长期支持版官方特别标注的LTS版本4. 生产级部署方案4.1 基础持久化部署这是我在中小型企业最常用的部署方式# 创建数据目录 mkdir -p /opt/n8n/{data,config,logs} # 设置权限重要 chown -R 1000:1000 /opt/n8n # 启动容器 docker run -d \ --name n8n-prod \ -p 5678:5678 \ -e N8N_BASIC_AUTH_ACTIVEtrue \ -e N8N_BASIC_AUTH_USERadmin \ -e N8N_BASIC_AUTH_PASSWORDyour-strong-password \ -e NODE_ENVproduction \ -e TZAsia/Shanghai \ -v /opt/n8n/data:/home/node/.n8n \ -v /opt/n8n/config:/config \ -v /opt/n8n/logs:/logs \ --restart unless-stopped \ n8nio/n8n:0.226.0关键参数说明数据持久化三个挂载卷分别存储工作流数据、配置文件和日志安全认证必须启用BASIC_AUTH避免未授权访问时区设置特别是定时任务场景时区不对会导致执行时间错乱重启策略unless-stopped保证服务意外退出后自动恢复4.2 企业级高可用架构对于日均执行上万次工作流的大型企业我推荐以下架构----------------- | Load Balancer | ---------------- | ------------------------------ | | -------------- -------------- | n8n-node-1 | | n8n-node-2 | | (Docker Swarm)| | (Docker Swarm)| -------------- -------------- | | ------------------------------ | ---------------- | PostgreSQL HA | | (3节点集群) | -----------------具体实现步骤初始化Swarm集群docker swarm init --advertise-addr MANAGER_IP部署PostgreSQL集群docker stack deploy -c postgres-ha-stack.yml postgres部署n8n服务docker service create \ --name n8n \ --replicas 3 \ --publish published5678,target5678 \ --env DB_TYPEpostgresdb \ --env DB_POSTGRESDB_HOSTpostgres \ --env DB_POSTGRESDB_USERn8n \ --env DB_POSTGRESDB_PASSWORDyour-password \ --env DB_POSTGRESDB_DATABASEn8n \ --mount typevolume,sourcen8n_data,destination/home/node/.n8n \ --restart-condition any \ n8nio/n8n:0.226.05. 数据库集成实战5.1 PostgreSQL配置优化默认配置下PostgreSQL性能可能成为瓶颈这是我的调优方案专用容器启动docker run -d \ --name n8n-postgres \ -e POSTGRES_USERn8n \ -e POSTGRES_PASSWORDcomplex-password \ -e POSTGRES_DBn8n \ -e PGDATA/var/lib/postgresql/data/pgdata \ -v /opt/postgres/data:/var/lib/postgresql/data \ -v /opt/postgres/config:/etc/postgresql \ --memory4g \ --cpus2 \ postgres:15-alpine \ -c shared_buffers1GB \ -c effective_cache_size3GB \ -c maintenance_work_mem256MB \ -c random_page_cost1.1 \ -c work_mem16MBn8n连接配置docker run -d \ --name n8n \ -p 5678:5678 \ -e DB_TYPEpostgresdb \ -e DB_POSTGRESDB_HOSTn8n-postgres \ -e DB_POSTGRESDB_PORT5432 \ -e DB_POSTGRESDB_USERn8n \ -e DB_POSTGRESDB_PASSWORDcomplex-password \ -e DB_POSTGRESDB_DATABASEn8n \ -e DB_POSTGRESDB_SSLfalse \ -e DB_POSTGRESDB_POOL_MIN2 \ -e DB_POSTGRESDB_POOL_MAX10 \ -v /opt/n8n/data:/home/node/.n8n \ --link n8n-postgres \ n8nio/n8n5.2 数据库备份方案自动化工作流数据丢失绝对是灾难我的备份方案包含三个层次每日全量备份# 备份脚本 /usr/local/bin/backup-n8n-db.sh docker exec n8n-postgres pg_dump -U n8n -Fc n8n /backups/n8n-$(date %Y%m%d).dump find /backups -name n8n-*.dump -mtime 7 -deleteWAL归档生产环境必备# 在postgres容器中设置 echo archive_mode on /etc/postgresql/postgresql.conf echo archive_command test ! -f /backups/wal/%f cp %p /backups/wal/%f /etc/postgresql/postgresql.confn8n工作流导出# 使用n8n API自动导出工作流 curl -X GET \ http://localhost:5678/api/v1/workflows \ -H Authorization: Bearer YOUR-API-KEY \ /backups/workflows-$(date %Y%m%d).json6. Docker Compose全栈部署6.1 完整生产配置这是我经过多个项目验证的compose模板包含n8n主服务PostgreSQL数据库Redis缓存Traefik反向代理version: 3.8 services: postgres: image: postgres:15-alpine container_name: n8n_postgres environment: POSTGRES_USER: n8n POSTGRES_PASSWORD: ${DB_PASSWORD} POSTGRES_DB: n8n volumes: - pg_data:/var/lib/postgresql/data networks: - n8n_network deploy: resources: limits: cpus: 2 memory: 4G redis: image: redis:7-alpine container_name: n8n_redis command: redis-server --save 60 1 --loglevel warning volumes: - redis_data:/data networks: - n8n_network n8n: image: n8nio/n8n:0.226.0 container_name: n8n_server depends_on: - postgres - redis environment: - DB_TYPEpostgresdb - DB_POSTGRESDB_HOSTpostgres - DB_POSTGRESDB_PORT5432 - DB_POSTGRESDB_USERn8n - DB_POSTGRESDB_PASSWORD${DB_PASSWORD} - DB_POSTGRESDB_DATABASEn8n - N8N_REDIS_HOSTredis - N8N_BASIC_AUTH_ACTIVEtrue - N8N_BASIC_AUTH_USER${ADMIN_USER} - N8N_BASIC_AUTH_PASSWORD${ADMIN_PASSWORD} - N8N_HOST${PUBLIC_URL} - NODE_ENVproduction - TZAsia/Shanghai volumes: - n8n_data:/home/node/.n8n ports: - 5678:5678 networks: - n8n_network deploy: resources: limits: cpus: 4 memory: 8G traefik: image: traefik:v2.10 container_name: n8n_traefik command: - --api.insecuretrue - --providers.dockertrue - --entrypoints.web.address:80 - --entrypoints.websecure.address:443 - --certificatesresolvers.myresolver.acme.tlschallengetrue - --certificatesresolvers.myresolver.acme.email${ACME_EMAIL} - --certificatesresolvers.myresolver.acme.storage/letsencrypt/acme.json ports: - 80:80 - 443:443 - 8080:8080 volumes: - /var/run/docker.sock:/var/run/docker.sock:ro - traefik_certs:/letsencrypt networks: - n8n_network volumes: pg_data: redis_data: n8n_data: traefik_certs: networks: n8n_network: driver: bridge使用步骤创建.env文件echo DB_PASSWORDyour-strong-db-password .env echo ADMIN_USERadmin .env echo ADMIN_PASSWORDyour-n8n-password .env echo PUBLIC_URLyour-domain.com .env echo ACME_EMAILyour-emailexample.com .env启动服务docker compose up -d6.2 性能调优技巧在资源有限的情况下这些参数调整可以显著提升性能n8n内存限制environment: - NODE_OPTIONS--max-old-space-size6144 # 6GB内存限制工作流执行优化environment: - EXECUTIONS_PROCESSmain - EXECUTIONS_TIMEOUT3600 - EXECUTIONS_DATA_PRUNEtrue - EXECUTIONS_DATA_MAX_AGE72Redis缓存配置environment: - N8N_CACHE_ENABLEDtrue - N8N_REDIS_CACHE_TTL864007. 运维与监控7.1 日志管理方案生产环境必须建立完善的日志体系我的方案是JSON格式日志docker run -d \ ... \ -e N8N_LOG_FORMATjson \ -e N8N_LOG_OUTPUTfile \ -e N8N_LOG_FILE_LOCATION/logs/n8n.log \ -v /opt/n8n/logs:/logs \ n8nio/n8nLogrotate配置# /etc/logrotate.d/n8n /opt/n8n/logs/*.log { daily rotate 30 compress delaycompress missingok notifempty create 644 root root }ELK集成企业级# docker-compose.yml追加 filebeat: image: docker.elastic.co/beats/filebeat:8.7.0 volumes: - /opt/n8n/logs:/var/log/n8n - ./filebeat.yml:/usr/share/filebeat/filebeat.yml depends_on: - elasticsearch networks: - n8n_network7.2 监控指标收集n8n内置Prometheus指标端点配置方法启用指标environment: - N8N_METRICStrue - N8N_METRICS_ENDPOINT/metricsPrometheus配置prometheus: image: prom/prometheus ports: - 9090:9090 volumes: - ./prometheus.yml:/etc/prometheus/prometheus.yml networks: - n8n_networkGrafana仪表板 导入官方仪表板ID 15759可以监控工作流执行次数执行耗时分布错误率统计队列积压情况8. 安全加固指南8.1 基础安全配置这些是必须实施的安全措施HTTPS强制environment: - N8N_PROTOCOLhttps - N8N_SSL_KEY/path/to/key.pem - N8N_SSL_CERT/path/to/cert.pemIP白名单environment: - N8N_IP_WHITELIST192.168.1.0/24,10.0.0.2凭证加密environment: - N8N_ENCRYPTION_KEYyour-32-char-encryption-key8.2 企业级安全方案对于金融级安全要求建议网络隔离networks: n8n_internal: internal: trueSecret管理secrets: db_password: file: ./db_password.txt encryption_key: file: ./encryption_key.txt审计日志environment: - N8N_AUDIT_LOG_ENABLEDtrue - N8N_AUDIT_LOG_FILE/audit/audit.log9. 故障排查手册9.1 常见问题解决这些是我遇到最多的五个问题容器启动失败# 查看日志 docker logs -f n8n-server # 常见原因 # - 数据库连接失败 # - 挂载目录权限问题 # - 内存不足工作流不执行# 检查时区设置 docker exec n8n-server date # 检查队列状态 curl -H Authorization: Bearer API_KEY \ http://localhost:5678/api/v1/executions性能瓶颈# 查看资源使用 docker stats n8n-server postgres # 数据库分析 docker exec -it postgres \ psql -U n8n -c SELECT * FROM pg_stat_activity9.2 调试技巧高级调试方法临时进入容器docker exec -it n8n-server /bin/bash修改日志级别environment: - N8N_LOG_LEVELdebug模拟Webhook请求curl -X POST \ -H Content-Type: application/json \ -d {key:value} \ http://localhost:5678/webhook/test10. 进阶应用场景10.1 多租户架构使用单个n8n实例服务多个团队environment: - N8N_USER_MANAGEMENT_DISABLEDfalse - N8N_BASIC_AUTH_ACTIVEtrue - N8N_USER_FOLDER/config/users - N8N_WORKFLOW_SHARINGtrue10.2 AI工作流集成结合LangChain构建智能工作流{ nodes: [ { type: n8n-nodes-langchain.agent, parameters: { model: gpt-4, tools: [serpapi, calculator], prompt: 分析{{$node[Webhook].json[query]}}的市场趋势 } } ] }10.3 混合云部署跨云工作流编排方案environment: - N8N_WEBHOOK_TUNNEL_URLhttps://your-tunnel-url - N8N_EXTERNAL_HOOK_FILTERSaws,azure,gcp
n8n Docker 部署实战：从零搭建企业级自动化工作流平台
发布时间：2026/7/25 7:09:44
1. 为什么选择n8nDocker搭建自动化工作流如果你正在寻找一个既强大又灵活的工作流自动化工具n8n绝对值得一试。作为一个开源平台它完美结合了低代码可视化操作和专业级编程能力。我去年在帮一家电商公司搭建库存预警系统时就是用它把Shopify、Slack和内部ERP系统串联起来的整个过程比预想的简单得多。Docker化部署带来的好处更是不言而喻。记得第一次手动部署n8n时光是处理各种依赖就花了大半天。后来改用Docker从零到运行只用了不到10分钟。这种开箱即用的体验对于需要快速验证想法或者搭建临时自动化流程的场景特别友好。企业级场景下n8nDocker的组合优势更明显环境一致性开发、测试、生产环境完全一致再也不会出现在我机器上能跑的问题资源隔离每个工作流可以运行在独立的容器中避免相互干扰弹性扩展配合Kubernetes可以轻松实现横向扩展安全可控所有数据都在自己掌控中特别适合金融、医疗等敏感行业2. 部署前的环境准备2.1 Docker环境配置我强烈建议使用Linux系统进行部署特别是Ubuntu 20.04/22.04 LTS版本。最近在CentOS 7上遇到不少兼容性问题有些Docker特性需要较新的内核支持。下面是经过多次验证的安装脚本# 卸载旧版本 sudo apt-get remove docker docker-engine docker.io containerd runc # 安装依赖 sudo apt-get update sudo apt-get install -y \ apt-transport-https \ ca-certificates \ curl \ gnupg \ lsb-release # 添加Docker官方GPG密钥 curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg # 设置稳定版仓库 echo \ deb [archamd64 signed-by/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null # 安装Docker引擎 sudo apt-get update sudo apt-get install -y docker-ce docker-ce-cli containerd.io # 验证安装 sudo docker run hello-world安装完成后记得执行以下关键配置用户组设置把当前用户加入docker组避免每次都要sudosudo usermod -aG docker $USER newgrp docker镜像加速国内用户建议配置镜像加速源sudo mkdir -p /etc/docker sudo tee /etc/docker/daemon.json -EOF { registry-mirrors: [https://your-mirror.mirror.aliyuncs.com] } EOF sudo systemctl daemon-reload sudo systemctl restart docker2.2 硬件资源规划根据我的经验不同规模的工作流对资源需求差异很大小型工作流10个以内简单节点1核CPU/1GB内存足够中型工作流50个节点左右建议2核CPU/4GB内存复杂工作流含AI处理等至少4核CPU/8GB内存特别提醒如果计划使用PostgreSQL数据库需要额外预留存储空间初始10GB根据日志保留策略适当增加内存PostgreSQL容器至少分配2GB独立内存3. n8n镜像获取与配置3.1 镜像拉取策略官方镜像n8nio/n8n是最稳妥的选择但国内直接拉取可能会很慢。我测试过几种替代方案国内镜像源加速推荐docker pull registry.cn-hangzhou.aliyuncs.com/n8nio/n8n:latest docker tag registry.cn-hangzhou.aliyuncs.com/n8nio/n8n:latest n8nio/n8n:latest自建镜像缓存适合企业内网# 在能访问外网的机器上 docker pull n8nio/n8n:latest docker save -o n8n-latest.tar n8nio/n8n:latest # 在内网机器上 docker load -i n8n-latest.tar3.2 版本选择建议生产环境千万不要盲目使用latest标签我吃过这个亏。建议锁定具体版本docker pull n8nio/n8n:0.226.0版本选择原则稳定版末尾为偶数的版本如0.226.0尝鲜版末尾为奇数的版本如0.227.1长期支持版官方特别标注的LTS版本4. 生产级部署方案4.1 基础持久化部署这是我在中小型企业最常用的部署方式# 创建数据目录 mkdir -p /opt/n8n/{data,config,logs} # 设置权限重要 chown -R 1000:1000 /opt/n8n # 启动容器 docker run -d \ --name n8n-prod \ -p 5678:5678 \ -e N8N_BASIC_AUTH_ACTIVEtrue \ -e N8N_BASIC_AUTH_USERadmin \ -e N8N_BASIC_AUTH_PASSWORDyour-strong-password \ -e NODE_ENVproduction \ -e TZAsia/Shanghai \ -v /opt/n8n/data:/home/node/.n8n \ -v /opt/n8n/config:/config \ -v /opt/n8n/logs:/logs \ --restart unless-stopped \ n8nio/n8n:0.226.0关键参数说明数据持久化三个挂载卷分别存储工作流数据、配置文件和日志安全认证必须启用BASIC_AUTH避免未授权访问时区设置特别是定时任务场景时区不对会导致执行时间错乱重启策略unless-stopped保证服务意外退出后自动恢复4.2 企业级高可用架构对于日均执行上万次工作流的大型企业我推荐以下架构----------------- | Load Balancer | ---------------- | ------------------------------ | | -------------- -------------- | n8n-node-1 | | n8n-node-2 | | (Docker Swarm)| | (Docker Swarm)| -------------- -------------- | | ------------------------------ | ---------------- | PostgreSQL HA | | (3节点集群) | -----------------具体实现步骤初始化Swarm集群docker swarm init --advertise-addr MANAGER_IP部署PostgreSQL集群docker stack deploy -c postgres-ha-stack.yml postgres部署n8n服务docker service create \ --name n8n \ --replicas 3 \ --publish published5678,target5678 \ --env DB_TYPEpostgresdb \ --env DB_POSTGRESDB_HOSTpostgres \ --env DB_POSTGRESDB_USERn8n \ --env DB_POSTGRESDB_PASSWORDyour-password \ --env DB_POSTGRESDB_DATABASEn8n \ --mount typevolume,sourcen8n_data,destination/home/node/.n8n \ --restart-condition any \ n8nio/n8n:0.226.05. 数据库集成实战5.1 PostgreSQL配置优化默认配置下PostgreSQL性能可能成为瓶颈这是我的调优方案专用容器启动docker run -d \ --name n8n-postgres \ -e POSTGRES_USERn8n \ -e POSTGRES_PASSWORDcomplex-password \ -e POSTGRES_DBn8n \ -e PGDATA/var/lib/postgresql/data/pgdata \ -v /opt/postgres/data:/var/lib/postgresql/data \ -v /opt/postgres/config:/etc/postgresql \ --memory4g \ --cpus2 \ postgres:15-alpine \ -c shared_buffers1GB \ -c effective_cache_size3GB \ -c maintenance_work_mem256MB \ -c random_page_cost1.1 \ -c work_mem16MBn8n连接配置docker run -d \ --name n8n \ -p 5678:5678 \ -e DB_TYPEpostgresdb \ -e DB_POSTGRESDB_HOSTn8n-postgres \ -e DB_POSTGRESDB_PORT5432 \ -e DB_POSTGRESDB_USERn8n \ -e DB_POSTGRESDB_PASSWORDcomplex-password \ -e DB_POSTGRESDB_DATABASEn8n \ -e DB_POSTGRESDB_SSLfalse \ -e DB_POSTGRESDB_POOL_MIN2 \ -e DB_POSTGRESDB_POOL_MAX10 \ -v /opt/n8n/data:/home/node/.n8n \ --link n8n-postgres \ n8nio/n8n5.2 数据库备份方案自动化工作流数据丢失绝对是灾难我的备份方案包含三个层次每日全量备份# 备份脚本 /usr/local/bin/backup-n8n-db.sh docker exec n8n-postgres pg_dump -U n8n -Fc n8n /backups/n8n-$(date %Y%m%d).dump find /backups -name n8n-*.dump -mtime 7 -deleteWAL归档生产环境必备# 在postgres容器中设置 echo archive_mode on /etc/postgresql/postgresql.conf echo archive_command test ! -f /backups/wal/%f cp %p /backups/wal/%f /etc/postgresql/postgresql.confn8n工作流导出# 使用n8n API自动导出工作流 curl -X GET \ http://localhost:5678/api/v1/workflows \ -H Authorization: Bearer YOUR-API-KEY \ /backups/workflows-$(date %Y%m%d).json6. Docker Compose全栈部署6.1 完整生产配置这是我经过多个项目验证的compose模板包含n8n主服务PostgreSQL数据库Redis缓存Traefik反向代理version: 3.8 services: postgres: image: postgres:15-alpine container_name: n8n_postgres environment: POSTGRES_USER: n8n POSTGRES_PASSWORD: ${DB_PASSWORD} POSTGRES_DB: n8n volumes: - pg_data:/var/lib/postgresql/data networks: - n8n_network deploy: resources: limits: cpus: 2 memory: 4G redis: image: redis:7-alpine container_name: n8n_redis command: redis-server --save 60 1 --loglevel warning volumes: - redis_data:/data networks: - n8n_network n8n: image: n8nio/n8n:0.226.0 container_name: n8n_server depends_on: - postgres - redis environment: - DB_TYPEpostgresdb - DB_POSTGRESDB_HOSTpostgres - DB_POSTGRESDB_PORT5432 - DB_POSTGRESDB_USERn8n - DB_POSTGRESDB_PASSWORD${DB_PASSWORD} - DB_POSTGRESDB_DATABASEn8n - N8N_REDIS_HOSTredis - N8N_BASIC_AUTH_ACTIVEtrue - N8N_BASIC_AUTH_USER${ADMIN_USER} - N8N_BASIC_AUTH_PASSWORD${ADMIN_PASSWORD} - N8N_HOST${PUBLIC_URL} - NODE_ENVproduction - TZAsia/Shanghai volumes: - n8n_data:/home/node/.n8n ports: - 5678:5678 networks: - n8n_network deploy: resources: limits: cpus: 4 memory: 8G traefik: image: traefik:v2.10 container_name: n8n_traefik command: - --api.insecuretrue - --providers.dockertrue - --entrypoints.web.address:80 - --entrypoints.websecure.address:443 - --certificatesresolvers.myresolver.acme.tlschallengetrue - --certificatesresolvers.myresolver.acme.email${ACME_EMAIL} - --certificatesresolvers.myresolver.acme.storage/letsencrypt/acme.json ports: - 80:80 - 443:443 - 8080:8080 volumes: - /var/run/docker.sock:/var/run/docker.sock:ro - traefik_certs:/letsencrypt networks: - n8n_network volumes: pg_data: redis_data: n8n_data: traefik_certs: networks: n8n_network: driver: bridge使用步骤创建.env文件echo DB_PASSWORDyour-strong-db-password .env echo ADMIN_USERadmin .env echo ADMIN_PASSWORDyour-n8n-password .env echo PUBLIC_URLyour-domain.com .env echo ACME_EMAILyour-emailexample.com .env启动服务docker compose up -d6.2 性能调优技巧在资源有限的情况下这些参数调整可以显著提升性能n8n内存限制environment: - NODE_OPTIONS--max-old-space-size6144 # 6GB内存限制工作流执行优化environment: - EXECUTIONS_PROCESSmain - EXECUTIONS_TIMEOUT3600 - EXECUTIONS_DATA_PRUNEtrue - EXECUTIONS_DATA_MAX_AGE72Redis缓存配置environment: - N8N_CACHE_ENABLEDtrue - N8N_REDIS_CACHE_TTL864007. 运维与监控7.1 日志管理方案生产环境必须建立完善的日志体系我的方案是JSON格式日志docker run -d \ ... \ -e N8N_LOG_FORMATjson \ -e N8N_LOG_OUTPUTfile \ -e N8N_LOG_FILE_LOCATION/logs/n8n.log \ -v /opt/n8n/logs:/logs \ n8nio/n8nLogrotate配置# /etc/logrotate.d/n8n /opt/n8n/logs/*.log { daily rotate 30 compress delaycompress missingok notifempty create 644 root root }ELK集成企业级# docker-compose.yml追加 filebeat: image: docker.elastic.co/beats/filebeat:8.7.0 volumes: - /opt/n8n/logs:/var/log/n8n - ./filebeat.yml:/usr/share/filebeat/filebeat.yml depends_on: - elasticsearch networks: - n8n_network7.2 监控指标收集n8n内置Prometheus指标端点配置方法启用指标environment: - N8N_METRICStrue - N8N_METRICS_ENDPOINT/metricsPrometheus配置prometheus: image: prom/prometheus ports: - 9090:9090 volumes: - ./prometheus.yml:/etc/prometheus/prometheus.yml networks: - n8n_networkGrafana仪表板 导入官方仪表板ID 15759可以监控工作流执行次数执行耗时分布错误率统计队列积压情况8. 安全加固指南8.1 基础安全配置这些是必须实施的安全措施HTTPS强制environment: - N8N_PROTOCOLhttps - N8N_SSL_KEY/path/to/key.pem - N8N_SSL_CERT/path/to/cert.pemIP白名单environment: - N8N_IP_WHITELIST192.168.1.0/24,10.0.0.2凭证加密environment: - N8N_ENCRYPTION_KEYyour-32-char-encryption-key8.2 企业级安全方案对于金融级安全要求建议网络隔离networks: n8n_internal: internal: trueSecret管理secrets: db_password: file: ./db_password.txt encryption_key: file: ./encryption_key.txt审计日志environment: - N8N_AUDIT_LOG_ENABLEDtrue - N8N_AUDIT_LOG_FILE/audit/audit.log9. 故障排查手册9.1 常见问题解决这些是我遇到最多的五个问题容器启动失败# 查看日志 docker logs -f n8n-server # 常见原因 # - 数据库连接失败 # - 挂载目录权限问题 # - 内存不足工作流不执行# 检查时区设置 docker exec n8n-server date # 检查队列状态 curl -H Authorization: Bearer API_KEY \ http://localhost:5678/api/v1/executions性能瓶颈# 查看资源使用 docker stats n8n-server postgres # 数据库分析 docker exec -it postgres \ psql -U n8n -c SELECT * FROM pg_stat_activity9.2 调试技巧高级调试方法临时进入容器docker exec -it n8n-server /bin/bash修改日志级别environment: - N8N_LOG_LEVELdebug模拟Webhook请求curl -X POST \ -H Content-Type: application/json \ -d {key:value} \ http://localhost:5678/webhook/test10. 进阶应用场景10.1 多租户架构使用单个n8n实例服务多个团队environment: - N8N_USER_MANAGEMENT_DISABLEDfalse - N8N_BASIC_AUTH_ACTIVEtrue - N8N_USER_FOLDER/config/users - N8N_WORKFLOW_SHARINGtrue10.2 AI工作流集成结合LangChain构建智能工作流{ nodes: [ { type: n8n-nodes-langchain.agent, parameters: { model: gpt-4, tools: [serpapi, calculator], prompt: 分析{{$node[Webhook].json[query]}}的市场趋势 } } ] }10.3 混合云部署跨云工作流编排方案environment: - N8N_WEBHOOK_TUNNEL_URLhttps://your-tunnel-url - N8N_EXTERNAL_HOOK_FILTERSaws,azure,gcp
