Jenkins在Ubuntu上的网络配置

Jenkins在Ubuntu上的网络配置

一主机网络与DNS配置

Ubuntu 18.04 及以后默认使用 Netplan 管理网络。编辑 /etc/netplan/*.yaml（文件名因环境而异，如 50-cloud-init.yaml），设置静态地址、网关与 DNS，然后应用：
```
network:
  version: 2
  renderer: networkd
  ethernets:
    enp0s3:
      dhcp4: no
      addresses: [10.0.2.15/24]
      gateway4: 10.0.2.1
      nameservers:
        addresses: [8.8.8.8, 8.8.4.4]
sudo netplan apply
```
若使用 NetworkManager，也可用 nmcli 设置 DNS：
```
sudo nmcli con modify "Wired connection 1" ipv4.dns "8.8.8.8, 8.8.4.4"
sudo nmcli con up "Wired connection 1"
```
某些云镜像或系统可能使用 /etc/systemd/resolved.conf 管理 DNS，可按需配置并重启相关服务。以上步骤完成后，建议用 ping 与 nslookup 验证连通性与解析是否正常。

二防火墙与端口开放

放行 Jenkins Web 端口 8080 与 Agent 通信端口 50000（如使用内置 SSH 代理模式）：
```
sudo ufw allow 8080/tcp
sudo ufw allow 50000/tcp
sudo ufw reload
sudo ufw status verbose
```
如运行在云服务器，还需在云平台安全组放行对应端口。完成后可用 sudo netstat -tulpen | grep -E '8080|50000' 确认监听状态。

三反向代理与域名访问

使用 Nginx 作为反向代理，将域名或公网 IP 的 80/443 转发至本机 8080，便于启用 HTTPS 与统一入口：

sudo apt-get update && sudo apt-get install -y nginx
sudo tee /etc/nginx/sites-available/jenkins <<'EOF'
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;
  }
}
EOF
sudo ln -s /etc/nginx/sites-available/jenkins /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

如需 HTTPS，可结合 Let’s Encrypt 与 certbot 配置 443 端口与证书。

四 Docker部署时的端口映射

Docker Compose 示例（将主机 8080/50000 映射到容器）：

version: '3.8'
services:
  jenkins:
    image: jenkins/jenkins:lts
    restart: always
    ports:
      - "8080:8080"
      - "50000:50000"
    environment:
      TZ: Asia/Shanghai
    volumes:
      - jenkins_data:/var/jenkins_home
volumes:
  jenkins_data:

首次启动后，可在容器日志或挂载目录的 secrets/initialAdminPassword 获取初始管理员密码。注意主机防火墙与安全组同样需要放行 8080/50000。

五连通性与故障排查

基础连通性：ping 网关与公网地址、nslookup 验证 DNS 解析。
端口与监听：sudo ufw status、sudo netstat -tulpen | grep -E '8080|50000' 确认端口开放与监听地址。
服务状态：sudo systemctl status jenkins，必要时 sudo systemctl restart jenkins 并查看日志（如 /var/log/jenkins/jenkins.log 或 JENKINS_HOME/logs/）。
资源与插件：检查 磁盘空间、Java 版本兼容、插件镜像源与版本冲突；必要时调整 JVM 堆大小与构建并发。以上步骤可快速定位大多数网络与服务可用性异常。

最新问答

相关标签