n8n + Bitovi社区节点Docker镜像文档

镜像概述

本Docker镜像集成了n8n工作流自动化工具及Bitovi社区节点，旨在提供开箱即用的工作流自动化解决方案。用户无需手动安装或配置社区节点，即可直接使用扩展功能，快速构建复杂自动化工作流。

核心功能与特性

基础功能

• n8n核心集成：完整包含n8n工作流自动化平台，支持基于节点的可视化工作流设计、触发条件配置、任务调度等核心功能。
• 多协议支持：兼容HTTP/HTTPS、WebSocket等多种协议，可与REST API、数据库、云服务等主流系统集成。

扩展特性

• Bitovi社区节点预装：内置Bitovi开发的社区节点，扩展n8n的服务集成能力，覆盖更多行业场景（如特定API集成、自定义数据处理逻辑等）。
• 开箱即用：社区节点已预配置，无需通过n8n节点市场手动安装，节省部署时间。
• 配置兼容性：完全兼容n8n标准配置方式，支持环境变量、配置文件等多种参数自定义。

使用场景

• 中小企业自动化：快速搭建数据同步（如Excel与数据库）、跨平台通知（邮件/企业微信/钉钉）、定时任务（报表生成）等轻量级工作流。
• 开发者原型验证：利用扩展节点测试第三方服务集成方案，加速自动化流程原型开发。
• IT运维自动化：通过预置节点实现日志聚合、服务器监控告警、批量任务执行等运维场景。
• 营销流程自动化：集成CRM、邮件营销工具、社交媒体平台，构建线索跟进、活动数据分析等营销工作流。

使用方法

快速启动

通过以下命令启动容器，默认暴露n8n Web界面端口（5678）并持久化工作流数据：

docker run -d \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \  # 挂载数据卷，持久化工作流配置
  --name n8n-bitovi \
  [镜像名称]:[标签]  # 替换为实际镜像名称和标签

访问Web界面

容器启动后，通过浏览器访问 http://localhost:5678 进入n8n工作流编辑器。首次登录无需认证（生产环境建议配置身份验证，见下文）。

安全配置（生产环境）

建议通过环境变量启用基础认证，防止未授权访问：

docker run -d \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  -e N8N_BASIC_AUTH_USER=admin \  # 用户名
  -e N8N_BASIC_AUTH_PASSWORD=your_strong_password \  # 密码
  --name n8n-bitovi \
  [镜像名称]:[标签]

高级配置（环境变量）

支持n8n标准环境变量自定义，常用参数如下：

数据持久化

通过 -v ~/.n8n:/home/node/.n8n 挂载本地目录，可持久化工作流配置、凭证、日志等数据。如需迁移容器，备份该目录即可。

注意事项

• 镜像基于n8n官方镜像构建，兼容n8n所有标准功能及升级路径。
• Bitovi社区节点版本与n8n核心版本同步更新，建议使用镜像最新标签以获取功能优化。
• 生产环境建议配置HTTPS（通过反向代理如Nginx）及数据库（如PostgreSQL）替代默认SQLite，提升稳定性。