本地部署 n8n 中文版

在技术团队寻求高效自动化解决方案的今天,n8n 作为一款安全的工作流自动化平台脱颖而出!它将代码的灵活性与低代码的便捷性深度融合,为开发者提供了独特的工具选择。
在这里插入图片描述

0. n8n的核心价值

n8n专为技术团队设计,支持400+集成与原生AI能力,其亮点包括:

  • 代码级控制:允许嵌入JavaScript/Python代码、调用npm包,同时保留可视化界面拖拽的易用性;
  • AI原生支持:基于LangChain框架构建AI智能体工作流,可自由接入私有数据与模型;
  • 完全自主掌控:通过**公平代码许可(Fair-code License)**实现自托管部署,保障数据隐私;
  • 企业级功能:提供RBAC权限管理、SSO单点登录及离线部署能力,满足严苛场景需求;
  • 活跃社区生态:拥有超87.8k GitHub星标、900+即用模板及477名贡献者,持续扩展能力边界。

1. 本地部署 n8n 中文版

接下来的操作以 n8n 的 1.90.2 版本为例。

拉取 n8n 镜像

docker pull docker.1ms.run/n8nio/n8n:1.90.2

创建 volume

创建 n8n 的数据 volume,

docker volume create n8n_data

创建 n8n 的多语言 volume,

mkdir -p /u01/data/n8n_i18n
cd /u01/data/n8n_i18n

下载 n8n 中文语言包

wget https://github.com/other-blowsnow/n8n-i18n-chinese/releases/download/n8n%401.90.2/editor-ui.tar.gz
tar -zxvf editor-ui.tar.gz

启动 n8n

docker run -d \
--name n8n \
-p 5678:5678 \
-v n8n_data:/home/node/.n8n \
-v /u01/data/n8n_i18n/dist:/usr/local/lib/node_modules/n8n/node_modules/n8n-editor-ui/dist \
-e N8N_DEFAULT_LOCALE=zh-CN \
-e N8N_SECURE_COOKIE=false \
-e N8N_RUNNERS_ENABLED=true \
-e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
docker.1ms.run/n8nio/n8n:1.90.2

2. 访问 n8n

使用浏览器打开 http://localhost:5678,注册一个新的账号,然后使用新注册的账号进行登陆,

在这里插入图片描述


参考资料:

