Debian Jenkins如何配置网络代理

Debian环境下Jenkins配置网络代理的完整步骤

一、全局代理配置（适用于Jenkins所有任务及插件）

全局代理是Jenkins整体访问外部网络的默认配置，需通过管理界面完成设置：

1. 登录Jenkins管理界面
   打开浏览器，访问http://<Jenkins服务器IP>:8080（默认端口为8080），输入管理员账号密码登录。
2. 进入系统设置页面
   点击顶部导航栏Manage Jenkins（管理Jenkins），选择Configure System（配置系统）。
3. 配置HTTP/HTTPS代理
   在配置页面中找到HTTP(S) Proxy Configuration（HTTP/HTTPS代理配置）部分，填写以下信息：
   • Proxy Host：代理服务器地址（如proxy.example.com或IP地址）；
   • Proxy Port：代理服务器端口（如8080）；
   • Username/Password（可选）：若代理服务器需要身份验证，输入对应的用户名和密码；
   • No Proxy Hosts（可选）：无需通过代理访问的主机列表（如localhost,127.0.0.1,192.168.1.0/24，多个主机用逗号分隔）。
4. 保存配置
   点击页面底部Save（保存）按钮，使配置生效。

二、项目级代理配置（适用于特定任务）

若仅需部分项目通过代理访问外部资源，可在项目配置中单独设置：

1. 进入项目配置页面
   在Jenkins主页选择目标项目，点击Configure（配置）。
2. 开启自定义代理
   在配置页面中找到Build Environment（构建环境）部分，勾选Use custom HTTP(S) proxy settings（使用自定义HTTP/HTTPS代理设置）。
3. 填写代理信息
   输入与全局代理一致的Proxy Host、Proxy Port及认证信息（若有）。
4. 保存配置
   点击Save（保存），该项目的构建任务将优先使用此代理设置。

三、系统环境变量配置（可选，影响Jenkins服务及依赖进程）

若Jenkins服务或依赖的工具（如apt、wget）需要通过代理访问网络，可通过设置系统环境变量实现：

1. 编辑环境变量文件
   打开终端，编辑系统级环境变量文件/etc/environment（对所有用户生效）或用户级文件~/.bashrc（仅对当前用户生效）：

   sudo nano /etc/environment
   

2. 添加代理配置
   在文件末尾添加以下内容（替换为实际代理信息）：

   http_proxy="http://proxy.example.com:8080"
   https_proxy="http://proxy.example.com:8080"
   no_proxy="localhost,127.0.0.1,192.168.1.0/24"
   

3. 使配置生效
   保存文件后，运行以下命令使环境变量立即生效：

   source /etc/environment
   

   或重新登录终端。

四、Jenkins启动参数配置（可选，覆盖默认代理设置）

若需通过Jenkins启动参数强制指定代理（如全局配置失效时），可修改Jenkins启动命令：

1. 编辑Jenkins启动脚本
   若Jenkins通过systemd服务运行，编辑服务文件：

   sudo nano /etc/systemd/system/jenkins.service
   

   在[Service]部分添加以下内容：

   Environment="http_proxy=http://proxy.example.com:8080"
   Environment="https_proxy=http://proxy.example.com:8080"
   Environment="no_proxy=localhost,127.0.0.1,192.168.1.0/24"
   

2. 重载systemd配置并重启服务
   保存文件后，运行以下命令使配置生效：

   sudo systemctl daemon-reload
   sudo systemctl restart jenkins
   

注意事项

• 代理类型支持：Jenkins支持HTTP、HTTPS、SOCKS等代理类型，需根据代理服务器类型填写对应地址（如SOCKS代理需使用socks://开头）；
• 认证问题：若代理服务器需要身份验证，确保输入正确的用户名和密码；
• 测试代理连通性：配置完成后，可通过Jenkins任务执行curl -v http://example.com（或wget http://example.com）命令，验证是否能正常访问外部网络；
• 防火墙设置：确保Debian服务器的防火墙（如ufw、iptables）允许Jenkins服务通过代理端口访问外部网络（如sudo ufw allow 8080/tcp）。