1. 配置系统网络(基础前提)
确保Debian系统已正确配置网络,这是Jenkins能正常通信的前提。
/etc/network/interfaces文件(适用于Debian 10及以下版本),添加以下内容(根据实际网络环境修改IP、子网掩码、网关和DNS):auto eth0
iface eth0 inet static
address 192.168.1.100
netmask 255.255.255.0
gateway 192.168.1.1
dns-nameservers 8.8.8.8 8.8.4.4
保存后重启网络服务:sudo systemctl restart networking。iface eth0 inet static改为iface eth0 inet dhcp,保存后重启网络服务即可。/etc/netplan/01-netcfg.yaml文件,添加以下内容:network:
version: 2
renderer: networkd
ethernets:
eth0:
dhcp4: no
addresses: [192.168.1.100/24]
gateway4: 192.168.1.1
nameservers:
addresses: [8.8.8.8, 8.8.4.4]
应用配置:sudo netplan apply。2. 安装Jenkins及依赖
Jenkins的网络功能依赖Java环境,需先安装Java,再通过官方仓库安装Jenkins。
sudo apt update
sudo apt install -y openjdk-11-jdk
验证安装:java -version(需显示Java版本信息)。wget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo apt-key add -
echo "deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian-stable binary/" | sudo tee /etc/apt/sources.list.d/jenkins.list
sudo apt update
sudo apt install -y jenkins
安装完成后,Jenkins服务会自动启动(可通过sudo systemctl status jenkins验证状态)。3. 修改Jenkins监听端口(可选但推荐)
Jenkins默认通过8080端口提供Web服务,为避免端口冲突或提高安全性,可修改默认端口。
/etc/default/jenkins,找到HTTP_PORT参数(默认值为8080),修改为所需端口(如8090):HTTP_PORT=8090
sudo systemctl restart jenkins
curl http://localhost:8090(应返回Jenkins欢迎页面的HTML内容)。4. 配置防火墙允许Jenkins端口访问
若服务器启用了防火墙(如UFW),需开放Jenkins的Web端口(默认8080或修改后的端口),否则无法从外部访问。
sudo ufw allow 8090/tcp # 若修改了端口,将8090替换为实际端口
sudo ufw allow 443/tcp
sudo ufw reload
sudo ufw status(应显示8090/tcp端口为“ALLOW”状态)。5. 配置Jenkins Web界面访问
通过浏览器访问Jenkins Web界面,需确保网络可达且端口正确。
http://<服务器IP>:<Jenkins端口>(如http://192.168.1.100:8090),进入Jenkins解锁页面。/var/lib/jenkins/secrets/initialAdminPassword文件中),解锁Jenkins:cat /var/lib/jenkins/secrets/initialAdminPassword
6. 高级网络配置(可选)
/etc/nginx/sites-available/jenkins),添加以下内容:server {
listen 80;
server_name jenkins.example.com; # 替换为你的域名或服务器IP
location / {
proxy_pass http://127.0.0.1:8090; # 替换为Jenkins实际端口
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;
}
}
启用配置并重启Nginx:sudo ln -s /etc/nginx/sites-available/jenkins /etc/nginx/sites-enabled/
sudo systemctl restart nginx
/etc/environment文件,添加代理设置:http_proxy="http://proxy_server_ip:proxy_port/"
https_proxy="https://proxy_server_ip:proxy_port/"
重新加载环境变量:source /etc/environment。