用一行脚本装好 n8n 并在 localhost: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本文带你从零自托管一个 n8n 实例在终端粘贴一行安装命令等待约一两分钟就能在 http://localhost:5678 打开工作流编辑器。全程只需要机器上有 Docker不用手写任何配置文件脚本会把栈定义、密钥、搜索服务一次性配齐。一行命令装下来的是什么很多人第一次装 n8n 只用docker run跑单容器也能用但 Code 节点里写 JavaScript/Python 代码、AI 助手做网页搜索这些能力会缺失。官方的一行脚本拉起的是一整套 compose 栈compose 可以理解为用一份 YAML 文件管理一组容器共五个长期运行的服务n8n主体唯一对主机发布端口的容器占5678runners专门跑 Code 节点用户代码的容器端口只对内网开放sandbox-api和sandbox-runner-1AI 助手的代码沙箱后者是特权容器searxng给 AI 助手提供网页搜索的元搜索引擎另外还有一个一次性的sandbox-certs容器负责生成沙箱内部的 mTLS 证书跑完即退出。这套栈的完整定义在 docker/get-n8n-compose.yml 里脚本安装时会把它下载到本地之后这份文件归你脚本永远不会重写它。动手前确认 Docker 和 5678 端口脚本开跑前会逐项自检不满足就报错退出并给修复提示所以这两件事最好先过一遍Docker 装好了且守护进程在运行并且docker compose version能执行即 Compose v2 插件可用旧的独立docker-compose二进制不受支持。Podman、Colima 等兼容引擎也行但要装带 compose 插件的dockerCLI并用DOCKER_HOST指向它们的 socket。5678 端口空闲。脚本会探测http://127.0.0.1:5678/只要有进程应答哪怕只是接受连接就判定端口被占用并终止。安装目录默认是命令执行处的./n8n该目录必须不存在或为空否则脚本拒绝写入想换目录用环境变量N8N_DIR./some-dir指定即可。执行一行安装并理解背后的四步最短主路径curl -fsSL https://get.n8n.io | sh它从官方地址下载安装脚本并立即执行你会先看到 Docker 版本检测的两行绿勾然后是拉镜像的进度条最后停在一条n8n is running at: http://localhost:5678的摘要上。如果习惯先审查再执行用脚本头部推荐的写法curl -fsSL https://get.n8n.io -o get-n8n.sh less get-n8n.sh sh get-n8n.sh先下载为本地文件、翻页读完再运行内容全部可见源码即 docker/get-n8n.sh。执行期间脚本实际做四件事定版本取最新稳定 release以N8N_VERSION2.32.0这样的形式写死进.env不用浮动 tag——否则容器重建时会静默升级并触发数据库迁移。查 GitHub 失败时回退到内置的2.32.0。生成三个文件到./n8ncompose.yml栈定义、.env权限 600内含本次安装随机生成的沙箱密钥、runner 认证 token 等、searxng-settings.yml开启搜索 JSON 接口。拉镜像并启动docker compose up -d起全部服务首次拉镜像可能要几分钟。等健康检查每 3 秒轮询一次http://127.0.0.1:5678/healthz上限 180 秒——首次启动要跑数据库迁移180 秒就是留给它的预算。常用选项拼在管道后面按需取用写法效果sh -s -- --version 2.32.0安装指定版本必须三段式版本号sh -s -- --no-start只生成配置不拉镜像不启动sh -s -- --version只打印脚本版本和将装的 n8n 版本零改动两个环境变量N8N_DIR换安装目录DO_NOT_TRACK1表示安装或升级失败时不再询问是否发送匿名失败报告仅含脚本版本、系统名、失败步骤默认不发送。确认就绪浏览器看界面终端看健康检查摘要打印后在浏览器打开 http://localhost:5678 即进入编辑器完成初始账号创建就能开始拖节点建工作流不想依赖脚本提示时两条命令可以独立复核。健康检查端点脚本判定就绪用的就是它curl http://127.0.0.1:5678/healthz它请求 n8n 的健康端点返回成功说明服务已能处理请求。再看容器状态docker compose -f n8n/compose.yml ps它会列出栈内全部容器期望看到n8n、sandbox-api、sandbox-runner-1、runners、searxng五个处于 runningsandbox-certs以退出码 0 结束exited 0这是正常行为。日常三个动作停止、启动、升级停止和启动各一条命令摘要里也会原样给出docker compose -f n8n/compose.yml down # 停止 docker compose -f n8n/compose.yml up -d # 启动down只停容器删网络数据卷原封不动up -d重新拉起。在已有安装上不带--upgrade重跑一行脚本是安全的 no-op它发现./n8n已有配置后只报告当前状态、启动地址和升级命令不碰任何文件。真正升级用curl -fsSL https://get.n8n.io | sh -s -- --upgrade它只修改.env里的N8N_VERSION一行可与--version x.y.z组合指定目标版本然后拉镜像并重启密钥和其他配置一概不动。若官方栈定义已更新它只会提示你去看变更不会替你改写本地compose.yml。卡住时先对号入座这三个失败点失败时脚本会把错误归好类最常见的三种端口被占用报something is already listening on port 5678。停掉占用进程后重跑或者加--no-start只生成配置手动改n8n/compose.yml里的端口映射再启动。Docker Hub 拉取限流⚠️ 配置文件不受影响等约一小时后用docker compose -f n8n/compose.yml up -d启动即可或者docker login登录 Docker Hub 账号提高限额后重跑脚本。180 秒内/healthz不通按提示执行docker compose -f n8n/compose.yml logs n8n看主体日志。另有一种是安装目录非空被拒提示用N8N_DIR./some-dir换个目录不要往已有文件里硬写。数据存在哪以及这套部署的边界所有实例数据存在 Docker 卷n8n-data中挂载到容器内/home/node/.n8n工作流保存在 SQLite 数据库里同目录还放 webhook URL 和凭据加密密钥。据 docker/images/n8n/README.md 说明启动时若找不到这些数据n8n 会自动生成新密钥已有凭据将无法再解密——迁移或备份时这个卷是第一优先级。安全上记住脚本摘要的两句原话只有5678端口可以暴露到公网sandbox-runner-1是特权 Docker-in-Docker 容器永远不要发布它的端口runners、sandbox-api、searxng只在 compose 网络内以服务名访问不发布主机端口。最后明确边界这套一行部署面向本地试用和快速验证。生产级需求——TLS、Postgres、队列模式——不在一行脚本范围内需要另行规划。如果哪天想彻底重来卸载命令是docker compose -f n8n/compose.yml down -v rm -rf n8n注意down -v会连带删除n8n-data卷也就是删掉全部 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），仅供参考 用一行脚本装好 n8n 并在 localhost:5678 打开本地编辑器
用一行脚本装好 n8n 并在 localhost: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本文带你从零自托管一个 n8n 实例在终端粘贴一行安装命令等待约一两分钟就能在 http://localhost:5678 打开工作流编辑器。全程只需要机器上有 Docker不用手写任何配置文件脚本会把栈定义、密钥、搜索服务一次性配齐。一行命令装下来的是什么很多人第一次装 n8n 只用docker run跑单容器也能用但 Code 节点里写 JavaScript/Python 代码、AI 助手做网页搜索这些能力会缺失。官方的一行脚本拉起的是一整套 compose 栈compose 可以理解为用一份 YAML 文件管理一组容器共五个长期运行的服务n8n主体唯一对主机发布端口的容器占5678runners专门跑 Code 节点用户代码的容器端口只对内网开放sandbox-api和sandbox-runner-1AI 助手的代码沙箱后者是特权容器searxng给 AI 助手提供网页搜索的元搜索引擎另外还有一个一次性的sandbox-certs容器负责生成沙箱内部的 mTLS 证书跑完即退出。这套栈的完整定义在 docker/get-n8n-compose.yml 里脚本安装时会把它下载到本地之后这份文件归你脚本永远不会重写它。动手前确认 Docker 和 5678 端口脚本开跑前会逐项自检不满足就报错退出并给修复提示所以这两件事最好先过一遍Docker 装好了且守护进程在运行并且docker compose version能执行即 Compose v2 插件可用旧的独立docker-compose二进制不受支持。Podman、Colima 等兼容引擎也行但要装带 compose 插件的dockerCLI并用DOCKER_HOST指向它们的 socket。5678 端口空闲。脚本会探测http://127.0.0.1:5678/只要有进程应答哪怕只是接受连接就判定端口被占用并终止。安装目录默认是命令执行处的./n8n该目录必须不存在或为空否则脚本拒绝写入想换目录用环境变量N8N_DIR./some-dir指定即可。执行一行安装并理解背后的四步最短主路径curl -fsSL https://get.n8n.io | sh它从官方地址下载安装脚本并立即执行你会先看到 Docker 版本检测的两行绿勾然后是拉镜像的进度条最后停在一条n8n is running at: http://localhost:5678的摘要上。如果习惯先审查再执行用脚本头部推荐的写法curl -fsSL https://get.n8n.io -o get-n8n.sh less get-n8n.sh sh get-n8n.sh先下载为本地文件、翻页读完再运行内容全部可见源码即 docker/get-n8n.sh。执行期间脚本实际做四件事定版本取最新稳定 release以N8N_VERSION2.32.0这样的形式写死进.env不用浮动 tag——否则容器重建时会静默升级并触发数据库迁移。查 GitHub 失败时回退到内置的2.32.0。生成三个文件到./n8ncompose.yml栈定义、.env权限 600内含本次安装随机生成的沙箱密钥、runner 认证 token 等、searxng-settings.yml开启搜索 JSON 接口。拉镜像并启动docker compose up -d起全部服务首次拉镜像可能要几分钟。等健康检查每 3 秒轮询一次http://127.0.0.1:5678/healthz上限 180 秒——首次启动要跑数据库迁移180 秒就是留给它的预算。常用选项拼在管道后面按需取用写法效果sh -s -- --version 2.32.0安装指定版本必须三段式版本号sh -s -- --no-start只生成配置不拉镜像不启动sh -s -- --version只打印脚本版本和将装的 n8n 版本零改动两个环境变量N8N_DIR换安装目录DO_NOT_TRACK1表示安装或升级失败时不再询问是否发送匿名失败报告仅含脚本版本、系统名、失败步骤默认不发送。确认就绪浏览器看界面终端看健康检查摘要打印后在浏览器打开 http://localhost:5678 即进入编辑器完成初始账号创建就能开始拖节点建工作流不想依赖脚本提示时两条命令可以独立复核。健康检查端点脚本判定就绪用的就是它curl http://127.0.0.1:5678/healthz它请求 n8n 的健康端点返回成功说明服务已能处理请求。再看容器状态docker compose -f n8n/compose.yml ps它会列出栈内全部容器期望看到n8n、sandbox-api、sandbox-runner-1、runners、searxng五个处于 runningsandbox-certs以退出码 0 结束exited 0这是正常行为。日常三个动作停止、启动、升级停止和启动各一条命令摘要里也会原样给出docker compose -f n8n/compose.yml down # 停止 docker compose -f n8n/compose.yml up -d # 启动down只停容器删网络数据卷原封不动up -d重新拉起。在已有安装上不带--upgrade重跑一行脚本是安全的 no-op它发现./n8n已有配置后只报告当前状态、启动地址和升级命令不碰任何文件。真正升级用curl -fsSL https://get.n8n.io | sh -s -- --upgrade它只修改.env里的N8N_VERSION一行可与--version x.y.z组合指定目标版本然后拉镜像并重启密钥和其他配置一概不动。若官方栈定义已更新它只会提示你去看变更不会替你改写本地compose.yml。卡住时先对号入座这三个失败点失败时脚本会把错误归好类最常见的三种端口被占用报something is already listening on port 5678。停掉占用进程后重跑或者加--no-start只生成配置手动改n8n/compose.yml里的端口映射再启动。Docker Hub 拉取限流⚠️ 配置文件不受影响等约一小时后用docker compose -f n8n/compose.yml up -d启动即可或者docker login登录 Docker Hub 账号提高限额后重跑脚本。180 秒内/healthz不通按提示执行docker compose -f n8n/compose.yml logs n8n看主体日志。另有一种是安装目录非空被拒提示用N8N_DIR./some-dir换个目录不要往已有文件里硬写。数据存在哪以及这套部署的边界所有实例数据存在 Docker 卷n8n-data中挂载到容器内/home/node/.n8n工作流保存在 SQLite 数据库里同目录还放 webhook URL 和凭据加密密钥。据 docker/images/n8n/README.md 说明启动时若找不到这些数据n8n 会自动生成新密钥已有凭据将无法再解密——迁移或备份时这个卷是第一优先级。安全上记住脚本摘要的两句原话只有5678端口可以暴露到公网sandbox-runner-1是特权 Docker-in-Docker 容器永远不要发布它的端口runners、sandbox-api、searxng只在 compose 网络内以服务名访问不发布主机端口。最后明确边界这套一行部署面向本地试用和快速验证。生产级需求——TLS、Postgres、队列模式——不在一行脚本范围内需要另行规划。如果哪天想彻底重来卸载命令是docker compose -f n8n/compose.yml down -v rm -rf n8n注意down -v会连带删除n8n-data卷也就是删掉全部 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），仅供参考