Tomcat部署Guacamole后远程主机显示IPv6回环地址问题求助

原因分析 #

Tomcat默认同时启用IPv4和IPv6监听，Guacamole获取客户端地址时，会收到包含真实IPv4与IPv6回环的地址列表，导致历史记录优先/错误显示IPv6回环地址。

具体解决步骤 #

1. 强制Tomcat仅监听IPv4地址 #

编辑Tomcat安装目录下的conf/server.xml文件，修改HTTP（或HTTPS）连接器配置，添加address="0.0.0.0"属性，指定Tomcat仅监听IPv4的所有地址：
原Connector配置示例：

<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443" />

修改后：

<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443"
           address="0.0.0.0" />

如果使用HTTPS连接器，同样添加address="0.0.0.0"属性即可。

2. （可选）通过JVM参数禁用IPv6支持 #

若上述配置无效，可强制JVM优先使用IPv4，编辑Tomcat的启动脚本：

• Linux系统：修改bin/catalina.sh，在文件开头添加：

JAVA_OPTS="$JAVA_OPTS -Djava.net.preferIPv4Stack=true -Djava.net.preferIPv6Addresses=false"

• Windows系统：修改bin/catalina.bat，在文件开头添加：

set JAVA_OPTS=%JAVA_OPTS% -Djava.net.preferIPv4Stack=true -Djava.net.preferIPv6Addresses=false

3. 重启Tomcat服务 #

完成配置修改后，重启Tomcat服务，重新通过Guacamole登录并访问远程主机，此时【用户】->【设置】->【历史】的【远程主机】列将显示真实IPv4地址，Catalina.log中也只会记录单一的IPv4来源地址。

内容的提问来源于stack exchange，提问作者Marcofe