如何修改Jenkins上下文路径？Apache代理下Jenkins实例404问题求助

首先，咱们先搞定你遇到的404问题，再一步步讲清楚怎么修改Jenkins的上下文路径。

一、解决http://myserver.com/jenkins2的404错误 #

这个问题基本是Jenkins的上下文路径配置和Apache反向代理不匹配导致的，按下面的步骤排查：

1. 确认Jenkins的--prefix参数真的生效了 #

先检查Jenkins的启动日志（通常在/var/log/jenkins/jenkins.log或者启动控制台），找类似这样的日志：

Jenkins is fully up and running on /jenkins2

如果没看到这条，说明启动参数没生效：

• 如果是直接用命令启动Jenkins：确保你加的参数是--prefix=/jenkins2（注意不要多打结尾的斜杠，或者少打），比如：

  java -jar jenkins.war --prefix=/jenkins2
  

• 如果是用systemd管理的Jenkins服务：编辑服务配置文件（比如/etc/systemd/system/jenkins.service），在ExecStart行末尾加上--prefix=/jenkins2，比如：

  ExecStart=/usr/bin/java -Djava.awt.headless=true -jar /usr/share/java/jenkins.war --webroot=/var/cache/jenkins/war --httpPort=8080 --prefix=/jenkins2
  

  然后执行systemctl daemon-reload && systemctl restart jenkins重启服务。

2. 修正Apache反向代理的配置 #

Apache的代理规则必须和Jenkins的上下文路径完全对应，不能错位。打开你的Apache虚拟主机配置文件（比如/etc/apache2/sites-available/your-site.conf），添加/修改以下配置：

# 先确保启用了必要的模块（如果没启用的话）
# a2enmod proxy proxy_http

ProxyPass /jenkins2 http://localhost:8080/jenkins2
ProxyPassReverse /jenkins2 http://localhost:8080/jenkins2

这里要注意：

• localhost:8080替换成你Jenkins实际监听的IP和端口
• 两边的路径/jenkins2必须完全一致，不能一边是/jenkins2一边是/

配置完后重启Apache：systemctl restart apache2，再访问试试。

3. 排查Jetty上下文冲突（仅针对war包启动的情况） #

如果你是直接运行jenkins.war，要确保war包所在目录没有额外的Jetty上下文配置文件（比如contexts/jenkins.xml这类），这些文件可能会覆盖--prefix参数的设置，直接删掉或者修改对应配置即可。

二、修改Jenkins上下文路径的三种常用方法 #

除了启动时加--prefix参数，还有另外两种可靠的方式：

1. 通过系统配置文件设置 #

找到Jenkins的默认配置文件（通常是/etc/default/jenkins），找到JENKINS_ARGS这一行，添加--prefix参数：

JENKINS_ARGS="--prefix=/jenkins2"

保存后重启Jenkins服务即可生效。

2. 通过systemd服务配置（推荐用于服务器部署） #

和前面排查时的操作一样，编辑systemd服务文件，在ExecStart行末尾追加--prefix=/your-new-path，然后重载配置并重启服务：

systemctl daemon-reload
systemctl restart jenkins

3. 反向代理层适配（不修改Jenkins本身的方案） #

如果你不想改动Jenkins的配置，可以让Apache把/jenkins2的请求转发到Jenkins的根路径/，但需要额外修正cookie路径避免登录问题：

ProxyPass /jenkins2 http://localhost:8080/
ProxyPassReverse /jenkins2 http://localhost:8080/
ProxyPassReverseCookiePath / /jenkins2

不过这种方法不推荐，因为Jenkins内部生成的部分链接还是会用根路径，可能导致静态资源加载失败，优先用前面两种方法修改Jenkins自身的上下文路径。

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