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