一行拉起 n8n 自托管完整栈get.n8n.io 快速部署指南【免费下载链接】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/n8nn8n 自托管不必再手工拼装从 get.n8n.io 取到一行安装脚本docker compose 会把 n8n 本体、任务 runners 与 AI 沙箱一并拉起来浏览器打开 localhost:5678 就能建工作流。 一条命令到底拉起了什么第一次跑的时候整个过程像黑盒。动手前先摸清楚脚本内部依次做的五件事心里就有全局图了定版本。默认去查最新稳定 release查不到就退回脚本里内置的2.32.0版本号随后以N8N_VERSION形式写死进.env故意不挂浮动 tag——否则容器哪天重建会静默升版本并顺手触发数据库迁移。落三个文件。在当前目录下的./n8n里生成compose.yml栈定义只下载这一次之后归你所有脚本永不改写、.env权限 600装着本次安装随机生成的一套唯一密钥、searxng-settings.yml。拉镜像并启动。首次拉镜像可能要几分钟随后docker compose up -d把整组服务放到后台跑。等就绪。每 3 秒戳一次http://127.0.0.1:5678/healthz最多耐心等 180 秒——首轮还要跑数据库迁移属于正常耗时。打摘要。全通过后输出访问地址、数据落在哪、配置放在哪、怎么停怎么起外加几句安全提醒。跑之前的三件事脚本开工前会先过一遍环境体检任何一项不过关都会停下来告诉你怎么修检查项快速确认命令不满足时的提示Docker 守护进程活着docker info报错就装 Docker 或把 daemon 拉起来Podman、Colima 也能用但得配带 compose 插件的 docker CLI并用DOCKER_HOST指到它们的 socketCompose v2 插件就位docker compose version跑不通说明插件缺失独立的docker-compose二进制不在支持范围内5678 端口没人占curl -s http://127.0.0.1:5678/只要有任何应答哪怕是连接被接受就会判定端口占用并终止先把占用进程停掉安装目录是干净的ls ./n8n默认目录./n8n不允许已存在且非空旧内容挪走或用N8N_DIR换个新目录四项都绿的话就可以真正开始部署了。✅ 安装与确认闭环最直接的玩法把远端脚本直接喂给 sh一行搞定curl -fsSL https://get.n8n.io | sh如果想先审一遍脚本内容再执行可以先用-o get-n8n.sh存成本地文件less看完再sh get-n8n.sh。两个变体按需替换参数即可# 指定版本必须三段式比如 2.32.0 curl -fsSL https://get.n8n.io | sh -s -- --version 2.32.0 # 只生成三个配置文件不拉镜像、不启动 curl -fsSL https://get.n8n.io | sh -s -- --no-start另外两个环境变量值得知道N8N_DIR改安装目录DO_NOT_TRACK1让脚本在安装或升级失败时不再询问是否提交匿名故障报告只含脚本版本、系统名、模式和失败步骤默认就不发。装完立刻做两件事收尾。第一条命令复跑一次脚本判就绪时用的探针第二条把每个容器的状态列出来curl http://127.0.0.1:5678/healthz docker compose -f n8n/compose.yml ps对照这张表六个容器的期望状态一目了然容器期望状态角色n8nrunning主服务sandbox-apirunningAI 沙箱 APIsandbox-runner-1running特权沙箱执行器runnersrunning任务 runnerssearxngrunning搜索服务sandbox-certsexited退出码 0一次性证书引导跑完即退全对上了浏览器里就是这样的编辑器升级、日常启停与安全边界升级前先放心在已有安装上不带参数重跑那行脚本只是一次信息性检查报告当前状态和升级命令不碰任何文件。真升级时加--upgrade它只回写.env里的N8N_VERSION一行想钉到特定版本就再拼上--version x.y.z然后拉镜像、重启其余配置与密钥一律不动。若官方栈定义有新版它只提醒你去看变更绝不会替你改文件。脚本源码在 docker/get-n8n.sh想逐行核对行为时去翻它。停与起就两条docker compose -f n8n/compose.yml down # 全部停止 docker compose -f n8n/compose.yml up -d # 后台拉起安全边界记住三条就够所有数据都藏在名为n8n-data的 Docker 卷里容器把它挂到/home/node/.n8nSQLite 数据库、webhook URL、凭据加密密钥都在这里。按镜像说明docker/images/n8n/README.md启动时若找不到这份数据n8n 会自动生成新密钥旧凭据从此解不开。唯一该露到公网的端口是 5678sandbox-runner-1是特权 Docker-in-Docker 容器端口永远别发布出去runners、sandbox-api、searxng只活在 compose 网络里按服务名互访不映射主机端口。这套一行部署定位是本地试用TLS、Postgres、队列模式这类生产级诉求不在它的射程内。出问题时怎么救现象原因恢复动作报端口 5678 已被监听本机有服务占着这个端口停掉占用进程重跑或加--no-start只生成配置手改n8n/compose.yml的端口映射后再启动拒绝写入安装目录./n8n已存在且有内容用N8N_DIR./some-dir指一个空目录拉镜像被限流撞上 Docker Hub 匿名拉取配额三个配置文件毫发无伤等约 1 小时后手动docker compose -f n8n/compose.yml up -d或先docker login提高额度再重跑180 秒内/healthz始终不通容器起了但服务没就绪常见于迁移卡住、资源不足按提示跑docker compose -f n8n/compose.yml logs n8n从日志里找病根⚠️ 清理现场 轻量替代动手拆之前先想清楚后果下面这条命令是清场级的docker compose -f n8n/compose.yml down -v rm -rf n8n-v会把n8n-data卷一并清掉紧跟的rm -rf抹掉整个配置目录数据从此无迹可寻。不想把 runners 和沙箱这套完整栈请进家门的话还有一条轻量路子——手动跑单个 n8n 容器数据卷名与 compose 栈的不同n8n_data对n8n-data访问地址不变仍是 localhost:5678docker volume create n8n_data docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n【免费下载链接】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），仅供参考