升级Jenkins至2.387.1后代理节点无法显示符号链接求助

核心原因 #

主节点配置的Java参数仅作用于主节点自身的JVM进程，代理节点作为独立运行的JVM进程，需要单独添加相同的安全放行参数才能生效。

具体操作步骤 #

1. Java Web启动的代理节点 #

修改代理节点的启动命令，在java指令后添加目标参数，示例：

java -Dhudson.model.DirectoryBrowserSupport.allowSymlinkEscape=true -jar agent.jar -jnlpUrl http://<Jenkins主节点地址>/computer/<代理节点名称>/slave-agent.jnlp -secret <代理节点密钥> -workDir "<代理节点工作目录>"

2. 系统服务启动的代理节点（CentOS 7） #

• 编辑代理节点的系统服务配置文件（通常路径为/etc/systemd/system/jenkins-agent.service）
• 在ExecStart行的java命令后插入参数，示例：

ExecStart=/usr/bin/java -Dhudson.model.DirectoryBrowserSupport.allowSymlinkEscape=true -jar /path/to/agent.jar -jnlpUrl http://<Jenkins主节点地址>/computer/<代理节点名称>/slave-agent.jnlp -secret <代理节点密钥> -workDir "/var/lib/jenkins-agent"

• 重新加载配置并重启代理服务：

systemctl daemon-reload
systemctl restart jenkins-agent

3. Jenkins主节点配置的固定代理节点 #

• 进入Jenkins主节点的「管理节点」页面，找到目标代理节点
• 进入节点配置页，在「节点属性」中添加「Java虚拟机参数」，填入：

-Dhudson.model.DirectoryBrowserSupport.allowSymlinkEscape=true

• 保存配置后，重启该代理节点

验证 #

完成配置后，重新运行代理节点上的作业，检查浏览器端工作区是否能正常显示符号链接。

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