aarzak/n8n

自定义n8n Docker镜像文档

镜像概述

本镜像为n8n的自定义版本，已预先配置base path为/n8n，旨在允许用户通过URL路径/n8n访问n8n服务，适用于需要特定路径部署的场景。n8n是一款开源的工作流自动化工具，支持通过可视化界面创建、执行和管理自动化工作流。

核心功能与特性

• 预配置Base Path：已设置base path为/n8n，无需额外配置即可通过http://<host>:<port>/n8n访问服务
• 继承n8n核心功能：包含n8n的全部原生功能，如工作流设计、节点集成（支持数百种应用和服务）、定时任务、触发器等
• 轻量级部署：基于官方n8n镜像优化，保持功能完整性的同时确保部署便捷性

使用场景

• 需要在同一服务器上部署多个服务，通过URL路径区分不同服务时
• 配置反向代理（如Nginx、Traefik）时，需将n8n服务映射到特定路径下
• 企业内部或特定网络环境中，要求服务访问路径规范化管理

使用方法与配置说明

基本部署（Docker Run）

通过以下命令快速启动镜像：

bash
docker run -d \
  --name custom-n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  your-image-name:latest

参数说明：

• -p 5678:5678：映射容器端口5678到主机，n8n默认端口为5678
• -v ~/.n8n:/home/node/.n8n：挂载本地目录以持久化n8n数据（工作流、配置等）

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'

services:
  n8n:
    image: your-image-name:latest
    container_name: custom-n8n
    ports:
      - "5678:5678"
    volumes:
      - ~/.n8n:/home/node/.n8n
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

访问服务

服务启动后，通过浏览器访问：http://<主机IP或域名>:5678/n8n 即可打开n8n工作流编辑器界面。

自定义配置（可选）

如需修改base path，可通过环境变量覆盖默认配置（若镜像支持）：

bash
docker run -d \
  --name custom-n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  -e N8N_BASE_PATH=/custom-path \
  your-image-name:latest

注：若镜像已固化base path配置，修改环境变量可能不生效，请以实际镜像配置为准。

注意事项

• 持久化数据：务必挂载数据卷（/home/node/.n8n），避免容器重启后工作流和配置丢失
• 端口冲突：确保主机端口5678未被其他服务占用，或通过-p <host-port>:5678指定其他端口
• 安全配置：生产环境中建议配置HTTPS（可通过反向代理实现）并设置访问认证