whatsplan/n8n Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

N8N自定义镜像文档

镜像概述

本镜像基于 n8nio/n8n:latest 构建，专为高级自动化场景设计。通过预安装系统工具和多个社区节点，简化部署流程，可直接用于生产或实验环境，无需手动配置额外组件。

核心功能与特性

系统工具扩展

在基础n8n容器上新增以下实用工具：

• jq：shell环境下的JSON处理工具，适用于脚本和调用外部命令的工作流。
• iputils：包含ping等网络工具，用于网络诊断和故障排查。
• ffmpeg：全功能多媒体处理工具，支持格式转换、音频提取、剪辑、滤镜及元数据处理。
• poppler-utils：PDF转换工具，支持PDF转PNG/JPEG图像或TXT文本（如生成文档预览、提取格式化/纯文本）。
• python3 + pip：Python运行环境基础，支持Python工具开发。
• pipx（node用户下）：隔离安装Python命令行工具，避免系统环境污染。

同时创建/data目录并配置适当权限，可作为数据卷使用。

预安装社区节点

以下社区节点已预装在~/.n8n/nodes目录：

1. n8n-nodes-text-manipulation
   文本处理节点，支持文本清理、格式化、替换等操作，直接在工作流中处理文本数据。

2. @cloudconvert/n8n-nodes-cloudconvert
   CloudConvert集成节点，通过API实现多格式文件转换。

3. n8n-nodes-randomizer
   随机化工具，支持生成随机值、从列表中选择项目、抽奖及A/B测试。

4. n8n-nodes-qrcode
   QR码生成节点，可在工作流中创建登录链接、邀请函、门票等场景的QR码。

5. n8n-nodes-edit-image-plus
   图像编辑节点，支持调整尺寸、裁剪、添加文本及简单合成，无需外部工具。

6. n8n-nodes-document-generator
   文档生成节点，基于模板自动创建PDF、报告、合同等文档。

7. @splainez/n8n-nodes-phonenumber-parser
   电话号码解析节点，支持号码解析、验证和标准化，适用于***和CRM工作流。

8. n8n-nodes-data-validation
   数据验证节点，在工作流继续前验证输入数据的类型、格式和必填字段。

9. n8n-nodes-globals
   全局变量节点，定义可在多个工作流中复用的常量（如URL、令牌、标准文本）。

10. n8n-nodes-toon-encode
    JSON转TOON格式节点，优化LLM（OpenAI、Anthropic等）的token消耗（减少40-60%），保持人类可读性的同时降低成本。

使用场景与适用范围

本镜像适用于以下自动化需求场景：

• 高级文本与数据处理（清洗、格式化、验证）
• 文件格式转换与编辑（文档、图像、多媒体）
• 输入数据验证与电话号码标准化
• 自动化文档生成（报告、合同）与QR码创建
• LLM交互时的payload优化（token成本控制）
• 跨工作流全局常量管理与随机化操作

使用方法

基本部署

通过Docker运行容器：

bash
docker run -d \
  --name n8n-custom \
  -p 5678:5678 \
  -v /path/to/local/data:/data \
  your-image-name:tag

数据持久化

使用/data目录作为数据卷，确保工作流和配置持久化：

bash
docker run -d \
  --name n8n-custom \
  -p 5678:5678 \
  -v n8n-data:/data \
  your-image-name:tag

注：首次启动后，通过http://localhost:5678访问n8n界面，预安装节点将自动加载到节点面板中。

总结

本镜像整合了n8n核心功能与实用扩展，无需手动安装社区节点和系统工具，开箱即可用于复杂自动化场景。无论是生产环境还是实验环境，均能显著提升工作流开发效率，降低配置成本。