Debian上Jenkins的网络配置

Debian上Jenkins的网络配置

一 系统网络与防火墙放行

• 设置主机名（便于识别）：sudo hostnamectl set-hostname app。
• 放行端口（UFW）：sudo ufw allow 8080/tcp；sudo ufw allow 50000/tcp；sudo ufw reload。
• 验证端口：sudo ufw status 应显示 8080/tcp 与 50000/tcp 为 ALLOW。
• 云服务器或物理防火墙/安全组需同步放行上述端口。
• 说明：Jenkins Web 默认端口为 8080，Agent 通信默认端口为 50000。

二 静态IP与DNS配置

• 传统方式（/etc/network/interfaces，适用于多数 Debian 版本）
  • 编辑：sudo nano /etc/network/interfaces
  • 示例：

    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
• 使用 NetworkManager（nmcli）
  • 新建连接：sudo nmcli con add type ethernet con-name my_connection ifname eth0
  • 配置：
    sudo nmcli con modify my_connection ipv4.addresses 192.168.1.100/24
    sudo nmcli con modify my_connection ipv4.gateway 192.168.1.1
    sudo nmcli con modify my_connection ipv4.dns “8.8.8.8 8.8.4.4”
    sudo nmcli con up my_connection
• 验证：ip addr show eth0；ping www.google.com
• 提示：接口名（如 eth0）与地址段请按实际环境替换。

三 Jenkins监听端口与访问地址

• 修改默认端口（可选）
  • 编辑：sudo nano /etc/default/jenkins
  • 将 HTTP_PORT=8080 改为如 8081
  • 重启：sudo systemctl restart jenkins
• 设置 Jenkins URL（管理界面）
  • Manage Jenkins → Configure System → Jenkins Location → Jenkins URL：如 http://<服务器IP>:8081
• 首次访问与初始密码
  • 浏览器访问：http://<服务器IP>:8080（或 8081）
  • 初始密码：cat /var/lib/jenkins/secrets/initialAdminPassword
• 说明：端口变更后，需同步在防火墙放行新端口。

四 代理与插件源优化

• 通过代理访问互联网
  • 编辑：sudo nano /etc/environment
  • 添加（替换为实际代理）：
    http_proxy=“http://proxy.example.com:8080”
    https_proxy=“http://proxy.example.com:8080”
  • 使生效：source /etc/environment
• 加速插件安装
  • Manage Jenkins → Plugin Manager → Advanced → Update Site URL：
    https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json
• 说明：代理环境变量会影响 Jenkins 插件与更新中心的下载。

五 常见问题排查

• 端口未放行：sudo ufw status 检查 8080/50000 状态；云上需检查安全组规则。
• 服务未监听：ss -ltnp | grep :8080 或 :50000；确认 /etc/default/jenkins 中 HTTP_PORT 与防火墙一致。
• 页面无法访问：确认服务器IP、端口、路由与云安全组；curl http://localhost:8080 做本机连通性验证。
• 网络不通：ip addr 检查地址；ping 网关与 8.8.8.8 排查路由与DNS；必要时检查 /etc/resolv.conf 的 nameserver。