前言作为 Java 开发者我们都经历过这样的流程本地git push然后手动登录服务器git pull重启应用。偶尔做一次还行一天做十次就让人抓狂了。传统的 CI/CD 方案当然很好但 Jenkins 太重GitHub Actions 又离不开 GitHub 生态。有没有一种轻量级、可视化、跨平台的自动化方案答案是n8n——一个开源的工作流自动化工具。本文将在 Windows 11 WSL2 环境下带你从零搭建 n8n实现“GitHub Push 后自动部署到服务器”的完整自动化流程。本文属于 MACS Dev Hub“现代架构与编码解决方案”系列。前文介绍了 WSL2 Docker 配置 Java 开发环境本文将在该环境基础上继续实践。一、n8n 是什么为什么用它做 CI/CD1.1 n8n 简介n8n 是一个开源的工作流自动化工具支持连接超过 400 种应用和服务GitHub、Slack、HTTP、数据库等通过可视化界面拖拽节点即可构建自动化流程。与 Zapier、Make 等商业产品不同n8n 可以完全自托管数据不出自己的服务器。截至 2026 年n8n 的用户量持续增长自托管方案日趋成熟。自托管的 n8n 与官方云服务在功能上并无本质差异只是基础设施服务器、备份、更新需要自己管理。1.2 n8n vs 传统 CI/CD 工具维度n8nGitHub ActionsJenkins学习曲线低可视化拖拽中YAML 配置高插件生态复杂部署成本Docker 一键启动免费但绑定 GitHub较重需单独服务器灵活性高400 节点支持 HTTP/Webhook中受 GitHub 生态限制极高但维护成本高适用范围通用自动化不限 CI/CD仅限 GitHub 仓库DevOps 全场景适用场景轻量级部署、个人项目、小团队深度 GitHub 用户大型企业、复杂流水线结论n8n 不适合替代企业级 CI/CD但对于个人项目、小团队、快速原型部署来说它是完美的轻量级替代方案。1.3 核心架构我们需要哪几个节点本次自动化流程涉及以下节点Webhook 节点触发器——监听 GitHub 的 Push 事件HTTP Request 节点——拉取 GitHub 仓库最新代码SSH 节点——远程登录部署服务器执行命令IF 节点——过滤非目标分支仅 master/main完整的工作流程如下图所示二、环境准备2.1 前置条件本文假设你已具备以下条件基于前两篇文章配置的环境Windows 11 WSL2 Docker Desktop 已安装一台目标部署服务器可以是另一台 VPS或本地虚拟机需开启 SSHGitHub 仓库含需要自动部署的 Java/Spring Boot 项目2.2 部署方式对比n8n 自托管有多种方式下面是 2026 年的主流方案对比部署方式难度成本适用场景Docker Compose推荐低约 $4-5/月VPS生产环境、数据持久化npm 本地安装中免费开发测试n8n Cloud极低按执行次数计费不想维护服务器托管平台PikaPods 等低约 $5-10/月不想自己配置数据库本文选择 Docker Compose 方案数据持久化、方便升级、与 WSL2 环境完美兼容。2.3 准备工作在开始部署前先确认以下几项目标服务器的 SSH 连接信息IP 地址 / 域名SSH 端口默认 22用户名建议使用非 root 用户如deploy私钥或密码准备工作目录在 WSL2 内执行mkdir -p ~/docker/n8n cd ~/docker/n8n为什么要在 WSL2 内部部署根据前文的性能测试在 WSL2 内部文件系统~/目录操作文件性能接近原生 Linux。虽然 n8n 本身不涉及大量文件 I/O但保持统一环境有助于后续维护。三、部署 n8nDocker Compose 方案3.1 创建 docker-compose.yml在~/docker/n8n/目录下创建docker-compose.ymlversion: 3.8 services: n8n: image: n8nio/n8n:latest container_name: n8n restart: unless-stopped ports: - 5678:5678 environment: - N8N_HOSTlocalhost - N8N_PORT5678 - N8N_PROTOCOLhttp - NODE_ENVproduction - WEBHOOK_URLhttp://localhost:5678/ - N8N_ENCRYPTION_KEY${N8N_ENCRYPTION_KEY} volumes: - n8n_data:/home/node/.n8n - ./local-files:/files networks: - n8n_network networks: n8n_network: driver: bridge volumes: n8n_data:配置说明volumes中的n8n_data持久化存储工作流和凭证容器删除后数据不丢失WEBHOOK_URL决定了 GitHub 回调的地址如果是公网 VPS需要改为http://你的公网IP:5678/N8N_ENCRYPTION_KEY用于加密凭证建议在.env文件中配置3.2 创建环境变量文件在相同目录下创建.env文件# 生成一个随机密钥可通过 openssl rand -hex 16 生成 N8N_ENCRYPTION_KEY你的随机32位密钥生成随机密钥的快捷命令openssl rand -hex 163.3 启动 n8ndocker-compose up -d查看启动日志docker-compose logs -f首次启动需要拉取镜像约 600MB等待片刻。启动成功后通过浏览器访问http://localhost:5678WSL2 内可直接访问或通过 Windows 浏览器访问 WSL2 的 IP。注意如果你的 n8n 部署在云服务器上首次访问时会要求创建管理员账户和设置密码这是正常的初始化流程。3.4 部署验证打开浏览器访问http://localhost:5678看到 n8n 的 Web 界面即表示部署成功。创建管理员账户后即可进入工作流编辑界面。四、构建 GitHub → 部署自动化工作流本节建议打开 n8n Web 界面边看边操作。4.1 第一步创建 Webhook 触发器在 n8n 仪表板点击“New Workflow”。点击“Add first step…”搜索Webhook节点。选择Webhook节点配置如下HTTP MethodPOSTPathgithub-webhook可自定义AuthenticationNone后续可以加验证Response ModeLast ResponseResponse DataAll Entries点击“Execute Node”激活 Webhook 节点页面会显示一个 Webhook URL类似http://localhost:5678/webhook/github-webhook复制这个 URL稍后要配置到 GitHub 仓库。4.2 第二步配置 GitHub Webhook打开你的 GitHub 仓库 →Settings→Webhooks→Add webhook。将上一步复制的 URL 粘贴到Payload URL。Content type选择application/json。Secret可选留空或自定义开启后可验证请求合法性。在Which events would you like to trigger this webhook?选择“Just the push event”。点击“Add webhook”保存。配置完成后每次git push到该仓库GitHub 都会发送一个 POST 请求到 n8n Webhook 节点。4.3 第三步添加分支过滤IF 节点我们可能只想在main或master分支上触发部署而不是每个 feature 分支。在 Webhook 节点后添加一个IF节点点击 Webhook 节点右侧的号搜索IF。在 IF 节点的Conditions中配置左侧选择{{ $json.ref }}操作符选择Equals右侧输入refs/heads/main如果是 master 分支则写refs/heads/master4.4 第四步拉取仓库最新代码HTTP Request 节点GitHub Webhook 的 payload 中包含仓库的 clone URL 和分支信息。我们可以利用这些信息通过 HTTP Request 节点在部署服务器上拉取代码。实际上更稳妥的做法是通过 SSH 节点直接登录服务器执行git pull而不是用 n8n 拉取后再传输。因此这一节我们跳过代码拉取环节直接进入 SSH 部署。建议在目标服务器上先配置好 SSH 公钥让服务器能够无密码拉取 GitHub 仓库。这样 SSH 节点只需执行cd /path/to/project git pull docker-compose restart即可完成部署。4.5 第五步SSH 远程执行部署命令这是整个自动化的核心环节。n8n 的 SSH 节点允许在工作流中执行远程服务器命令。在 IF 节点后添加SSH节点搜索并选择SSH节点。配置 SSH 连接凭据点击“Create New”创建 SSH 凭据填写主机地址、端口默认 22、用户名认证方式选择Private Key推荐或 Password粘贴部署服务器的 SSH 私钥内容配置执行命令Command字段输入需要远程执行的部署脚本例如cd /home/deploy/my-java-app \ git pull origin main \ docker-compose down \ docker-compose up -d --buildWorking Directory可选留空则使用默认目录勾选“Execute Once”执行一次命令设置Timeout为适当值如 300 秒避免长时间部署导致超时。4.6 第六步处理响应和错误建议在 SSH 节点后添加一个NoOp或Respond to Webhook节点将执行结果返回给调用方可选。也可以添加Error Trigger节点在 SSH 命令执行失败时发送通知如企业微信、钉钉、邮件。五、完整工作流 YAML 代码如果你不想手动拖拽配置可以直接导入以下工作流 JSON保存为.json文件在 n8n 界面选择Import from File{ name: GitHub Push Auto Deploy, nodes: [ { parameters: { httpMethod: POST, path: github-webhook, responseMode: responseNode, options: {} }, id: webhook-node, name: Webhook, type: n8n-nodes-base.webhook, typeVersion: 1.1, position: [250, 300] }, { parameters: { conditions: { string: [ { value1: {{ $json.ref }}, operation: equals, value2: refs/heads/main } ] } }, id: if-node, name: Check Branch, type: n8n-nodes-base.if, typeVersion: 1, position: [450, 300] }, { parameters: { host: your-server-ip, port: 22, username: deploy, authentication: privateKey, privateKey: , command: cd /home/deploy/app git pull origin main docker-compose down docker-compose up -d --build }, id: ssh-node, name: SSH Deploy, type: n8n-nodes-base.ssh, typeVersion: 1, position: [650, 300] } ], connections: { Webhook: { main: [[{ node: Check Branch, type: main, index: 0 }]] }, Check Branch: { main: [[{ node: SSH Deploy, type: main, index: 0 }]] } } }注意导入前需要手动配置 SSH 凭据。六、安全注意事项6.1 暴露 Webhook 的安全风险n8n 的 Webhook URL 一旦被恶意攻击者获取可能被用于触发任意工作流。针对这个问题2026 年初 n8n 官方披露了一个安全漏洞GHSA-mqpr-49jj-32rc攻击者可以伪造未签名请求触发工作流。建议的安全措施使用 Webhook Secret在 GitHub Webhook 设置中配置 Secret并在 n8n Webhook 节点中开启签名验证限制 IP 范围如果 n8n 部署在公网建议仅允许 GitHub 的官方 IP 范围访问启用 HTTPS在生产环境中务必配置 Nginx 反向代理 SSL 证书设置复杂路径避免使用简单的/webhook路径可加上随机字符串6.2 SSH 凭据保护SSH 私钥是敏感信息n8n 会将其加密存储依赖N8N_ENCRYPTION_KEY。务必妥善保管该密钥不要泄露。七、常见问题与排查问题可能原因解决方法Webhook 收到 404URL 路径不匹配检查 Webhook 节点的 Path 配置和 GitHub 中填写的 URLWebhook 收到 500n8n 内部错误查看docker-compose logs n8nSSH 连接失败公钥/私钥配置错误先在本地用ssh -i private_key userhost测试SSH 命令执行超时部署时间过长增加 SSH 节点的 Timeout 值git pull报权限错误服务器 SSH 密钥未配置在目标服务器上配置 GitHub 部署密钥n8n 无法访问外网WSL2DNS 或网络配置检查/etc/resolv.conf或重启 WSL2八、扩展方向本文实现了基础的“GitHub Push → SSH 部署”流程。你还可以根据实际需求扩展构建前测试在工作流中增加 HTTP Request 节点触发 GitHub Actions 运行单元测试通过后再部署多环境部署通过 IF 节点区分分支main/staging/dev分别部署到不同服务器部署通知在 SSH 节点后增加企业微信/钉钉/Slack 节点部署成功后自动发送通知版本回滚增加 Code 节点解析 payload 中的 commit ID支持一键回滚n8n 的灵活性远超传统 CI/CD 工具——它不仅能做部署还能串联通知、数据库更新、文件管理等跨系统自动化任务。九、总结本文从零开始在 WSL2 Docker 环境下完成了 n8n 的部署并构建了一条完整的GitHub Push 自动部署工作流。核心要点回顾n8n 是开源、自托管的自动化工具适合轻量级 CI/CD场景Docker Compose 是推荐的部署方式数据持久化、易于维护Webhook 节点作为触发器配合 IF 节点实现分支过滤SSH 节点远程执行部署命令是整个自动化的执行核心部署到公网时务必注意 Webhook 安全防护比起手动 SSH 登录部署这套方案能节省 80% 以上的重复操作时间。如果你的项目还在用“手动作业”不妨花 30 分钟配置 n8n把精力留在更重要的代码上。本文实测环境Windows 11 WSL2 Docker Desktop n8n 1.x Ubuntu 24.04 部署服务器。更多自动化实战文章欢迎访问 MACS Dev Hub。如果你在配置中遇到问题欢迎在评论区留言交流。