【n8n工作流入门02】macOS安装n8n保姆级教程：Homebrew与npm两种方式详解

n8n入门教程系列目录

【n8n入门教程01】n8n工作流自动化平台架构解析与核心概念详解

【n8n入门教程02】macOS安装n8n保姆级教程-Homebrew与npm两种方式详解

【n8n入门教程03】n8n变量配置与多输入数据合并完整指南

【n8n入门教程04】n8n权限与路径管理全指南：避免常见错误，保障数据安全

【n8n入门教程05】n8n Workflow编辑器完全指南：从入门到精通

【n8n入门教程06】n8n常用节点完全指南：从文件操作到代码执行

【n8n入门教程07】n8n插件机制与扩展方式完全指南

【n8n入门教程08】n8n触发节点完全指南：定时器、Webhook和手动触发

【n8n入门教程09】n8n Code与Execute Command节点深度对比与最佳实践

【n8n入门教程10】n8n本地程序集成完全指南：使用Execute Command节点

【n8n入门教程11】n8n大模型集成完全指南：调用OpenAI和Gemini API

【n8n入门教程12】n8n PDF翻译自动化实战：从英文PDF到中文PDF

【n8n入门教程13】n8n常见问题与调试技巧完全指南

n8n作为一款强大的工作流自动化工具，在macOS上的安装过程其实并不复杂。本文将详细介绍两种主流的安装方式------Homebrew和npm，并涵盖环境准备、权限配置、环境变量设置等关键环节，帮助你顺利开启自动化之旅。

安装前的准备工作

在正式开始安装之前，有一个关键的前置条件需要满足：你的系统必须安装Node.js 18或更高版本。n8n依赖于较新版本的Node.js，建议优先使用LTS（长期支持）版本以获得最佳兼容性和安全性。

为什么Node.js版本这么重要？因为n8n是基于Node.js构建的应用，不同版本的Node.js在API、性能优化和安全特性上都有差异。使用过旧的版本可能会导致n8n无法正常运行，或者出现各种兼容性问题。

接下来，我们将分别介绍两种主流的安装方式，你可以根据自己的使用习惯和需求选择最适合的一种。

通过Homebrew安装：macOS用户的最佳选择

如果你习惯使用Homebrew来管理开发环境，那么这绝对是你的首选方式。Homebrew作为macOS上最受欢迎的包管理器，能够自动处理依赖关系和路径配置，大大简化了安装过程。

安装步骤详解

第一步：安装Node.js

打开终端，输入以下命令安装Node.js的最新LTS版本：

bash 复制代码

brew install node

对于使用Apple Silicon芯片的Mac，Homebrew会自动适配ARM版本，无需额外配置。安装完成后，建议验证一下安装是否成功：

bash 复制代码

node -v
npm -v

确保Node.js版本在18以上，npm版本在8以上。

第二步：全局安装n8n

接下来，执行以下命令全局安装n8n：

bash 复制代码

npm install -g n8n

如果遇到权限错误（EACCES），可以使用sudo命令：

bash 复制代码

sudo npm install -g n8n

不过，更推荐的做法是按照npm官方指南调整权限设置，这样可以避免使用sudo带来的安全风险。

第三步：首次启动n8n

安装完成后，运行以下命令启动n8n服务：

bash 复制代码

n8n start

控制台会输出启动日志，你应该能看到类似"n8n ready on 0.0.0.0, port 5678"的信息。此时，打开浏览器访问http://localhost:5678，就能看到n8n的编辑器界面了。

第四步：后台运行（可选）

如果你希望n8n在后台持续运行，可以使用以下命令：

bash 复制代码

nohup n8n start > n8n.log 2>&1 &

或者使用PM2等进程管理工具来实现更专业的守护进程管理。

为什么选择Homebrew？

Homebrew的优势在于它能自动处理各种依赖关系，特别是在处理Apple Silicon和Intel架构的差异时，Homebrew会自动选择合适的版本。此外，通过Homebrew安装的软件更容易更新和管理，维护成本相对较低。

通过npm直接安装：灵活度更高的选择

如果你不使用Homebrew，或者希望对Node.js版本有更精细的控制，直接通过npm安装也是一个不错的选择。这种方式适合那些喜欢手动管理环境的开发者。

安装步骤详解

第一步：安装Node.js

从Node.js官网下载适合你Mac架构的安装包（Apple Silicon或Intel版本）。安装时建议勾选"Add to PATH"选项，这样就可以在全局范围内使用node和npm命令了。

安装完成后，同样需要验证Node.js版本是否满足要求（>=18）。

第二步：全局安装n8n

在终端执行以下命令：

bash 复制代码

npm install -g n8n

如果遇到权限问题，同样可以使用sudo。安装完成后，运行n8n start启动服务。

第三步：使用npx试用（可选）

如果你只是想快速体验一下n8n，而不想全局安装，可以使用npx：

bash 复制代码

npx n8n

不过需要注意的是，这种方式每次启动都需要重新下载，不够高效。因此，如果你打算长期使用n8n，还是建议使用全局安装的方式。

安装方式选择建议

对于大多数macOS用户，我推荐直接使用npm安装而不是npx试用。这样下次启动的时候可以迅速恢复环境，无需等待下载。同时，全局安装也更适合生产环境的使用。

配置安装路径与权限

安装完成后，合理的路径和权限配置是保障工作流稳定运行的关键。这部分内容虽然看起来有些技术性，但对于后续的使用体验影响很大。

了解安装路径

对于使用Homebrew安装的Apple Silicon芯片Mac，Node.js默认安装在/opt/homebrew/bin/node。n8n全局安装后，模块会位于npm的全局路径下，通常是/opt/homebrew/lib/node_modules。

