Ubuntu Jenkins如何配置代理服务器 - 问答

Ubuntu 上 Jenkins 代理配置全指南

在 Ubuntu 环境中，Jenkins 的“代理”常见有三类场景：一是为 Jenkins 本身设置HTTP/HTTPS 出站代理以下载插件与依赖；二是用 Nginx 做反向代理与 SSL 终止；三是将 **Ubuntu 机器作为 Jenkins 的代理节点（Agent）**来扩展构建能力。下面分别给出可操作步骤与要点。

一为 Jenkins 设置 HTTP 出站代理

管理界面配置（推荐）
- 进入 Manage Jenkins → System，在 Proxy 部分填写：
  - HTTP Proxy：例如 http://proxy.company.com:8080
  - HTTPS Proxy：例如 http://proxy.company.com:8080（很多企业对 HTTPS 也走同一代理）
  - No Proxy：如 localhost,127.0.0.1,.internal,example.com
- 保存后重启 Jenkins（如使用 systemd：sudo systemctl restart jenkins），再在 Manage Plugins 测试插件站点连通性。
备选方案（系统级代理）
- 若 Jenkins 以服务方式运行，可在其环境文件设置代理，编辑 /etc/default/jenkins，在 JAVA_OPTS 中加入（示例）：
  - -Dhttp.proxyHost=proxy.company.com -Dhttp.proxyPort=8080
  - -Dhttps.proxyHost=proxy.company.com -Dhttps.proxyPort=8080
  - -Dhttp.nonProxyHosts=localhost|127.0.0.1|*.internal
- 保存并重启：sudo systemctl restart jenkins。
验证
- 在 Manage Jenkins → System Information 检查 http.proxyHost/https.proxyHost 等系统属性是否生效；在插件中心执行更新测试。

二使用 Nginx 作为反向代理并启用 SSL

安装与证书
- 安装 Nginx：sudo apt-get install nginx
- 使用 Let’s Encrypt/Certbot 获取证书（示例域名：jenkins.example.com）：sudo certbot --nginx -d jenkins.example.com

Nginx 配置示例（/etc/nginx/sites-available/jenkins）

将 HTTP 重定向到 HTTPS，并反向代理到本机 8080：

server {
    listen 80;
    server_name jenkins.example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    server_name jenkins.example.com;

    ssl_certificate /etc/letsencrypt/live/jenkins.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/jenkins.example.com/privkey.pem;

    access_log  /var/log/nginx/jenkins.access.log;
    error_log   /var/log/nginx/jenkins.error.log;

    location / {
        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;
        proxy_pass http://127.0.0.1:8080;
        proxy_read_timeout 90;
        proxy_redirect http://localhost:8080 https://jenkins.example.com;
    }
}

启用站点并测试：sudo ln -s /etc/nginx/sites-available/jenkins /etc/nginx/sites-enabled/ && sudo nginx -t && sudo systemctl reload nginx

Jenkins 侧配合
- 建议让 Jenkins 仅监听本地，编辑 /etc/default/jenkins，设置 JENKINS_ARGS=“–httpListenAddress=127.0.0.1 --httpPort=8080”，然后重启 Jenkins。
- 访问 https://jenkins.example.com 验证；如出现 “Reverse proxy set up is broken”，优先检查 proxy_pass 与 proxy_redirect 是否书写正确（尤其避免多余的尾部斜杠）。

三将 Ubuntu 作为 Jenkins 代理节点 Agent

准备
- 在 Ubuntu 代理节点安装 OpenJDK 11/17：sudo apt-get update && sudo apt-get install openjdk-11-jre（或 openjdk-17-jre）
- 确保 SSH 可用（便于主节点连接；如使用 JNLP 方式则无需 SSH 从主到从的连接）
在 Jenkins 主节点添加节点
- 进入 Manage Jenkins → Manage Nodes and Clouds → New Node，输入节点名，选择 Permanent Agent，配置：
  - # of executors、Remote root directory（如 /var/jenkins）、Labels（如 ubuntu-agent）
  - 启动方式常用两种：
    - Launch agent by connecting it to the master（JNLP/WebSocket）：在节点页面获取 Secret 与 JNLP URL，在代理机上执行：
```
wget http://<JENKINS_URL>/jnlpJars/agent.jar
java -jar agent.jar -jnlpUrl http://<JENKINS_URL>/computer/<NODE_NAME>/jenkins-agent.jnlp -secret <SECRET> -workDir "/var/jenkins"
```
    - Launch agents via SSH：填写 Host、Credentials（SSH 私钥或用户名/密码），Jenkins 通过 SSH 启动代理进程。
验证
- 节点列表中状态变为 Online，在节点页查看系统信息、执行简单任务测试。

四常见问题与排查

反向代理错误提示 “Reverse proxy set up is broken”
- 核对 Nginx 的 proxy_pass http://127.0.0.1:8080; 与 proxy_redirect 是否匹配域名与端口；避免 proxy_pass 多余的尾部斜杠；确保 Jenkins 仅监听 127.0.0.1:8080 且证书与域名一致。
插件更新或构建下载失败
- 检查 Manage Jenkins → System → Proxy 的 HTTP/HTTPS Proxy 与 No Proxy；如使用系统级代理，确认 /etc/default/jenkins 中 JAVA_OPTS 已生效并重启 Jenkins。
节点无法上线
- JNLP 方式：确认 Secret 与 JNLP URL 正确、代理机可访问主节点、Java 已安装、工作目录可写。
- SSH 方式：确认 SSH 端口、凭据、用户权限与目录权限正确；首次连接注意 known_hosts 验证策略。

0 赞

0 踩