n8n安装教程一键打造免费开源的AI自动化工具

在AI工具日益普及的今天，如何快速上手一款强大的自动化工具，已经成了职场人和企业老板的刚需。不管是想简化重复性任务，还是打通不同软件之间的数据流转，AI自动化工作流迟早会成为所有人的标配。这篇文章就来聊聊n8n——一个开源、可自托管的自动化利器，并且把安装和基本设置掰开揉碎了讲清楚。无论你是技术小白还是有一定经验的老手，跟着走一遍，都能顺利迈出第一步。

为什么选择n8n？

市面上的自动化工具不少，但n8n凭借开源、可自托管和高度的可定制性，硬是在Zapier这类商业化产品之外杀出了一条路。不仅免费，还能按需二次开发，打造完全属于自己的自动化工作流。不管是个人用还是企业用，灵活性都足够。

安装n8n的前置条件

动手之前，先确认几样东西是否就位：

• Node.js：n8n基于Node.js开发，需要先装好。推荐使用LTS（长期支持）版本。（官网：https://nodejs.org/en）
• npm：Node Package Manager，通常和Node.js一起装好。
• 数据库（可选）：n8n默认用SQLite，但生产环境建议上PostgreSQL这种更稳的数据库。（官网：https://www.postgresql.org）

一、通过npm安装n8n

这是最常用也最简单的安装方式，尤其适合开发者和技术爱好者。

步骤1：安装Node.js和npm

如果还没装，去Node.js官网下载最新的LTS版本（一般用Mac或Linux服务器），按提示装好。装完后在终端确认一下：

node -v
npm -v

步骤2：全局安装n8n

打开终端或命令提示符，执行：

npm install n8n -g

装完后直接输入n8n启动，默认监听在http://localhost:5678，浏览器打开就能看到n8n的工作界面。

二、使用Docker安装n8n

习惯用Docker的朋友，用容器部署n8n也很方便。

步骤1：安装Docker

先去Docker官网（https://www.docker.com）下载对应操作系统的版本，装好并启动。

步骤2：拉取n8n镜像

在Docker Desktop的搜索框里输入n8n，选择n8nio/n8n官方镜像，点击Pull拉取。

步骤3：运行容器

下载完成后，在Images列表中找到n8nio/n8n，点击运行。第一次运行会弹窗让你填信息：

• Host Port：填5678
• Volumes：Host path创建一个名为n8n的目录，Container Path填/home/node/.n8n/——这一步是为了把n8n的数据目录映射到宿主机，防止容器升级时数据被清空。

填好点Run，等启动完成，点击http://localhost:5678（记得提前设置防火墙允许5678端口），浏览器就能打开n8n界面。首次访问需要设置邮箱、用户名和密码。

三、基本配置与设置

装好之后，按需做点微调，让n8n跑得更顺手。

1. 修改默认端口（可选）

默认端口5678如果被占用，或者你想换一个，可以通过环境变量修改。例如改成4000：

n8n start --port=4000

Docker方式则用：

docker run -it --rm \
  --name n8n \
  -p 4000:4000 \
  -e N8N_PORT=4000 \
  n8nio/n8n

2. 设置数据库（推荐）

虽然SQLite够用，但生产环境建议用PostgreSQL，数据更稳定持久。步骤如下：

• 确保PostgreSQL服务已启动
• 创建n8n数据库和用户，执行SQL：

CREATE DATABASE n8n;
CREATE USER n8nuser WITH ENCRYPTED PASSWORD 'yourpassword';
GRANT ALL PRIVILEGES ON DATABASE n8n TO n8nuser;

• 启动n8n时设置环境变量：

export DB_TYPE=postgresdb
export DB_POSTGRESDB_HOST=localhost
export DB_POSTGRESDB_PORT=5432
export DB_POSTGRESDB_DATABASE=n8n
export DB_POSTGRESDB_USER=n8nuser
export DB_POSTGRESDB_PASSWORD=yourpassword
n8n start

3. 启用HTTPS（可选）

生产环境下，建议用反向袋里（比如Nginx）配置HTTPS，保证数据传输安全。

四、首次登录与初始设置

启动后浏览器访问http://localhost:5678，看到欢迎界面。第一次访问需要设置用户名和密码，之后会提示填写基本信息，可以跳过。

进入主界面后，建议立刻上手：

• 点击“Create your first workflow”进入编辑界面
• 从左侧拖拽节点（如OpenAI、HTTP Request、Function等）到工作区，开始构建自动化流程
• 设计完成后点Sa ve保存，然后点Test Workflow试运行

五、常见问题与解决方案

1. n8n无法启动

• 检查Node.js版本是否为最新的LTS
• 确认端口是否被占用，换个端口试试

2. 无法连接到数据库

• 确认PostgreSQL服务是否启动，用户名密码是否正确
• 如果数据库在远程，检查网络和防火墙设置

3. 工作流无法执行

• 检查每个节点的配置，尤其是API密钥和连接信息
• 查看n8n的运行日志，根据错误信息排查

结语：迈出自动化的第一步，探索n8n的无限可能

跟着这篇指南走下来，你应该已经成功装好n8n并完成了基本配置。它的可定制性和广泛的集成支持，让它成为构建AI自动化工作流的理想选择。无论是简化个人任务还是优化企业流程，n8n都能给你足够强大的支撑。接下来就动手试试吧，自动化的大门已经打开了。