Jenkins代理启动失败：端口不可达及Broken Pipe问题求助

问题1：「通过连接到主节点启动代理」时提示provided port:@@@@ is not reachable #

排查与解决步骤： #

• 核对端口配置与网络连通性：
  1. 确认Jenkins主节点的JNLP代理端口（路径：Manage Jenkins → Configure Global Security → Agent protocols），以及目标代理节点配置页中的端口是否一致。
  2. 检查主节点与代理节点之间的防火墙、安全组规则，确保该端口未被拦截，可通过telnet <jenkins-master-ip> <port>（Linux）或Test-NetConnection <jenkins-master-ip> -Port <port>（Windows）验证连通性。
• 修正Jenkins URL配置：
  进入Manage Jenkins → Configure System，确认Jenkins URL为代理节点可正常访问的地址（避免内网地址被外网代理节点访问、或URL填写错误）。
• 对齐Java版本：
  确保代理节点的Java版本与Jenkins主节点兼容（建议使用同版本或官方推荐的兼容版本，如主节点用Java 11则代理也用Java 11）。

问题2：「主节点执行命令启动代理」时提示java.io.IOException: Broken pipe #

排查与解决步骤： #

• 使用完整启动命令：
  单独执行java -jar C:\jenkins\agent.jar缺少必要参数，需从代理节点的配置页（Manage Nodes and Clouds → 目标节点 → Launch agent）复制完整命令，示例格式：

  java -jar agent.jar -jnlpUrl http://<jenkins-master-url>/computer/<node-name>/slave-agent.jnlp -secret <node-secret-key> -workDir "C:\jenkins\workspace"
  

• 检查目录权限：
  确保代理节点的C:\jenkins目录拥有读写权限，避免Jenkins代理进程无法创建工作文件、日志文件。
• 排查网络稳定性：
  Broken pipe多为连接中途中断，检查主节点与代理节点之间的网络是否存在波动，同时确认防火墙、杀毒软件未拦截Java进程的网络连接。
• 重新下载agent.jar：
  若本地agent.jar文件损坏，从主节点的http://<jenkins-master-url>/jnlpJars/agent.jar路径下载最新版本，替换代理节点的旧文件后重试。

内容的提问来源于stack exchange，提问作者Kala