你可以使用以下命令查看n8n可执行文件的具体位置：

bash 复制代码

which n8n

对于Intel芯片的Mac，安装路径会有所不同，但基本原理是一样的。一般情况下无需修改这些路径，但如果你需要在其他环境中使用n8n，可以将全局bin路径添加到$PATH环境变量中。

文件读写权限配置

n8n默认以当前用户的权限运行。如果你的工作流需要访问本地文件系统，就要确保n8n进程对相关路径有足够的读写权限。

建议使用绝对路径来指定文件位置，例如：

复制代码

/Users/你的用户名/Documents/n8n/...

在使用前，最好提前创建这些目录，这样可以避免"Permission denied"错误。如果遇到权限问题，可以使用chmod命令调整目录权限，或者将n8n运行在有足够权限的用户下。

完成路径和权限配置后，建议尝试运行一个简单的工作流，验证n8n能否正常读写本地文件。这可以及早发现潜在的问题。

环境变量配置：让n8n更符合你的需求

n8n支持通过环境变量来自定义各种配置，这让系统具有了很强的灵活性。首次运行后，你可以创建配置文件目录并添加各种配置。

创建配置目录

在用户主目录下创建.n8n目录（如果不存在的话），用于存放配置文件：

bash 复制代码

mkdir ~/.n8n

常用环境变量配置

下面是一些最常用的环境变量及其作用：

环境变量	作用	示例
N8N_BASIC_AUTH_ACTIVE	激活基本认证	N8N_BASIC_AUTH_ACTIVE=true
N8N_BASIC_AUTH_USER	设置登录用户名	N8N_BASIC_AUTH_USER=admin
N8N_BASIC_AUTH_PASSWORD	设置登录密码	N8N_BASIC_AUTH_PASSWORD=your_password
N8N_DEFAULT_BINARY_DATA_MODE	二进制数据存储模式	N8N_DEFAULT_BINARY_DATA_MODE=filesystem
N8N_DEFAULT_LOCALE	默认语言	N8N_DEFAULT_LOCALE=en
EXECUTIONS_DATA_PRUNE	执行数据自动清理	EXECUTIONS_DATA_PRUNE=true
EXECUTIONS_DATA_MAX_AGE	执行数据最大保留时间（小时）	EXECUTIONS_DATA_MAX_AGE=168
N8N_LOG_LEVEL	日志级别	N8N_LOG_LEVEL=info
N8N_METRICS	开启指标监控	N8N_METRICS=true

关键配置说明

基本安全配置

默认情况下，n8n没有任何认证保护，任何人只要能访问本地的5678端口就能打开编辑器。这在局域网环境下存在安全风险。因此，强烈建议启用基本认证：

bash 复制代码

export N8N_BASIC_AUTH_ACTIVE=true
export N8N_BASIC_AUTH_USER=admin
export N8N_BASIC_AUTH_PASSWORD=your_secure_password

数据存储模式

如果你的工作流需要处理大文件，建议将二进制数据存储模式设置为文件系统：

bash 复制代码

export N8N_DEFAULT_BINARY_DATA_MODE=filesystem

这样可以避免大文件占用过多内存，提高系统稳定性。

默认语言设置

bash 复制代码

export N8N_DEFAULT_LOCALE=en

需要注意的是，目前n8n的中文界面可能还不够完善，建议先使用英文界面。

执行数据管理

为了避免数据库文件无限增长，建议启用执行数据自动清理：

bash 复制代码

export EXECUTIONS_DATA_PRUNE=true
export EXECUTIONS_DATA_MAX_AGE=168

这会自动清理超过7天（168小时）的历史执行数据。

日志与调试

如果需要更详细的日志信息，可以调整日志级别：

bash 复制代码

export N8N_LOG_LEVEL=debug

开启指标监控可以帮助你了解n8n的运行状态：

bash 复制代码

export N8N_METRICS=true

环境变量的持久化

你可以将这些环境变量添加到Shell配置文件中（~/.bashrc或~/.zshrc），这样每次打开终端时都会自动加载：

bash 复制代码

echo 'export N8N_BASIC_AUTH_ACTIVE=true' >> ~/.zshrc
echo 'export N8N_BASIC_AUTH_USER=admin' >> ~/.zshrc
echo 'export N8N_BASIC_AUTH_PASSWORD=your_password' >> ~/.zshrc

或者，你也可以将这些配置写入~/.n8n/config文件，n8n启动时会自动读取。

设置完成后，记得重启n8n使配置生效。更多详细的配置方式，可以参考n8n官方配置文档。

首次启动与账户创建

完成所有安装和配置后，就可以正式启动n8n了。在终端中运行：

bash 复制代码

n8n start

然后打开浏览器访问http://localhost:5678。

首次打开n8n时，系统会提示你创建用户账户。你需要填写邮箱、姓名和密码等信息。这些信息将用于登录n8n的Web界面。

创建账户后，你就可以进入n8n的编辑器UI了。从这里开始，你就可以创建各种自动化工作流，将n8n的强大功能应用到实际工作中。

总结

在macOS上安装n8n其实并不复杂，关键在于选择合适的安装方式，并做好必要的配置。无论是使用Homebrew还是npm，都能快速搭建起一个功能完整的n8n环境。

记住几个关键点：

确保Node.js版本在18以上
根据使用习惯选择Homebrew或npm安装方式
合理配置安装路径和文件权限
启用基本认证保障安全
配置环境变量优化系统性能

现在，你已经拥有了一个运行良好的n8n环境，可以开始探索工作流自动化的无限可能了。无论是简单的数据同步，还是复杂的业务流程自动化，n8n都能帮你轻松实现。

原文链接:macOS安装n8n保姆级教程：Homebrew与npm两种方式详解