n8n Docker 部署手册

docker 安装n8n 如需配置域名访问或 SSL 证书,请使用 Nginx 或 Traefik 等反向代理工具。按照以上步骤操作,你就能在国内环境中成功使用 Docker 安装并运行 n8n 了。为了提升下载速度,建议配置 Docker 国内镜像源。n8n 启动之后,你可以通过浏览器访问。来验证安装是否成功。查看docker compose 版本。中设置的用户名(admin)和密码。查看docker 服务状态。 阅读详情

一、n8n 简介

n8n 是一款专为技术团队打造的 开源工作流自动化平台(Workflow Automation Platform),兼具「低代码(No-code)」与「可编程(Pro-code)」双重特性。

它让你可以轻松地将不同系统、API 和服务连接起来,自动执行任务、数据同步、通知、集成 AI 模型等各种流程。
n8n 不仅能节省大量重复性工作,还能在团队内部构建稳定、安全的自动化体系。

🔑 核心功能亮点

功能说明
🧠 可编程与可视化兼备支持可视化拖拽节点,也能直接编写 JavaScript/Python 逻辑。
🤖 AI 原生支持内置 LangChain、OpenAI 接口,可搭建自定义 AI Agent 流程。
🧩 400+ 集成节点支持 GitHub、Slack、MySQL、Redis、Google Sheets、Telegram、OpenAI 等常用服务。
🔐 完全自托管Fair-Code 许可协议,支持本地部署,数据完全掌控在自己手中。
🧱 企业级特性提供权限管理、SSO、离线部署(Air-gapped)等企业功能。
🌍 活跃社区生态超过 900+ 预制工作流模板,可快速复用。

简言之:n8n = 可编程的 Zapier + 自主可控的 Airflow + AI 工作流引擎。


🧰 准备工作

若你的系统尚未安装 Docker,请先一键安装:

Linux Docker & Docker Compose 一键安装

一键安装配置脚本(推荐方案):
该脚本支持多种 Linux 发行版,支持一键安装 Docker、Docker Compose 并自动配置轩辕镜像加速源。

