Ubuntu18 Jenkins未读取/etc/default/jenkins配置 配置HTTPS后仍默认8080运行

最高发的配置格式错误 #

你当前的配置大概率是从网页复制时带入了排版残留，这也是同类问题最常见的诱因：

• 你贴出的配置里，参数前缀是全角长破折号—，而非Linux shell可识别的半角双短横--，所有带这个前缀的HTTPS参数都会被直接判定为无效内容，完全不生效
• 包裹配置内容的引号是全角引号“”，而非半角双引号"，shell无法正确识别参数边界
• 配置末尾携带了HTML实体残留"，属于网页排版的转义字符，并非有效配置语法

上述问题会导致整段JENKINS_ARGS无法被正确解析，最终Jenkins回退使用默认的8080端口HTTP模式启动。

其他常见的不生效场景 #

• systemd配置优先级覆盖：Ubuntu 18默认通过systemd管理Jenkins服务，若之前手动修改过Jenkins的service单元文件，文件中硬编码的--httpPort=8080参数会直接覆盖/etc/default/jenkins中定义的JENKINS_ARGS。可通过systemctl cat jenkins命令查看实际加载的服务配置，确认启动参数是否存在硬编码的8080端口配置。
• 缺少systemd配置重载：修改/etc/default/jenkins或服务单元文件后，若未执行systemctl daemon-reload就直接重启服务，systemd仍会沿用旧的配置缓存，导致修改内容不生效。
• 密钥库权限不足：如果存放jenkins.jks的路径权限过严，Jenkins运行用户（默认是jenkins）没有文件读权限，启动时会因无法加载密钥库直接跳过HTTPS配置，回退到默认HTTP端口运行，这类报错可以在/var/log/jenkins/jenkins.log中直接查到。

正确的配置写法 #

在/etc/default/jenkins文件末尾写入半角字符格式的正确配置：

JENKINS_ARGS="--httpPort=-1 --httpsPort=8443 --httpsKeyStore=/你的实际密钥库绝对路径/jenkins.jks --httpsKeyStorePassword=你的密钥库实际密码 --httpsListenAddress=0.0.0.0"

注意：文件中原有的HTTP_PORT=8080配置行可以保留，因为参数中httpPort=-1的优先级高于原有配置，无需额外修改该行的取值。

配置生效验证步骤 #

• 执行systemctl daemon-reload重载systemd配置
• 执行systemctl restart jenkins重启服务
• 执行ss -tulnp | grep java检查端口监听状态，确认8443端口处于监听状态、8080端口已关闭
• 查看启动日志无密钥库加载、端口绑定类报错

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