Debian部署Apache GUI运行run.sh报错且9999端口无法访问问题求助
Debian部署ApacheGUI后9999端口无监听、无法访问的排查解决
已完成的操作与现象记录
- 参照部署教程,在Debian系统的
/usr/local/apachegui/ApacheGUI/bin目录完成ApacheGUI安装 - 首次执行启动命令
sudo ./run.sh时,输出报错:./run.sh: 1: [: -ne: unexpected operator,虽终端提示Tomcat已启动,但通过服务器IP、localhost访问9999/ApacheGUI管理页均提示站点无法访问 - 执行端口监听检查命令
ss -na | grep :9999无任何输出,确认9999端口未处于监听状态;从其他终端连通9999端口时命令直接挂起 - 执行防火墙放行命令开放9999端口:
开放端口命令:
sudo iptables -A INPUT -p tcp --dport 9999 -j ACCEPT - 执行
sudo iptables -L验证规则生效,输出如下,确认9999端口TCP放行规则已加入INPUT链,但端口仍无监听:pi@Home:~ $ sudo iptables -L Chain INPUT (policy ACCEPT) target prot opt source destination ACCEPT tcp -- anywhere anywhere tcp dpt:9999 Chain FORWARD (policy ACCEPT) target prot opt source destination Chain OUTPUT (policy ACCEPT) target prot opt source destination - 重新在
/usr/local/apachegui/ApacheGUI/bin路径下执行./run.sh启动命令,终端输出如下,初始报错消失,提示Tomcat已启动,但依然无法访问:启动输出日志:
Using CATALINA_BASE: /usr/local/apachegui/ApacheGUI/tomcat
Using CATALINA_HOME: /usr/local/apachegui/ApacheGUI/tomcat
Using CATALINA_TMPDIR: /usr/local/apachegui/ApacheGUI/tomcat/temp
Using JRE_HOME: /usr
Using CLASSPATH: /usr/local/apachegui/ApacheGUI/tomcat/bin/bootstrap.jar:/usr/local/apachegui/ApacheGUI/tomcat/bin/tomcat-juli.jar
Tomcat started.
问题排查与解决步骤
- 排查Tomcat假启动问题
脚本输出的Tomcat started.仅代表启动流程执行完成,不代表服务真正完成初始化并绑定端口。执行ps aux | grep tomcat查看是否存在对应Java进程,若无匹配进程,说明服务实际启动失败,仅为脚本流程走完返回了提示。 - 检查Tomcat端口配置
打开内置Tomcat的配置文件/usr/local/apachegui/ApacheGUI/tomcat/conf/server.xml,找到Connector配置段,确认三项配置:- 配置的监听端口是否为教程要求的9999,无注释、无语法错误
- 若存在
address="127.0.0.1"字段,需删除该字段或修改为address="0.0.0.0",否则服务仅能被本机访问,外部连接都会超时 - 确认9999端口未被其他进程占用,通过
sudo lsof -i :9999查看端口占用情况
- 排查shell兼容性导致的启动异常
首次启动出现的./run.sh: 1: [: -ne: unexpected operator报错,是因为Debian默认将/bin/sh指向dash shell,而原启动脚本使用了bash专属的语法规则,脚本执行异常可能导致Tomcat进程启动后快速退出。可显式调用bash执行启动脚本:sudo bash ./run.sh,避免shell兼容问题。 - 检查Java环境兼容性
启动日志显示当前使用的JRE路径为/usr,若系统安装的是JDK17及以上版本,ApacheGUI内置的老旧Tomcat版本可能存在类加载兼容性问题,导致服务启动后立即崩溃。执行java -version确认当前Java版本,临时切换为JDK8环境后重新启动服务。 - 通过启动日志定位具体异常
查看Tomcat实时日志文件/usr/local/apachegui/ApacheGUI/tomcat/logs/catalina.out,定位启动失败的具体原因,常见异常包括:- ApacheGUI目录下的文件权限不足,Tomcat无法读写temp目录、webapp目录导致启动中断
- Java安全异常导致的类加载失败
- 端口绑定失败
内容的提问来源于stack exchange,提问作者Bakepi
相关产品推荐
相关产品推荐

