在 Debian 系统上修改 Jenkins 配置,常见场景包括:修改端口、JVM 参数、启动用户、系统配置、插件/任务配置 等。下面按常见需求分类说明。
Debian 下 Jenkins 通常由 systemd 管理,主要配置文件有:
| 配置项 | 路径 |
|---|---|
| 主要配置文件 | /etc/default/jenkins |
| systemd 服务文件 | /lib/systemd/system/jenkins.service 或 /etc/systemd/system/jenkins.service |
| 主目录 | /var/lib/jenkins |
| 日志目录 | /var/log/jenkins |
| 插件 & 任务 | /var/lib/jenkins/plugins /var/lib/jenkins/jobs |
/etc/default/jenkins(推荐)sudo nano /etc/default/jenkins
找到:
HTTP_PORT=8080
修改为:
HTTP_PORT=9090
然后重启:
sudo systemctl restart jenkins
sudo systemctl edit jenkins
添加或修改:
[Service]
Environment="JENKINS_PORT=9090"
重载并重启:
sudo systemctl daemon-reload
sudo systemctl restart jenkins
编辑:
sudo nano /etc/default/jenkins
找到 JAVA_OPTS 或 JENKINS_JAVA_OPTIONS:
JENKINS_JAVA_OPTIONS="-Xms512m -Xmx2048m"
重启:
sudo systemctl restart jenkins
默认是 jenkins 用户。
sudo nano /etc/default/jenkins
修改:
JENKINS_USER=root
⚠ 不推荐 root,仅调试使用
sudo chown -R root:root /var/lib/jenkins
sudo chown -R root:root /var/log/jenkins
sudo chown -R root:root /var/cache/jenkins
重启:
sudo systemctl restart jenkins
sudo systemctl stop jenkins
sudo nano /etc/default/jenkins
修改:
JENKINS_HOME=/data/jenkins
sudo rsync -av /var/lib/jenkins/ /data/jenkins/
sudo chown -R jenkins:jenkins /data/jenkins
sudo systemctl start jenkins
访问:
http://<服务器IP>:8080
进入:
Manage Jenkins → System
可修改:
任务配置:
/var/lib/jenkins/jobs/<job-name>/config.xml
插件配置:
/var/lib/jenkins/plugins
修改后重启 Jenkins 生效。
每次修改 service 或 env 文件:
sudo systemctl daemon-reload
sudo systemctl restart jenkins
systemctl status jenkins
journalctl -u jenkins -f
| 问题 | 解决 |
|---|---|
| 端口被占用 | `ss -lntp |
| 启动失败 | journalctl -u jenkins |
| 权限不足 | 检查 /var/lib/jenkins 权限 |
| Java 版本问题 | java -version |
如果你能具体说明 你想修改哪一项配置(比如端口、内存、反向代理、Git、Pipeline、权限),我可以给你 精确到命令级别 的方案。