Debian Java配置中网络设置

Debian Java网络设置

一 系统网络先行

• 确认网卡与地址：使用命令查看接口与IP，例如 ip addr show；确保目标网卡处于UP且有有效IP。
• 选择管理方式并配置：
  • 使用 ifupdown：编辑 /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 配置，例如：
    nmcli con mod “ens160” ipv4.addresses 192.168.125.137/24
    nmcli con mod “ens160” ipv4.gateway 192.168.125.2
    nmcli con mod “ens160” ipv4.dns “8.8.8.8 8.8.4.4”
    nmcli con mod “ens160” ipv4.method manual
    应用：nmcli con down “ens160” && nmcli con up “ens160”。
• 验证：ping 一个外部地址（如 1.1.1.1）与域名（如 www.google.com），确认连通性与DNS解析正常。

二 JVM网络参数与常见异常

• 常用JVM网络参数（启动Java时设置）：
  • -Djava.net.preferIPv4Stack=true：优先使用IPv4，避免双栈环境下的解析/连通性差异。
  • -Dhttp.proxyHost=… -Dhttp.proxyPort=… -Dhttps.proxyHost=… -Dhttps.proxyPort=…：配置HTTP/HTTPS代理。
  • -Dhttp.nonProxyHosts=localhost|127.0.0.1|*.example.com：不走代理的主机。
  • -DsocksProxyHost=… -DsocksProxyPort=…：SOCKS代理。
  • -Dnetworkaddress.cache.ttl=60 -Dnetworkaddress.cache.negative.ttl=10：调整DNS缓存时间（秒）。
• 典型异常与处置要点：
  • java.net.ConnectException：目标主机/端口不可达，先用 telnet/nc 测试端口，核查防火墙/安全组。
  • java.net.SocketTimeoutException：适当增加超时，检查链路稳定性与服务端性能。
  • java.net.UnknownHostException：域名解析失败，核查DNS（/etc/resolv.conf、nslookup/dig）。
  • java.net.BindException：端口被占用，换端口或释放占用进程。
  • javax.net.ssl.SSLHandshakeException：证书不受信任，导入CA证书到信任库（生产环境不建议关闭校验）。

三 代理与SSL证书要点

• 应用侧代理配置：在启动脚本或 systemd 服务中注入代理参数，例如：
  ExecStart=/usr/bin/java -Dhttp.proxyHost=proxy.corp -Dhttp.proxyPort=8080
  -Dhttps.proxyHost=proxy.corp -Dhttps.proxyPort=8080
  -Dhttp.nonProxyHosts=“localhost|127.0.0.1|*.internal”
  -jar /opt/app/app.jar
• 证书信任：对自签名/私有CA证书，将其导入 JRE cacerts（keytool -importcert），或在代码中配置自定义 TrustManager（仅限受控环境）。
• 透明代理/企业网关：若走 WPAD/PAC 或 iptables TPROXY，确保 HTTP(S)_PROXY 环境变量与JVM参数一致，避免应用内直连导致绕行。

四 快速排查清单

• 接口与路由：ip addr、ip route；确认默认网关可达（例如 ping 默认网关）。
• 连通性：先 ping 1.1.1.1，再 ping 域名；若域名失败，检查 /etc/resolv.conf 与 DNS 服务器。
• 端口可达：对目标主机用 telnet 主机 端口 或 nc -vz 主机 端口 验证。
• 防火墙/安全组：临时关闭防火墙验证是否为策略阻断，必要时放通对应端口/方向。
• Java侧：核对代理参数、DNS缓存、SSL证书；开启 -Djavax.net.debug=ssl 获取SSL握手细节（调试用）。

五 实践示例

• 场景：在 Debian 12 上运行一个需要走公司代理的 Spring Boot 应用，并优先使用 IPv4。
• 步骤：
  1. 确认系统与DNS正常：ip addr；ping 1.1.1.1；ping www.google.com。
  2. 启动参数示例：
     java -Djava.net.preferIPv4Stack=true
     -Dhttp.proxyHost=proxy.corp -Dhttp.proxyPort=8080
     -Dhttps.proxyHost=proxy.corp -Dhttps.proxyPort=8080
     -Dhttp.nonProxyHosts=“localhost|127.0.0.1|*.internal”
     -jar /opt/app/app.jar
  3. 若访问内部HTTPS服务报 SSL 握手失败，导入内部 根/中间CA 到 $JAVA_HOME/lib/security/cacerts，再重启应用。