5 分钟本地跑起 n8n:一行命令完成 n8n 自托管

5 分钟本地跑起 n8n:一行命令完成 n8n 自托管 5 分钟本地跑起 n8n一行命令完成 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在本地做一次 n8n 自托管最短路径就是 n8n 一行安装curl -fsSL https://get.n8n.io | sh这条 get.n8n.io 脚本会替你装好整套 n8n docker compose 部署n8n 本体、任务 runners、AI 沙箱、SearXNG 搜索。跑完之后浏览器打开http://localhost:5678就能建工作流。下面是完整操作流。n8n 自托管环境自查粘贴命令前花 30 秒过一遍这四项避免半路报错检查项不满足时的表现Docker 已安装、守护进程在运行脚本用docker info判断Podman、Colima 等引擎也可装带 compose 插件的 docker CLI 并用DOCKER_HOST指向其 socket报The Docker daemon is not runningCompose v2 插件可用docker compose version能跑旧的独立二进制docker-compose不受支持报Docker Compose v2 plugin is not available5678 端口空闲脚本探测http://127.0.0.1:5678/有进程应答就算占用报something is already listening on port 5678安装目录为空默认是命令执行处的./n8n报exists and is not empty — refusing to write into it想看脚本内容再执行可以先下载后审阅curl -fsSL https://get.n8n.io -o get-n8n.sh less get-n8n.sh sh get-n8n.shn8n 一行安装脚本替你做的 5 件事执行后源码见 docker/get-n8n.sh定版本。默认取最新稳定 release把版本号以N8N_VERSION固定写进.env——不用浮动 tag防止容器重建时静默升级并触发数据库迁移。GitHub 查询失败时回退到脚本内置的2.32.0。生成三个文件都在./n8n下compose.yml栈定义下载一次后归你所有脚本以后永不重写、.env权限 600内含本次安装随机生成的唯一密钥、searxng-settings.yml。拉镜像并启动。首次拉取可能花几分钟随后docker compose up -d拉起全部服务。健康检查。每 3 秒轮询一次http://127.0.0.1:5678/healthz最多等 180 秒——首次启动要拉镜像并跑迁移。打印摘要。成功时你会看到n8n is running at: http://localhost:5678、数据与配置位置、启停命令和安全提示。按需拼在管道后追加参数curl -fsSL https://get.n8n.io | sh -s -- --version 2.32.0只认三段式版本号。两个环境变量N8N_DIR改安装目录如N8N_DIR./some-dirDO_NOT_TRACK1表示安装或升级失败时不再询问是否发送匿名失败报告报告只含脚本版本、系统名、install/upgrade 模式和失败步骤默认不发送。打开 n8n 本地部署地址 5678看到成功摘要后打开http://localhost:5678进入编辑器不只看脚本提示用两种方式复核curl http://127.0.0.1:5678/healthzdocker compose -f n8n/compose.yml ps对照 docker/test-get-n8n.sh 里 e2e 测试的期望值容器期望状态n8nrunningsandbox-apirunningsandbox-runner-1runningrunnersrunningsearxngrunningsandbox-certsexited 0一次性证书引导容器n8n 日常运维与升级命令一张卡片收齐动作命令停止docker compose -f n8n/compose.yml down启动docker compose -f n8n/compose.yml up -d升级curl -fsSL https://get.n8n.io | sh -s -- --upgrade只生成配置不启动sh -s -- --no-start升级只改.env里的N8N_VERSION一行可加--version x.y.z指定目标版本然后拉镜像、重启其他配置和密钥一概不动。它还会比对本地compose.yml与线上栈定义的版本标记官方栈更新时只提醒你去看变更不替你改写文件。卸载⚠️下面这条会删除全部 n8n 数据down -v连带删掉n8n-data卷docker compose -f n8n/compose.yml down -v rm -rf n8n在已有安装上不带--upgrade重跑一行脚本是安全的 no-op不动任何文件只报告当前状态、启动地址和升级命令。4 个高频卡点卡点现象修复端口被占用something is already listening on port 5678先停掉占用进程再重跑或--no-start生成配置后手动改n8n/compose.yml的端口映射再启动安装目录非空exists and is not empty — refusing to write into it用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 n8nn8n 自托管数据边界与单容器替代方案数据存哪实例数据在 Docker 卷n8n-data挂载到容器内/home/node/.n8n。工作流存在 SQLite 数据库里同目录还有 webhook URL 和凭据加密密钥。据 docker/images/n8n/README.md启动时若找不到这些数据n8n 会自动生成新密钥——已有凭据将无法再解密。暴露面见 docker/get-n8n-compose.yml只有 5678 端口应暴露到公网sandbox-runner-1是特权 Docker-in-Docker 容器永不发布它的端口runners、sandbox-api、searxng只在 compose 网络内以服务名访问不发布主机端口。定位这套一行部署面向本地试用。生产级需求——TLS、Postgres、队列模式——不在一行脚本范围内。不想引入完整栈单容器手动跑 n8n 本体访问地址同样是http://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),仅供参考