无法将一台Windows机器配置为Jenkins从节点/代理节点求助

既然你已经有一台同版本的Windows Server 2012 R2节点成功连上CentOS 7的Jenkins主节点，那咱们就照着已验证的配置来排查这台新节点的问题，一步步来：

一、先核对基础配置的一致性 #

• 代理核心配置对齐
  直接对比已成功节点的Jenkins配置：
  • 确认新节点的远程根目录是完整有效的D:\jenkins\workspace（你提到的"Usa..."应该是输入截断，务必保证路径没有多余空格、特殊字符，且目录实际存在）
  • 再次确认CentOS 7防火墙的端口放行规则：
    在CentOS主节点上执行命令，验证指定的固定JNLP端口是否已放行：

    firewall-cmd --query-port=<你的固定端口>/tcp
    

    如果返回no，就重新添加规则并生效：

    firewall-cmd --add-port=<你的固定端口>/tcp --permanent
    firewall-cmd --reload
    

• 双向网络连通性验证
  在Windows新节点上，用命令测试到主节点端口的连通性：
  命令提示符下用telnet（如果已启用）：

  telnet <主节点IP> <固定JNLP端口>
  

  或者用PowerShell（无需启用telnet）：

  Test-NetConnection <主节点IP> -Port <固定JNLP端口>
  

  重点确认Windows本地防火墙没有拦截该端口的出站请求——哪怕整体网络连通，本地防火墙也可能单独限制了这个端口。

二、Jenkins代理程序的配置细节 #

• 使用匹配版本的代理jar包
  从Jenkins主节点的新代理配置页面，下载对应版本的agent.jar（必须和主节点Jenkins版本匹配，别用旧节点的jar包凑数），然后在Windows节点上运行启动命令：

  java -jar agent.jar -jnlpUrl http://<主节点IP>:<Jenkins端口>/computer/<你的节点名称>/slave-agent.jnlp -secret <节点专属密钥> -workDir "D:\jenkins\workspace"
  

  注意替换命令里的主节点IP、Jenkins端口、节点名称和密钥，这些信息都能从主节点的代理配置页面直接复制。
• 服务化配置对齐（如果已成功节点是服务）
  如果之前的成功节点是作为Windows服务运行的，新节点也要用相同方式配置：
  可以用Jenkins自带的installAsService.bat脚本，或者用sc create命令手动创建服务，务必保证服务的启动账户拥有D:\jenkins\workspace的读写权限，并且该账户能正常访问主节点的JNLP端口。

三、权限与环境的一致性检查 #

• 工作目录权限验证
  右键D:\jenkins\workspace目录，检查运行代理程序的账户（当前登录用户或服务账户）是否拥有完全控制权限——权限不足是代理初始化失败的常见原因。
• Java版本匹配
  对比已成功节点的Java版本，确保新节点安装的Java版本和主节点、成功节点完全一致（比如主节点用Java 8，新节点就别用Java 11，Jenkins对Java版本的兼容性要求很严格）

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