Debian系統上Jenkins網絡配置指南
在配置Jenkins網絡前,需先確保Debian系統的網絡連接穩定,主要包括靜態IP/動態IP設置、DNS配置及防火墻放行。
Debian系統可通過/etc/network/interfaces
(傳統方式)或Netplan
(Debian 18+推薦)配置網絡,以下分別說明:
/etc/network/interfaces
(適用于Debian 10及更早版本)編輯文件:sudo nano /etc/network/interfaces
,添加以下內容(以靜態IP為例):
auto eth0
iface eth0 inet static
address 192.168.1.100 # 替換為你的靜態IP
netmask 255.255.255.0 # 子網掩碼
gateway 192.168.1.1 # 網關地址
dns-nameservers 8.8.8.8 8.8.4.4 # DNS服務器
保存后重啟網絡服務:sudo systemctl restart networking
。
Netplan
(適用于Debian 18及以上版本)編輯Netplan配置文件(如/etc/netplan/01-netcfg.yaml
):
network:
version: 2
renderer: networkd
ethernets:
eth0:
dhcp4: no # 關閉DHCP(靜態IP)
addresses: [192.168.1.100/24] # IP地址及子網掩碼
gateway4: 192.168.1.1 # 網關
nameservers:
addresses: [8.8.8.8, 8.8.4.4] # DNS服務器
應用配置:sudo netplan apply
。
若系統啟用ufw
防火墻,需允許Jenkins默認端口(8080)及其他必要端口(如Agent通信的50000端口):
sudo ufw allow 8080/tcp # Jenkins Web界面端口
sudo ufw allow 50000/tcp # Jenkins Agent通信端口
sudo ufw reload # 重新加載防火墻規則
完成系統網絡配置后,需針對Jenkins本身進行網絡參數調整。
默認情況下,Jenkins通過8080
端口提供Web服務。若需更改端口,編輯Jenkins配置文件:
sudo nano /etc/default/jenkins
找到HTTP_PORT
參數(通常位于文件頂部),修改為所需端口(如8090
):
HTTP_PORT=8090
保存后重啟Jenkins服務:sudo systemctl restart jenkins
。
進入Jenkins管理界面(http://<服務器IP>:<新端口>
),點擊左側菜單欄Manage Jenkins > Configure System,在“Jenkins Location”部分修改“Jenkins URL”為:
http://<服務器IP>:<新端口>
點擊“Save”保存設置。
為提高安全性及可擴展性,可使用Nginx作為Jenkins的反向代理,隱藏直接IP地址。步驟如下:
sudo apt install nginx -y
/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;
}
}
sudo ln -s /etc/nginx/sites-available/jenkins /etc/nginx/sites-enabled/
sudo systemctl restart nginx
若Jenkins需通過代理訪問互聯網,編輯/etc/environment
文件:
http_proxy="http://proxy_server_ip:proxy_port/"
https_proxy="https://proxy_server_ip:proxy_port/"
保存后重新加載環境變量:source /etc/environment
。
ip addr show eth0
(確認IP地址、子網掩碼、網關是否正確);ping www.google.com
(測試網絡連通性)。curl http://localhost:<新端口>
(如http://localhost:8090
),應返回Jenkins歡迎頁面的HTML內容。http://<服務器IP>:<新端口>
,確認能正常訪問Jenkins。