Jenkins分布式并行构建核心是通过配置Agent节点、标签匹配及Pipeline调度实现任务分发：需正确设置JNLP/SSH通信、绝对路径工作目录、清晰标签；在Jenkinsfile中用agent { label 'xxx' }或docker指定执行环境；调高Executor数、禁用Master构建，并验证多任务是否真正并发运行。
Jenkins 实现分布式并行构建，核心是把构建任务从主节点（Master）分发到多个代理节点（Agent）上同时执行。关键不在于“能不能”，而在于“怎么配得准、跑得稳、用得省”——重点是节点通信方式、标签匹配逻辑和 Pipeline 中的调度声明。
一、先配好 Agent 节点（至少一个）
Agent 是真正干活的机器，配置时注意三点：
- 启动方式选对：推荐 SSH（Linux/macOS）或 JNLP（跨平台/Windows），前者更安全稳定，后者免密钥管理但需开放 TCP 端口（默认 50000）并启用 Jenkins 安全设置中的 “Agent → JNLP4” 协议
-
远程工作目录写绝对路径：比如
/var/jenkins/agent，确保该目录存在且 Jenkins 用户有读写权限，否则拉取代码或写日志会失败 -
打上清晰标签（Label）：如
linux-java17、windows-node18、docker-enabled，后续 Pipeline 就靠它精准匹配
二、在 Pipeline 中指定执行节点
不用改全局设置，直接在 Jenkinsfile 里声明即可实现并行调度：
- 整个流水线跑在某类节点：
agent { label 'linux-java17' } - 不同阶段跑在不同环境（典型前后端分离）：
pipeline {<br> agent none<br> stages {<br> stage('Build Backend') {<br> agent { label 'linux-java17' }<br> steps { sh 'mvn clean package' }<br> }<br> stage('Test Frontend') {<br> agent { label 'linux-node16' }<br> steps { sh 'npm test' }<br> }<br> }<br>} - 用 Docker 临时起环境（免维护节点）：
agent { docker { image 'maven:3.9-eclipse-temurin-17' } }，适合短时、隔离强的任务
三、让多个任务真正“并行起来”
并行 ≠ 只写两个 stage，还需确认以下细节：
- 每个 Agent 的并发数（Executors）要设够：在节点配置页里调高“# of executors”，默认是 2；若一台 Agent 想同时跑 4 个测试 job，就设为 4
-
Master 不参与构建（轻量化）：进
Manage Jenkins → Configure System，把 “# of executors on master” 改成 0，避免主节点被压垮 -
避免资源争抢：比如两个 job 都标了
linux-java17，但只有一个对应 Agent，它们就会排队；此时要么加节点，要么给任务加更细粒度标签（如linux-java17-highmem）
四、验证是否真并行了
看三处：
- 构建历史页中，多个 job 的“开始时间”是否高度接近（误差在几秒内）
- 每个构建详情页左上角显示 “Running on [节点名]”，确认没全挤在 master 上
- Agent 页面（
Manage Nodes）里，对应节点的 “Idle executors” 数实时下降，说明正在被占用
