hadadrjt/n8n

n8n Docker镜像文档

镜像概述和主要用途

n8n是一款开源的工作流自动化工具，旨在帮助用户轻松创建和运行强大的自动化工作流。它提供可视化界面，支持无代码或低代码方式构建流程，适用于连接各种应用、服务和系统，实现数据同步、任务自动化和业务流程优化。

核心功能和特性

• 开源免费：基于MIT许可证，源代码完全开放，可自由使用和定制
• 灵活的工作流设计：通过拖放式界面设计复杂工作流，支持分支、循环、条件逻辑等
• 无代码/低代码支持：无需编程经验即可创建基础工作流，同时支持JavaScript代码节点满足高级需求
• 丰富的集成能力：内置数百个预构建节点，支持与常见应用（如Slack、GitHub、Google Sheets等）集成
• 可扩展性：支持自定义节点开发，轻松扩展集成范围
• 自托管能力：可在私有环境中部署，确保数据安全和隐私保护

使用场景和适用范围

• 数据同步：在不同应用间自动同步数据（如CRM与邮件列表、电子商务平台与库存系统）
• 自动化任务处理：定时执行重复性任务（如报告生成、文件备份、社交媒体发布）
• 跨应用工作流：连接多个服务实现端到端流程（如客户表单提交→数据验证→通知发送→任务分配）
• 业务流程自动化：优化内部业务流程（如批准流程、发票处理、项目管理）
• 适用人群：开发者、IT管理员、业务分析师、运营人员等需要自动化工作流程的用户

使用方法和配置说明

基本部署（Docker Run）

使用以下命令快速启动n8n容器：

bash
docker run -d \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  n8nio/n8n

参数说明：

• -p 5678:5678：映射容器端口5678到主机，用于访问n8n web界面
• -v ~/.n8n:/home/node/.n8n：挂载本地目录以持久化n8n数据（工作流、凭证等）

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'

services:
  n8n:
    image: n8nio/n8n
    container_name: n8n
    ports:
      - "5678:5678"
    volumes:
      - ~/.n8n:/home/node/.n8n
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=your_secure_password
      - N8N_HOST=your-domain.com
      - N8N_PROTOCOL=https
      - WEBHOOK_URL=https://your-domain.com/
    restart: unless-stopped

环境变量说明：

• N8N_BASIC_AUTH_ACTIVE：启用基本身份验证（true/false）
• N8N_BASIC_AUTH_USER：基本身份验证用户名
• N8N_BASIC_AUTH_PASSWORD：基本身份验证密码
• N8N_HOST：n8n实例的主机名
• N8N_PROTOCOL：协议（http/https）
• WEBHOOK_URL：外部可访问的webhook URL，用于接收外部服务的触发事件

访问n8n

启动容器后，通过浏览器访问 http://localhost:5678 即可打开n8n web界面，开始创建工作流。