自托管 n8n 指南get.n8n.io 一行脚本装好 5678 端口的本地工作流平台【免费下载链接】n8nFair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400 integrations.项目地址: https://gitcode.com/GitHub_Trending/n8/n8n你面前是一台装好 Docker 的干净机器终端里一个空目录。按这个顺序走完你会在机器上得到一个自托管 n8n 实例——n8n 是自带 AI 能力、集成 400 多个服务的可视化工作流平台——然后打开浏览器进入http://localhost:5678直接开始拖节点、连触发器。全程主路径只有一行命令官方的一行安装脚本用 docker compose 一次性拉起 n8n 本体、跑 Code 节点代码的任务 runners、AI 沙箱和 SearXNG 搜索服务并且会一直等到健康检查通过才宣布结束。开工前 30 秒四项检查定成败脚本落地的第一动作不是装东西而是确认你不在一个必败的环境里。四项检查都有明确判定标准不满足时它直接报错并给出修复路径检查项判定标准不满足怎么办Docker 守护进程docker info成功先启动 DockerDesktop 或systemctl start dockerPodman、Colima 这类兼容引擎需要把DOCKER_HOST指到它们的 socketCompose v2 插件docker compose version有输出安装 compose 插件旧的独立二进制docker-compose不受支持5678 端口空闲127.0.0.1:5678上没有任何进程应答端口被占会直接终止先停掉占用进程再重跑安装目录默认./n8n不存在或是空的用N8N_DIR./some-dir换个目录非空目录会被拒绝写入四项都绿了就可以敲最短的版本主路径一行命令脚本替你干完五件事curl -fsSL https://get.n8n.io | sh脚本源码就在仓库 docker/get-n8n.sh想先审查再执行的话存成文件看一眼再跑curl -fsSL https://get.n8n.io -o get-n8n.sh less get-n8n.sh sh get-n8n.sh回车之后后台按这个顺序发生锁版本。查 GitHub 最新稳定 release以N8N_VERSION的形式写进.env。故意不用浮动 tag——那样容器一重建就会静默升级并触发数据库迁移查询失败时回退到内置的2.32.0。生成三个文件。落在./n8n下compose.yml完整栈定义下载一次后归你所有脚本以后永不重写它、.env权限 600内含本次安装随机生成的唯一密钥、searxng-settings.yml。拉镜像并启动。首次拉取可能要几分钟随后docker compose up -d拉起全部服务。等就绪。每 3 秒轮询一次http://127.0.0.1:5678/healthz最多 180 秒——首次启动还要跑数据库迁移所以给了足够宽的时间。打印摘要。运行地址、数据位置、配置文件路径、启停命令加安全提示一次给全。几个变体按需拼在后面# 指定版本要求 x.y.z 三段式 curl -fsSL https://get.n8n.io | sh -s -- --version 2.32.0 # 只写配置文件不拉镜像、不启动 curl -fsSL https://get.n8n.io | sh -s -- --no-start # 只打印脚本版本和将安装的 n8n 版本零副作用 curl -fsSL https://get.n8n.io | sh -s -- --version另有N8N_DIR环境变量改安装目录DO_NOT_TRACK1让安装失败时不再询问是否发送匿名失败报告报告只含脚本版本、系统名、安装模式和失败步骤默认不发送。拿到入口两秒确认服务活着数据落在哪成功时摘要会打印n8n is running at: http://localhost:5678。别只听脚本自己说独立复核一次curl http://127.0.0.1:5678/healthz docker compose -f n8n/compose.yml ps第二条命令应看到n8n、sandbox-api、sandbox-runner-1、runners、searxng五个服务全部 running另有一次性证书引导容器sandbox-certs以退出码 0 结束——这正是仓库 e2e 测试断言的基准。然后浏览器打开http://localhost:5678数据方面工作流存在 SQLite 数据库里由 Docker 卷n8n-data挂载到容器内/home/node/.n8n同目录还放着 webhook URL 和凭据加密密钥。最要命的细节在镜像 README里启动时如果找不到这些数据n8n 会静默生成一套新密钥已有凭据从此无法解密。所以n8n-data是唯一值得备份的东西。后续动作升级、停、删停和起是日常高频操作docker compose -f n8n/compose.yml down # 停 docker compose -f n8n/compose.yml up -d # 起在已有安装上不带--upgrade重跑一行脚本是安全的 no-op一个文件都不改只汇报当前状态、启动地址和升级命令。升级只需要加一个标志curl -fsSL https://get.n8n.io | sh -s -- --upgrade它的动作刻意收敛到最小只改.env里的N8N_VERSION一行可搭配--version x.y.z指定目标版本然后拉镜像、重启其余配置和密钥一概不碰。顺手它还会比对本地compose.yml与线上栈定义头部的版本标记官方栈更新过就会提醒你去看变更但不会替你改写文件。删之前先把后果说透这条命令会删除全部 n8n 数据——down -v连带删掉n8n-data卷rm -rf删掉整个配置目录工作流和凭据全部清空docker compose -f n8n/compose.yml down -v rm -rf n8n急救四条报错原文直接对号入座首次安装翻车基本落在这四种情况按症状 → 处方记端口被占something is already listening on port 5678→ 停掉占用进程重跑或加--no-start先落配置手动改n8n/compose.yml里的端口映射再启动。目录非空exists and is not empty — refusing to write→ 加N8N_DIR./some-dir换目录重来。Docker Hub 限流Docker Hub pull rate limit reached→ 配置不受影响等约一小时后docker compose -f n8n/compose.yml up -d或docker login提高限额再重跑脚本。就绪超时180 秒内/healthz始终不通→docker compose -f n8n/compose.yml logs n8n原因基本都在日志里。边界声明这套一行部署栈定义见 docker/get-n8n-compose.yml的定位是本地试用。安全上只有一条硬规则对外暴露的端口只允许 5678sandbox-runner-1是特权 Docker-in-Docker 容器、永远不要发布它的端口其余服务只在 compose 网络内以服务名互访。TLS、Postgres、队列模式这些生产级需求得另起一套部署方案。从一台干净机器到一个能打开就用起来的本地工作流平台5678 这一条路走通就够了。【免费下载链接】n8nFair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400 integrations.项目地址: https://gitcode.com/GitHub_Trending/n8/n8n创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
