在 macOS 上安装与运行 n8n（不使用 Docker）
本章将带你系统了解如何在 macOS 本地环境下安装和运行 n8n。无论你是自动化初学者还是有经验的开发者，都可以通过 Homebrew 或 npm 两种主流方式快速部署 n8n。章节内容涵盖环境准备、安装流程、权限配置、环境变量设置等关键环节，帮助你顺利开启自动化之旅。
在正式安装前，请确保你的系统已安装 Node.js 18+。n8n 依赖于较新版本的 Node.js，建议优先使用 LTS 版本以获得最佳兼容性和安全性。接下来，我们将分别介绍两种主流安装方式，并在每个环节给出实用建议。
通过 Homebrew 安装
如果你习惯使用 Homebrew 管理开发环境，推荐采用此方式。Homebrew 能自动处理依赖和路径，适合 macOS 用户。
下面的列表详细介绍了 Homebrew 安装流程，每一步都配有简要说明，帮助你理解背后的原理：
- 安装 Node.js：
打开终端，使用 Homebrew 安装 Node.js 最新 LTS 版本：
brew install node。Apple Silicon 架构会自动适配 ARM 版本。安装完成后，输入node -v和npm -v验证版本（应为 Node 18+，npm 8+）。 - 全局安装 n8n：
执行
npm install -g n8n安装 n8n。如遇权限错误（EACCES），可用sudo npm install -g n8n或参考 npm 官方指南调整权限。 - 首次启动 n8n：
安装完成后，运行
n8n start启动服务。控制台会输出启动日志，显示如 “n8n ready on 0.0.0.0, port 5678”。默认编辑器界面监听 http://localhost:5678。 - 后台运行（可选）：
可用
nohup n8n start > n8n.log 2>&1 &后台运行，或用 PM2 等工具守护进程。
完成上述步骤后，你已在本地成功部署 n8n。接下来将介绍无需 Homebrew 的 npm 安装方式。
通过 npm 安装
如果你不使用 Homebrew，也可以直接通过 npm 安装 n8n。此方法适合希望手动管理 Node.js 版本和全局包的用户。
以下列表详细说明了 npm 安装流程，并在每步前给出简要说明：
- 安装 Node.js： 从 Node.js 官网下载安装包，选择适合 Mac 架构的版本（Apple Silicon 或 Intel）。建议安装时勾选 “Add to PATH”，以便全局使用 node/npm 命令。安装后验证 Node.js 版本需 >=18。
- 全局安装 n8n：
终端运行
npm install -g n8n安装最新 n8n。如遇权限错误可用sudo。安装完成后，运行n8n start启动服务。 - 使用 npx 试用（可选）：
不安装也可用
npx n8n临时启动 n8n 试用。关闭后需重新下载。
npm 安装而不是 npx 试用，这样下次启动的时候可以迅速恢复环境。完成上述任一安装方式后，建议检查 n8n 可执行文件路径和权限设置，确保后续工作流能正常访问本地资源。
配置安装路径与权限：
在 n8n 安装完成后，合理配置路径和权限是保障工作流稳定运行的关键。下面简要介绍常见配置场景：
- Homebrew 安装时，Node.js 默认在
/usr/local/Cellar/node/，brew 会自动链接到/usr/local/bin。n8n 全局安装后，模块位于 npm 全局路径（如/usr/local/lib/node_modules/n8n）。可用which n8n查看可执行文件路径。一般无需修改，但如需在其他环境使用，可将全局 bin 路径加入$PATH。 - 文件读写权限方面，n8n 默认以当前用户权限运行。若工作流需访问本地文件，请确保 n8n 进程对相关路径有权限。建议使用绝对路径（如
/Users/<用户名>/Documents/n8n/...），并提前创建目录，避免 “Permission denied” 错误。
完成路径和权限配置后，建议尝试运行一个简单工作流，验证 n8n 能正常读写本地文件。
设置环境变量和配置：n8n 支持通过环境变量来自定义配置。首次运行后，你可以创建配置文件目录并添加配置，例如：在用户主目录创建 ~/.n8n 目录（如不存在）用于存放配置文件。常见的环境变量包括：
为提升安全性和可维护性，n8n 支持多种环境变量和配置项。下表简要介绍常用环境变量及其作用：
| 环境变量 | 作用 | 示例 |
|---|---|---|
| N8N_BASIC_AUTH_ACTIVE | 激活基本认证 | N8N_BASIC_AUTH_ACTIVE=true |
| N8N_BASIC_AUTH_USER / PASSWORD | 设置登录用户名/密码 | N8N_BASIC_AUTH_USER=admin |
| N8N_DEFAULT_BINARY_DATA_MODE | 二进制数据存储模式 | N8N_DEFAULT_BINARY_DATA_MODE=filesystem |
| N8N_DEFAULT_LOCALE | 默认语言 | N8N_DEFAULT_LOCALE=en |
| EXECUTIONS_DATA_PRUNE / MAX_AGE | 执行数据自动清理 | EXECUTIONS_DATA_PRUNE=true |
| N8N_LOG_LEVEL | 日志级别 | N8N_LOG_LEVEL=info |
| N8N_METRICS | 开启指标监控 | N8N_METRICS=true |
你可以将上述环境变量添加到 shell 配置文件（~/.bashrc 或 ~/.zshrc），或写入 ~/.n8n/config 文件以在启动 n8n 时自动加载。设置完成后，重启 n8n 使其生效。
完成所有安装和配置后，访问 http://localhost:5678 打开 n8n Web 界面。首次打开会提示你创建用户帐户（填写邮箱、姓名和密码），随后即可进入 n8n 编辑器 UI，开启自动化之旅。
- 基本安全：
N8N_BASIC_AUTH_ACTIVE=true激活基本认证，设置N8N_BASIC_AUTH_USER和N8N_BASIC_AUTH_PASSWORD来开启访问 n8n 编辑界面的用户名/密码登录（默认无认证，任何人能访问本地 5678 端口即可以打开编辑器，为安全起见建议启用）。 - 数据存储模式：
N8N_DEFAULT_BINARY_DATA_MODE=filesystem将二进制数据（如文件内容）存储在文件系统而非内存中，以提高处理大文件时的性能。 - 默认语言：
N8N_DEFAULT_LOCALE=en设置界面和消息的默认语言（中文用户界面目前可能不全，可先保持 en）。 - 执行数据管理：
EXECUTIONS_DATA_PRUNE=true和EXECUTIONS_DATA_MAX_AGE=168(小时) 用于自动清理超过 7 天的历史执行数据，防止数据库文件过大。 - 日志与调试：
N8N_LOG_LEVEL=info设置日志级别（可选debug获取更详细日志）；N8N_METRICS=true开启指标监控端口等。
你可以将上述环境变量添加到 shell 配置文件（~/.bashrc 或 ~/.zshrc）中，或写入 ~/.n8n/config 文件以在启动 n8n 时自动加载。设置完成后，重启 n8n 使其生效。
完成安装和配置后，访问 http://localhost:5678 打开 n8n Web 界面。首次打开会提示你创建一个用户帐户（填写电子邮件、姓名和密码）并登录，然后即可进入 n8n 的编辑器 UI。