启动 n8n 步骤指南

一、基于 Node.js 安装启动

1. 确认 Node.js 环境：

• 打开命令行工具。在 Windows 系统中，可以通过搜索 “命令提示符” 打开。
• 在命令行中输入 “node -v” 命令并回车。如果系统显示 Node.js 的版本号，如 “v22.15.0”等版本信息，则说明 Node.js 已安装。若未安装，需访问 Node.js 官网（Node.js — Run JavaScript Everywhere ），根据系统类型下载对应的安装包进行安装。安装过程中按照提示逐步操作即可。

1. 安装 n8n：

• 在确认 Node.js 安装完成后，保持命令行工具打开状态，输入 “npx n8n” 命令并回车。
• 此时，npx（Node.js 包执行工具）会自动下载并运行最新版 n8n。这个过程可能需要一些时间，具体时长取决于网络状况等因素。在下载和安装过程中，命令行界面会显示相关的进度信息。

1. 启动 n8n：

• 安装完成后，在命令行界面中会提示相关信息。此时，按字母 “O”（大写或小写均可），系统会自动打开默认浏览器，并进入 n8n 的初始化界面。若浏览器未自动打开，可以手动在浏览器地址栏输入 “http://localhost:5678” 并回车，同样可以进入 n8n 的初始化界面。n8n 默认监听 5678 端口，如果该端口被占用，启动可能会失败，你需要更改端口设置或关闭占用该端口的程序。

二、基于 Docker 安装启动

1. 安装 Docker Desktop：

• 访问 Docker 官方网站（Docker: Accelerated Container Application Development ）。
• 导航至 “Products> Docker Desktop”。
• 根据操作系统选择合适的版本：
• Windows 用户选择 “Docker Desktop for Windows” 进行下载。下载完成后，双击安装包，按照安装向导的提示完成安装。安装完成后，可能需要重启电脑以使设置生效。
• 安装完成后，启动 Docker Desktop。在终端 / 命令行运行 “docker --version”，如果显示类似 “Docker version 20.10.17, build 100c701” 的输出，则说明 Docker 安装成功。

1. 获取 n8n 官方镜像：

• 打开 Docker Desktop 应用，点击顶部搜索框，输入 “n8n”。
• 从搜索结果中选择官方镜像 “n8nio/n8n”。
• 在电脑上选择一个合适的位置创建一个目录，该目录用于存储 n8n 的数据，注意目录路径不要包含中文字符。例如，在 Windows 系统中可以创建 “C:\n8n_data” 目录。
• 回到 Docker，选择 “Images”，找到刚才下载的 “n8nio/n8n” 镜像。

1. 创建并配置 n8n 容器：

• 在 Docker Desktop 中切换到 “Images” 标签页。
• 找到已下载的 “n8nio/n8n” 镜像，点击右侧的三角运行图标。
• 首次运行时需要配置以下参数：
• 端口设置 (Ports)：将容器端口 5678 映射到主机端口 5678。这样在浏览器中通过 “http://localhost:5678” 就可以访问 n8n。如果主机的 5678 端口已被占用，可以将主机端口改为其他未被占用的端口，如将 “5678:5678” 改为 “8080:5678”，那么后续访问 n8n 的地址就是 “http://localhost:8080”。
• 数据卷设置 (Volumes)：点击 “Volumes” 选项卡，添加一个卷映射。“Host path” 选择之前创建的数据存储目录；“Container path” 填写 “/home/node/.n8n/”。卷映射非常重要，它将 n8n 的数据存储目录映射到 Docker 容器外部，确保在容器重启或重新创建时数据不会丢失。

1. 启动 n8n 容器：

• 完成上述配置后，点击 “Run” 按钮启动 n8n 容器。
• 启动过程可能需要约 1 分钟来初始化。可以在 “Logs” 选项卡中查看启动日志。当看到类似 “2025 - 05 - 02 10:36:40 Editor is now accessible via: 2025 - 05 - 02 10:36:40 http://localhost:5678/” 的日志时，表示 n8n 启动成功。

三、访问与初始化 n8n

1. 访问 n8n 界面：

• 无论采用哪种安装方式，启动成功后，在浏览器地址栏输入 “http://localhost:5678”（如果在配置端口时修改了主机端口，需将 5678 替换为对应的端口号）并回车。
• 首次访问 n8n 会看到登录界面，需要创建管理员账户。按照界面提示，输入用户名和密码等信息完成管理员账户的创建。
• 之后，可能会提示填写基本使用目的，这一步是可选的，可以根据实际情况填写或跳过。完成这些操作后，即可进入 n8n 主界面，开始创建工作流等操作。

1. 后续配置（可选）：

• 如果需要在生产环境中使用 n8n，并且希望通过 HTTPS 访问，可以通过反向代理如 Nginx 实现配置 HTTPS。具体配置过程较为复杂，需要根据 Nginx 的相关知识和服务器环境进行设置。
• 还可以通过环境变量或配置文件对 n8n 进行调优。例如，默认使用 5678 端口，可通过 “N8N_PORT” 环境变量修改端口；如果需要外部服务触发工作流，需配置 “N8N_HOST” 和 “N8N_PROTOCOL” 确保生成正确的 Webhook URL 等。