温馨提示×

ubuntu jenkins如何配nginx

小樊
39
2026-10-24 21:15:18
栏目: 智能运维

下面给你一套在 Ubuntu 上用 Nginx 反向代理 Jenkins 的常见做法(最实用、最稳定)。


一、前提条件

  • Ubuntu 20.04 / 22.04
  • 已安装 Jenkins(默认端口 8080)
  • 已安装 Nginx
  • 有域名(可选,但推荐)

二、安装 Nginx(如果还没装)

sudo apt update
sudo apt install nginx -y

三、配置 Jenkins(重要)

编辑 Jenkins 配置文件:

sudo nano /etc/default/jenkins

确认或添加:

JENKINS_ARGS="--webroot=/var/cache/jenkins/war --httpPort=8080"

重启 Jenkins:

sudo systemctl restart jenkins

四、创建 Nginx 反向代理配置

1. 新建配置文件

sudo nano /etc/nginx/sites-available/jenkins

2. 示例配置(HTTP)

server {
    listen 80;
    server_name jenkins.example.com;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

把 jenkins.example.com 换成你的域名或服务器 IP


五、启用配置

sudo ln -s /etc/nginx/sites-available/jenkins /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

六、(推荐)配置 HTTPS(Let’s Encrypt)

sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d jenkins.example.com

Certbot 会自动修改 Nginx 配置并启用 443。


七、Jenkins 中设置 Jenkins URL

  1. 打开 Jenkins
  2. Manage Jenkins → System
  3. Jenkins URL 改为:
    https://jenkins.example.com/
    
  4. 保存

八、防火墙(如有)

sudo ufw allow 80
sudo ufw allow 443

九、常见问题

1. 页面能打开但静态资源 404

✅ 检查 Nginx 是否带了:

proxy_set_header Host $host;

2. 登录后跳转异常

✅ 确保:

proxy_set_header X-Forwarded-Proto $scheme;

3. 想用子路径(如 /jenkins)

Jenkins 需配置 prefix=/jenkins,Nginx 也要对应修改(不推荐新手)。


如果你愿意,可以告诉我:

  • Ubuntu 版本
  • Jenkins 是否 Docker 安装
  • 是否已有域名

我可以给你完全贴合你环境的配置。

0 踩