在 macOS 上安装与运行 n8n（不使用 Docker）

bossbird

在 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 试用。关闭后需重新下载。
  

[size=0.875][size=0.875]安装方式推荐
[size=0.875]推荐直接使用 npm 安装而不是 npx 试用，这样下次启动的时候可以迅速恢复环境。

完成上述任一安装方式后，建议检查 n8n 可执行文件路径和权限设置，确保后续工作流能正常访问本地资源。

配置安装路径与权限

在 n8n 安装完成后，合理配置路径和权限是保障工作流稳定运行的关键。下面简要介绍常见配置场景：

• Homebrew 安装时，对于 Apple Silicon 芯片，Node.js 默认在 /opt/homebrew/bin/node。n8n 全局安装后，模块位于 npm 全局路径（如 /opt/homebrew/lib/node_modules）。可用 which n8n 查看可执行文件路径。一般无需修改，但如需在其他环境使用，可将全局 bin 路径加入 $PATH。对于 Intel 芯片，安装路径会有差异。
• 文件读写权限方面，n8n 默认以当前用户权限运行。若工作流需访问本地文件，请确保 n8n 进程对相关路径有权限。建议使用绝对路径（如 /Users/<用户名>/Documents/n8n/...），并提前创建目录，避免 “Permission denied” 错误。
  

完成路径和权限配置后，建议尝试运行一个简单工作流，验证 n8n 能正常读写本地文件。

设置环境变量和配置

n8n 支持通过环境变量来自定义配置。首次运行后，你可以创建配置文件目录并添加配置，例如：在用户主目录创建 ~/.n8n 目录（如不存在）用于存放配置文件。常见的环境变量包括：

配置说明

• 基本安全：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 使其生效。详细配置方式见 n8n配置文档 帖子。

完成所有安装和配置后，访问 http://localhost:5678 打开 n8n Web 界面。首次打开会提示你创建用户帐户（填写邮箱、姓名和密码），随后即可进入 n8n 编辑器 UI，开启自动化之旅。