bash <(wget -qO- https://xuanyuan.cloud/docker.sh)

二、n8n Docker 镜像来源

你可以在 轩辕镜像 中找到官方同步的 n8n 镜像页面:
👉 https://xuanyuan.cloud/r/n8nio/n8n

镜像完全与官方 docker.n8n.io/n8nio/n8n 同步,支持快速拉取和国内加速。


三、下载 n8n 镜像

3.1 使用轩辕镜像拉取(推荐)

docker pull docker.xuanyuan.run/n8nio/n8n:latest

3.2 拉取后改名(标准命名方式)

docker pull docker.xuanyuan.run/n8nio/n8n:latest \
  && docker tag docker.xuanyuan.run/n8nio/n8n:latest n8nio/n8n:latest \
  && docker rmi docker.xuanyuan.run/n8nio/n8n:latest

说明:

  • docker pull:从轩辕镜像源拉取镜像,速度快且稳定
  • docker tag:重命名为官方标准名称,方便后续使用
  • docker rmi:删除临时镜像标签,节省存储空间

3.3 官方方式(可选)

如果网络能直连官方服务器,可直接拉取:

docker pull n8nio/n8n:latest

3.4 验证镜像下载

docker images

出现类似输出即表示成功:

REPOSITORY     TAG       IMAGE ID       CREATED        SIZE
n8nio/n8n      latest    7b14ac9439f2   2 weeks ago    450MB

四、启动 n8n 容器

4.1 快速启动(适合初学者)

此方式使用默认配置与 SQLite 存储,开箱即用:

docker volume create n8n_data

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v n8n_data:/home/node/.n8n \
  n8nio/n8n

启动成功后,访问浏览器:

http://localhost:5678

即可看到 n8n 的可视化工作流界面。

💡 数据将保存在名为 n8n_data 的 Docker 卷中,包含所有工作流、凭证与加密密钥。


4.2 持久化部署(推荐)

适合生产环境,挂载宿主机目录,保证配置与数据持久化。

第一步:创建目录
mkdir -p /data/n8n/{data,files}
第二步:启动容器
docker run -d --name n8n-web \
  -p 5678:5678 \
  -e TZ=Asia/Shanghai \
  -v /data/n8n/data:/home/node/.n8n \
  n8nio/n8n

说明:

参数含义
-v /data/n8n/data:/home/node/.n8n挂载数据目录,防止重启丢失工作流
-e TZ=Asia/Shanghai设置时区为北京时间
-p 5678:5678映射本地端口

4.3 开启公网隧道(测试 Webhook)

Webhook 需要公网访问时,可使用内置的 tunnel 功能(仅限开发测试):

docker run -it --rm \
  --name n8n-tunnel \
  -p 5678:5678 \
  -v n8n_data:/home/node/.n8n \
  n8nio/n8n start --tunnel

⚠️ 注意:tunnel 模式仅供测试,不应在生产环境使用。


五、与 PostgreSQL 配合使用(高级部署)

默认 n8n 使用 SQLite,可切换为 PostgreSQL 以获得更高性能和数据安全性。

5.1 启动 PostgreSQL(示例)

docker run -d \
  --name n8n-postgres \
  -e POSTGRES_USER=n8n \
  -e POSTGRES_PASSWORD=123456 \
  -e POSTGRES_DB=n8n \
  -v /data/postgres:/var/lib/postgresql/data \
  postgres:15

5.2 启动 n8n 并连接数据库

docker run -d --name n8n-db \
  -p 5678:5678 \
  -e DB_TYPE=postgresdb \
  -e DB_POSTGRESDB_DATABASE=n8n \
  -e DB_POSTGRESDB_HOST=n8n-postgres \
  -e DB_POSTGRESDB_PORT=5432 \
  -e DB_POSTGRESDB_USER=n8n \
  -e DB_POSTGRESDB_PASSWORD=123456 \
  -v /data/n8n/data:/home/node/.n8n \
  --link n8n-postgres \
  n8nio/n8n

六、使用 Docker Compose 一键部署

适合长期运行与团队协作环境。

6.1 创建 docker-compose.yml

version: '3.8'
services:
  postgres:
    image: postgres:15
    container_name: n8n-postgres
    environment:
      POSTGRES_USER: n8n
      POSTGRES_PASSWORD: 123456
      POSTGRES_DB: n8n
    volumes:
      - ./postgres:/var/lib/postgresql/data
    restart: always

  n8n:
    image: n8nio/n8n:latest
    container_name: n8n-service
    ports:
      - "5678:5678"
    environment:
      DB_TYPE: postgresdb
      DB_POSTGRESDB_HOST: n8n-postgres
      DB_POSTGRESDB_PORT: 5432
      DB_POSTGRESDB_DATABASE: n8n
      DB_POSTGRESDB_USER: n8n
      DB_POSTGRESDB_PASSWORD: 123456
      GENERIC_TIMEZONE: Asia/Shanghai
      TZ: Asia/Shanghai
    volumes:
      - ./n8n_data:/home/node/.n8n
    depends_on:
      - postgres
    restart: always

6.2 启动服务

docker compose up -d

查看状态:

docker compose ps

停止:

docker compose down

七、升级与维护

7.1 拉取最新镜像

docker pull n8nio/n8n:latest

7.2 重启容器

docker stop n8n-web && docker rm n8n-web
docker run -d --name n8n-web -p 5678:5678 -v /data/n8n/data:/home/node/.n8n n8nio/n8n

或使用 Compose:

docker compose pull
docker compose down
docker compose up -d

更新前请务必备份 /data/n8n/data 目录,避免密钥丢失导致凭证无法解密。


八、常见问题

8.1 启动后网页打不开?

  • 检查端口是否被占用:netstat -tulnp | grep 5678
  • 检查容器日志:docker logs n8n-web
  • 确认防火墙放行端口:ufw allow 5678/tcp

8.2 数据丢失?

请确认是否挂载了 /home/node/.n8n 数据卷。若该目录未持久化,重启后将丢失所有工作流。

8.3 如何修改时区?

在运行命令或 Compose 文件中增加:

-e TZ=Asia/Shanghai
-e GENERIC_TIMEZONE=Asia/Shanghai

8.4 密钥丢失导致无法解密?

如 .n8n 目录被误删,n8n 会生成新的密钥,旧凭证无法解密。
建议定期备份 /data/n8n/data。


九、验证运行状态

docker ps

若状态为 Up,表示运行成功。

访问浏览器:

http://服务器IP:5678

若能正常打开 n8n 界面并创建工作流,即部署成功 🎉。


🔚 结语

至此,你已掌握 基于轩辕镜像的 n8n Docker 部署全流程 ——
从镜像拉取、快速部署、持久化挂载、数据库集成,到 Compose 管理与版本升级。

  • 新手用户:建议先使用 SQLite 快速启动熟悉界面
  • 工程师/团队部署:推荐 PostgreSQL + Docker Compose 架构
  • 进阶应用:结合 Redis、Webhook、AI 节点构建自动化系统

🚀 n8n 让自动化更智能、更自由,让每个开发者都能构建属于自己的「自托管 Zapier」。

【AI平台】n8n入门1:详细介绍n8n的多种安装方式(含docer图形化安装n8n) 详细介绍n8n的多种安装方式(含docer图形化安装n8n) 阅读详情

相关推荐

n8n中文版安装指南,使用Docker部署N8N中文版

本文详细介绍如何使用Docker部署n8n中文版,重点解决海外开源自动化工具在国内使用的技术门槛问题。通过配置PostgreSQL数据库和Nginx反向代理,实现完整的WebHook功能支持。文档包含从环境准备、快速部署到HTTPS配置的完整流程,特别说明中文界面的实现方法及数据持久化方案。作者分享了自己从Dify转向n8n的原因——后者作为2019年启动的成熟项目,虽然对非开发者不够友好,但功能更强大。部署过程涉及Docker Compose、环境变量配置、Nginx反向代理设置及SSL证书申请等关键技术

AiBot 8054

n8n搭建docker部署

docker 国内库不可有后,n8n搭建命令

qq_39306128的博客 1万+

【n8n】为什么选择用 Docker Desktop 本地部署 n8n

—因为Windows原生不支持Linux内核,需通过WSL 2安装Ubuntu,让Docker Desktop能调用Linux内核运行容器(Docker Desktop在Windows上必须依赖WSL 2,否则无法启动);如果是macOS,虽无需WSL,但Ubuntu仍可作为“更纯粹的Linux环境”(避免macOS的类Unix环境与Linux的细微差异)。(支持Windows/macOS/Linux),核心功能是“打包应用及其所有依赖为一个‘容器’,让应用在任何支持Docker的环境中都能一致运行”。

weixin_44392103的博客 1143

Windows+n8n组合技!Docker部署全流程揭秘,远程访问零门槛实现

Windows+n8n组合技!Docker部署全流程揭秘,远程访问零门槛实现

分享学习知识地方 2960

玩转n8n工作流教程(一):Windows系统本地部署n8n自动化工作流(n8n中文汉化)

本文详细介绍在Windows系统下使用Docker部署n8n工作流自动化平台的本地部署教程。针对中文用户,文章还提供了n8n汉化教程,使用开源中文界面项目替换默认英文界面。完成n8n本地部署后,用户可通过浏览器访问本地端口使用N8N平台。本文是玩转N8N工作流系列教程的第一篇,后续将分享更多n8n自动化工作流模板和n8n工作流实战案例。

AiBot 4963

【n8n】本地部署 + 中文汉化 + 快速启动,玩转工作流(Docker版)

n8n是一款开源低代码工作流自动化平台,在GitHub上获得10.7万星标。与专注LLM应用的Dify不同,n8n更擅长系统集成和流程自动化,支持2000+服务连接。文章详细介绍了n8n的Docker部署方法、中文汉化步骤以及常见问题解决方案,并对比了n8n与Dify的定位差异:Dify适合快速构建AI应用,n8n则更适合复杂业务流程整合。两者可结合使用,发挥各自优势。

走在搬砖的路上! 8523

n8n Docker 容器化部署手册

n8n Docker 容器化部署手册

https://ophome.blog.youkuaiyun.com,在IT行业有多年的工作经验,尤其是在Python、Linux、负载均衡、Nginx和服务器运维等领域。 932

动手学n8n(一)——n8n初识和本地部署

n8n 意思是 nodemation,是 node 与 automation 的组合词,读作 n-eight-n。n8n 是一个开源的、基于节点的自动化工具,官方站点为,官方 GitHub 仓库为。模块化: 将复杂任务分解为可管理的小块,每个块代表一个操作或一个服务连接。可视化: 通过直观的拖放界面构建工作流程,让流程一目了然。可扩展性: 支持数百种集成,并允许用户创建自定义节点,满足特定需求。数据流: 数据在节点之间流动,每个节点对数据进行处理或转换,直至完成整个工作流程。

daishabby2486的博客 2223

[特殊字符] n8n Docker容器化部署完整手册

本文详细介绍了开源自动化工具n8n的Docker容器化部署方案。主要内容包括:1.n8n核心概念与优势,突出其开源特性、可视化工作流设计及400+应用集成能力;2.部署环境准备,涵盖系统要求、Docker安装及镜像加速配置;3.详细部署指南,提供基础Docker运行、Docker Compose编排及生产环境配置模板;4.汉化方案与界面定制方法;5.生产环境高级配置,包括数据库优化、安全加固和监控方案;6.数据备份与恢复策略;7.实际应用案例展示;8.常见问题解决方法。通过本指南,用户可快速搭建高可用的n8

油墨香^-^的博客 297

【n8n】n8n Docker部署

本文提供了使用Docker部署n8n工作流自动化平台的完整指南。首先介绍了Docker部署的优势,包括环境隔离、简化配置和便于迁移等。然后详细说明了基本部署步骤,包括基础启动命令、PostgreSQL数据库配置和时区设置方法。同时介绍了如何通过Docker命令和Docker Compose两种方式更新n8n版本,以及开发测试时启用Tunnel功能的注意事项。最后强调了生产环境的重要配置建议,如使用PostgreSQL替代SQLite、数据持久化和加密密钥设置等。

Mr 敦(A.Dun)Java历险记 1239

n8n 汉化版部署指南

本文档详细介绍了如何通过 Docker Compose 部署汉化版 n8n,包括中文界面、远程访问、数据持久化和功能增强等优化配置。中文界面:默认显示中文界面,降低使用门槛远程访问:通过 N8N_HOST=0.0.0.0 设置,支持从任意 IP 访问数据持久化:工作流数据存储在本地目录,升级或重启不丢失功能增强:启用工作流执行器,支持更多节点功能(如文件监听)此方案适用于开发测试和生产环境,相比官方默认部署提供了更好的用户体验和功能支持。

qq_40703755的博客 2261

基于cpolar的n8n内网穿透远程访问配置实践

本文介绍了在Windows环境下基于Docker部署n8n自动化系统的完整方案。首先详细说明了Docker Desktop的安装配置步骤,包括WSL2环境设置和镜像源优化。接着指导用户通过Docker命令快速部署n8n容器,并完成账号注册和License激活。最后以构建AI工作流为例,演示了如何整合本地Ollama大模型,实现自动化任务处理。该方案通过cpolar内网穿透技术解决了远程访问难题,为开发者提供了开箱即用的低代码自动化平台部署指南。

等风来 1482

自动化连接平台-n8n介绍与部署

8n8属于低代码/无代码工作流自动化工具,可实现需求最核心、最灵活的多平台入口连接中枢。

孤独的狼 1464

企业级n8n部署:从高可用架构到细粒度权限控制全指南

你是否正面临自动化流程中断风险?还在为团队权限管理混乱而头疼?本文将通过Docker容器化部署、PostgreSQL集群配置和企业级权限体系三步方案,帮助你构建99.9%可用的n8n自动化平台,同时实现工作流级别的访问控制。读完你将获得:生产环境部署架构图、高可用配置清单、RBAC权限设置指南以及常见故障排查手册。 ## 架构设计:构建高可用n8n集群 n8n的企业级部署需要从基础设施层保障服...

gitblog_00693的博客 877

n8n:1.18.2 本地镜像

docker n8n:1.18.2 本地镜像

无GPS室内飞行:基于PX4与MID360的FAST-LIO定点悬停实战解析

本文详细解析了基于PX4飞控与大疆MID360激光雷达的无GPS室内飞行技术,重点介绍了FAST-LIO算法在定点悬停中的应用。通过硬件配置、软件环境搭建、坐标系转换等实战经验,帮助开发者解决室内定位难题,实现精准悬停与稳定飞行。

weixin_29056781的博客 263

n8n - 使用 Docker Desktop 快速部署 n8n

本文介绍了在macOS上通过Docker快速部署n8n工作流自动化工具的方法。主要内容包括:安装Docker Desktop并配置环境;创建持久化数据卷确保配置文件安全;通过简单docker命令拉取并运行n8n容器;验证服务是否正常启动;还提供了基本认证、自动重启和连接外部数据库等高级配置选项。文末推荐使用组合命令"docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/

小工匠 5372

光模块组成

时钟恢复电路(Clock Data Recovery,简称CDR)是光模块中的关键组成部分,CDR的作用主要是从接收到的信号中提取出数据序列,并且恢复出与数据序列相对应的时钟时序信号,从而还原接收到的具体信息。因为光信号传输至一定距离的时候,通常是长距离传输,其波形会出现一定程度的失真,接收端接收到的信号是一个个长短不一的脉冲信号,这个时候在接收端,我们就无法得到我们需要的数据。所以,这个时候就需要有信号的再生,信号的再生功能为再放大、再整形和再定时,其中的再定时指的就是CDR时钟数据恢复。

han_better的博客 5729

n8n Docker 部署笔记

本文提供了在Ubuntu系统上使用Docker部署n8n自动化工作流平台的完整指南。从系统准备、Docker安装配置到n8n容器部署,详细介绍了每个步骤的关键命令和参数说明。部署过程包括创建持久化数据卷、设置时区、开放端口等注意事项,并提供了验证方法和常见问题排查技巧。通过本指南,用户可以快速搭建本地n8n实例,实现网页抓取、AI处理等自动化工作流,显著提升工作效率。文中还包含Terminator终端工具的使用技巧和快捷键参考。

2401_87761575的博客 2812

别再为倍福EL6021/EL6022的RS485接线头疼了!手把手教你硬件跳线与软件配置(附Modbus RTU主站例程)

本文详细解析了倍福EL6021/EL6022模块的RS485硬件跳线与软件配置方法,包括Modbus RTU主站编程实战。从端子定义、跳线操作到TwinCAT 3环境设置,提供完整的通信例程和故障排查技巧,帮助工程师快速解决工业现场通信问题。

weixin_30634661的博客 593

AD9176 双通道高速DAC调试记录

AD9176是一款高性能双通道16位数模转换器,支持高达12.6GSPS采样率,专为多频段无线应用设计。该器件集成8通道15.4Gbps JESD204B接口,支持复数/实数数据输入,每通道最大输入速率达3.08GSPS。关键特性包括:48位高精度NCO、灵活的插值滤波器(最高12倍)、优异的动态性能(SFDR达-83dBc@1.84GHz)以及多芯片同步功能。硬件调试需重点关注时钟配置(建议250M基准时钟)、JESD参数匹配及交流耦合设计。测试指标要求SFDR>55dBc@312MHz,实测值可达65d

universaldata的博客 1496

【Docker部署】一键教会你部署docker——以n8n为例

Docker 从零开始部署 n8n (Windows 环境)你之前的经历完美地证明了为什么 Docker 是运行 n8n 等应用的绝佳方式:它能彻底告别本地环境和依赖项冲突的烦恼。

qq_43025083的博客 4100

深度拆解 ‘High-Frequency Trading’ (HFT) 系统:解析如何在 100 纳秒内完成从网卡到 C++ 策略的响应

在100纳秒内完成从网卡到C++策略的响应,这是一项对技术栈每一个层面都进行极限优化的系统工程。它要求我们深入理解计算机体系结构、操作系统、网络协议和C++语言的底层机制。从物理距离的极致缩短,到高性能网卡和内核旁路技术,再到C++代码中每一个字节、每一个CPU周期的精打细算,HFT系统展现了人类对计算速度的永恒追求。这项技术不仅仅应用于金融交易,其背后的低延迟理念和实现方法,如DPDK、无锁编程、硬件加速等,正在逐渐渗透到其他对延迟敏感的领域,例如电信网络、边缘计算和工业自动化。

weixin_41455464的博客 1040
上一篇: Docker 容器化部署 Node.js 详细手册
下一篇: NVIDIA CUDA 镜像 Docker 容器化部署全流程
java_logo
博客等级 码龄18年 326粉丝 240原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值