onestic/n8n

n8n

概述

onestic/n8n镜像旨在在项目中共享所有n8n实例的通用功能和配置，提供标准化的运行环境和便捷的版本管理。

支持的平台和标签

平台支持

该镜像构建适用于以下平台：

• linux/amd64
• linux/arm64

标签说明

标签与镜像所基于的n8n版本一一对应。此外，可能存在开发相关的标签，使用此类标签时请自行评估风险。

核心功能与特性

• 继承特性：完整继承最新n8n官方镜像的全部功能
• 持续更新：每日基于最新n8n基础镜像自动构建，确保组件最新
• 语义化版本标签：提供灵活的版本控制，支持：
  • 1：指向最新1.*.*版本
  • 1.39：指向最新1.39.*版本
  • 保留官方镜像的特定版本标签（如1.39.0）
• 时区配置：系统及n8n应用时区预配置为"Europe/Madrid"（已预装tzdata包）
• 基础工具：预装curl、jq和git等常用shell工具
• 健康检查：内置健康检查配置，无需在docker-compose中手动添加

使用场景与适用范围

适用于需要在多个n8n实例间保持一致配置的项目，特别适合：

• 需要统一时区和基础工具的团队环境
• 需要灵活控制版本更新的生产环境
• 希望简化部署配置的多实例项目

使用方法与配置说明

基本运行命令

bash
docker run -d --name n8n docker.xuanyuan.run/onestic/n8n:1

版本选择示例

• 使用最新1.x版本：

  bash
  docker run docker.xuanyuan.run/onestic/n8n:1
  

• 使用最新1.39.x版本：

  bash
  docker run docker.xuanyuan.run/onestic/n8n:1.39
  

• 使用特定版本（如1.39.0）：

  bash
  docker run docker.xuanyuan.run/onestic/n8n:1.39.0
  

Docker Compose配置示例

yaml
version: '3'

services:
  n8n:
    image: docker.xuanyuan.run/onestic/n8n:1
    ports:
      - "5678:5678"
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=securepassword
    volumes:
      - ./n8n_data:/home/node/.n8n
    # 健康检查已内置，无需额外配置

环境变量配置

可通过环境变量自定义n8n行为，常用变量包括：

• N8N_BASIC_AUTH_ACTIVE：启用基本身份验证
• N8N_BASIC_AUTH_USER：基本身份验证用户名
• N8N_BASIC_AUTH_PASSWORD：基本身份验证密码
• N8N_HOST：n8n服务主机名
• N8N_PORT：n8n服务端口