<think>好的,我现在需要帮助用户解决在本地部署n8n的问题。根据用户提供的对话历史,他们之前已经询问过,并且我给出了一份详细的指南,现在用户再次询问,可能是需要更详细的信息或者遇到了问题。 首先,我要回顾之前的回答,确保这次回复不会重复,同时补充更多的细节。用户引用了多个站内资料,包括Docker部署、源码部署、常见问题以及AI工具包的相关内容。需要确保引用这些资料中的信息来增强回答的可信度。 用户这次的问题明确提到需要教程或安装指南,因此我需要分步骤说明,覆盖不同的部署方法,如Docker、npm、二进制文件等,并根据引用内容添加更多细节。比如,引用[1]和[2]提到Docker部署最快,适合新手,而引用[5]提到在MacOS上使用pnpm可能遇到的坑,需要特别指出。 还要注意用户可能的系统环境,比如Windows、MacOS或Linux,分别给出对应的步骤。例如,Docker在Windows需要Hyper-V和WSL2,这点在引用[1]中提到过,需要再次强调,避免用户安装失败。 另外,引用[4]提到AI入门工具包,可能用户对AI功能感兴趣,可以补充说明如何使用Docker Compose部署,提供相关命令和配置,这能增加回答的全面性。 需要检查是否有常见问题未覆盖,比如端口冲突、权限问题、数据持久化等,根据引用[3]和[5]中的内容,确保解决方案清晰易懂。例如,MacOS的EPERM错误可能与防病毒软件有关,需要提醒用户检查。 最后,生成相关问题,引导用户深入了解更多内容,比如性能优化、与其他工具集成等,参考之前的回答结构,保持一致性。 确保整个回答结构清晰,步骤详细,引用正确,并且语言简洁,避免技术术语过多,适合不同层次的用户理解。同时,验证所有命令的正确性,避免用户执行时出错。</think>### n8n 本地部署全方案详解(含避坑指南) #### 一、Docker 部署(最快方案,推荐新手) **核心优势**:跨平台支持,5分钟完成部署[^1] ```bash # 标准部署命令(适用所有系统) docker run -d \ --name n8n \ -p 5678:5678 \ -v ~/.n8n:/home/node/.n8n \ n8nio/n8n ``` **关键参数说明**: - `-v` 参数确保工作流数据持久化存储[^1] - `-p 5678:5678` 端口映射规则:`主机端口:容器端口` - **Windows 特别提示**:需启用 Hyper-V 和 WSL2(控制面板→程序→启用或关闭 Windows 功能)[^1] **避坑技巧**: 1. 若出现端口冲突: ```bash docker run -d -p 5679:5678 [...] # 修改主机端口为5679 ``` 2. MacOS 权限问题:关闭 Gatekeeper 或终端全盘访问权限[^5] #### 二、npm 直接安装(适合轻量使用) **环境要求**:Node.js ≥16.x + npm ≥7.x ```bash npx n8n ``` **优势**:无需安装依赖,自动配置SQLite数据库 **局限**:数据存储在内存中,重启后丢失(可通过 `--database=postgresdb` 参数指定外部数据库) #### 三、二进制文件部署(企业级方案) **适用场景**:需要高可用性生产环境 1. 下载对应平台二进制包 ```bash wget https://releases.n8n.io/n8n.linux chmod +x n8n.linux ``` 2. 配置 systemd 服务 ```ini [Unit] Description=n8n service After=network.target [Service] ExecStart=/path/to/n8n.linux --webhookUrl=https://your-domain.com Restart=always ``` #### 四、高级部署方案:AI 工具包集成(引用[4]) ```bash # 使用 Docker Compose 部署 AI 增强版 git clone https://github.com/n8n-io/ai-starter-kit.git cd ai-starter-kit docker-compose up -d ``` **包含组件**: - Ollama(本地AI模型) - Qdrant(向量数据库) - PostgresQL(关系型数据库) - 预置AI工作流模板 #### 五、开发模式部署(引用[5]) **前置条件**: - Node.js ≥16.x - pnpm ≥7.x(必须使用pnpm) ```bash git clone https://github.com/n8n-io/n8n.git cd n8n pnpm install # 注意必须用pnpm pnpm build N8N_ENCRYPTION_KEY=your_key pnpm start ``` **常见问题**: - `ERR_MODULE_NOT_FOUND`:删除 node_modules 重新执行 `pnpm install` - 内存不足:添加 `NODE_OPTIONS=--max-old-space-size=4096` --- ### 数据持久化配置方案 | 存储类型 | 配置方法 | 适用场景 | |----------------|-----------------------------------|------------------| | 本地文件系统 | `-v /host/path:/home/node/.n8n` | 单机部署 | | PostgreSQL | `DB_TYPE=postgresdb` + 连接参数 | 生产环境 | | MySQL | `DB_TYPE=mysqldb` + 连接参数 | 企业级部署 | | SQLite | 默认配置 | 开发测试 | --- ### 安全加固建议 1. 启用 HTTPS: ```bash docker run [...] -e N8N_PROTOCOL=https [...] ``` 2. 配置访问控制: ```bash -e N8N_BASIC_AUTH_ACTIVE=true \ -e N8N_BASIC_AUTH_USER=<用户名> \ -e N8N_BASIC_AUTH_PASSWORD=<密码> ``` 3. 加密敏感数据: ```bash -e N8N_ENCRYPTION_KEY=<32字符密钥> ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值