如何修改Jenkins路径

在 Jenkins 中，“修改路径”通常指以下几种常见场景之一。你可以对照看看你具体要改的是哪一种：

一、修改 Jenkins 主目录（JENKINS_HOME）

这是最常见的情况，用于迁移数据或调整磁盘。

1️⃣ 停止 Jenkins

systemctl stop jenkins
# 或
service jenkins stop

2️⃣ 修改 JENKINS_HOME

编辑 Jenkins 启动配置文件：

CentOS / RHEL / Rocky

vim /etc/sysconfig/jenkins

修改：

JENKINS_HOME="/data/jenkins"

Ubuntu / Debian

vim /etc/default/jenkins

修改：

JENKINS_HOME="/data/jenkins"

3️⃣ 迁移原数据

cp -a /var/lib/jenkins/* /data/jenkins/
chown -R jenkins:jenkins /data/jenkins

4️⃣ 启动 Jenkins

systemctl start jenkins

✅ 访问 Jenkins，确认数据正常。

二、修改 Jenkins 访问 URL 路径

例如从：

http://jenkins.example.com/

改为：

http://jenkins.example.com/jenkins/

方法 1：修改 Jenkins 配置（推荐）

进入：

Jenkins → Manage Jenkins → System

修改：

• Jenkins URL

http://jenkins.example.com/jenkins/

方法 2：反向代理（Nginx 示例）

location /jenkins/ {
    proxy_pass http://127.0.0.1:8080/jenkins/;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
}

⚠️ 注意：

• Jenkins 本身也要配置 context path（见下方）

三、修改 Jenkins Web 上下文路径（Context Path）

例如从 / 改为 /jenkins

1️⃣ 修改 Jenkins 启动参数

systemd 系统

vim /usr/lib/systemd/system/jenkins.service

修改：

Environment="JENKINS_OPTS=--prefix=/jenkins"

或：

ExecStart=/usr/bin/java ... --prefix=/jenkins

2️⃣ 重载并重启

systemctl daemon-reload
systemctl restart jenkins

四、修改 Jenkins 端口

1️⃣ 修改端口配置

vim /etc/sysconfig/jenkins   # 或 /etc/default/jenkins

JENKINS_PORT="8081"

2️⃣ 重启

systemctl restart jenkins

五、修改 Job / 工作空间路径

Job 工作空间默认在：

$JENKINS_HOME/workspace

如需修改，可在：

Manage Jenkins → System → 工作空间根目录

自定义：

/opt/jenkins/workspace

六、常见问题

❓ 修改后 Jenkins 打不开？

• 检查目录权限
• 检查端口是否被占用
• 查看日志：

journalctl -u jenkins -f
# 或
/var/log/jenkins/jenkins.log

七、快速对照表

如果你能告诉我：

• ✅ Jenkins 运行系统（Ubuntu / CentOS / Docker）
• ✅ 想改的是 URL / 目录 / 端口 / 上下文路径

我可以直接给你精确命令。