重启云服务器后Jenkins容器显示运行但UI访问报502及连接拒绝错误

1. 验证容器端口映射与内部服务状态 #

• 先确认容器的端口配置是否正确，执行：

  docker inspect <jenkins-container-name> | grep -A 15 "Ports"
  

  检查输出中是否有正确的端口映射（比如宿主机端口8080映射到容器内8080）。
• 进入容器内部，检查Jenkins服务是否在监听端口：

  docker exec -it <jenkins-container-name> bash
  netstat -tulpn | grep 8080  # 默认Jenkins端口为8080，若自定义端口请替换
  

  如果没有返回结果，说明容器内的Jenkins服务并未真正启动，虽然容器处于running状态。

2. 查看Jenkins启动日志定位报错 #

执行以下命令获取最新的容器日志，排查启动失败原因：

docker logs --tail 100 <jenkins-container-name>

重点关注权限错误、磁盘空间不足、配置文件损坏等关键词，比如Permission denied、No space left on device，这些都会导致Jenkins服务无法正常初始化。

3. 检查宿主机端口占用情况 #

如果直接通过IP+端口访问提示连接拒绝，可能是宿主机端口被其他进程占用：

ss -tulpn | grep <host-port>  # 替换为Jenkins映射的宿主机端口，比如8080

若输出显示其他进程占用该端口，需要停止对应进程或修改Jenkins的端口映射配置。

4. 检查容器健康状态 #

Portainer的running状态仅代表容器进程存活，不代表内部服务健康。执行以下命令查看健康状态：

docker inspect --format='{{.State.Health.Status}}' <jenkins-container-name>

如果返回unhealthy，说明容器内部服务存在故障，结合日志进一步排查。

5. 修复数据卷权限问题 #

如果使用了宿主机数据卷挂载Jenkins配置目录，权限不匹配会导致服务启动失败：

• 查看宿主机数据卷目录权限：

  ls -ld /path/to/jenkins/data  # 替换为你的实际挂载路径
  

• Jenkins容器默认使用uid为1000的用户，需确保目录权限正确：

  chown -R 1000:1000 /path/to/jenkins/data
  docker restart <jenkins-container-name>
  

6. 排查OpenResty反向代理配置 #

出现502 Bad Gateway说明OpenResty无法连接到Jenkins后端：

• 检查OpenResty的Jenkins代理配置文件（通常位于/etc/nginx/conf.d/或/usr/local/openresty/nginx/conf/conf.d/），确认proxy_pass指向的地址和端口是否正确，比如：

  proxy_pass http://localhost:8080;  # 需与Jenkins的宿主机映射端口一致
  

• 重启OpenResty服务：

  systemctl restart openresty
  

内容的提问来源于stack exchange，提问作者Doğa Koçak