Linux 安装 Tomcat 须手动解压、正确配置 JAVA_HOME 指向 JDK(非 JRE)、修改 tomcat-users.xml 启用 manager-gui 角色,并用 systemd 托管时配对 Type=forking 与 PIDFile。
Linux 上安装 Tomcat 不需要“安装包”意义上的安装,而是解压即用;但必须确保 JAVA_HOME 正确且 java -version 能输出 JDK 8+ 版本,否则 startup.sh 会静默失败或报 Cannot find ./bin/setclasspath.sh 类似错误。
确认系统已装 JDK 并配置 JAVA_HOME
Tomcat 是 Java 应用,不自带 JRE,依赖系统级 JDK。常见误区是只装了 openjdk-11-jre(只有运行时),没装 openjdk-11-jdk(含 javac 和 tools.jar,Tomcat 启动脚本会检测)。
- 运行
java -version和javac -version,两者输出版本号必须一致且 ≥ 8 - 检查
$JAVA_HOME:执行echo $JAVA_HOME,应指向 JDK 根目录(如/usr/lib/jvm/java-11-openjdk-amd64),不是jre子目录 - 若未设置,临时生效可运行:
export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64;永久生效需写入~/.bashrc或/etc/profile
下载并解压 Tomcat,避免用系统包管理器安装
Debian/Ubuntu 的 apt install tomcat9 或 CentOS 的 yum install tomcat 会把文件散落到 /usr/share/tomcat9、/var/lib/tomcat9 等多处,权限、日志路径、启动方式均被封装,不利于调试和定制。生产环境推荐手动解压部署。
- 从官网下载二进制 tar.gz 包(如
apache-tomcat-10.1.24.tar.gz),不要下 zip 或 src 包 - 解压到非 root 目录,例如:
tar -xzf apache-tomcat-10.1.24.tar.gz -C /opt/→ 得到/opt/apache-tomcat-10.1.24 - 改属主(尤其如果你用
sudo解压过):sudo chown -R $USER:$USER /opt/apache-tomcat-10.1.24
启动前必须修改 conf/tomcat-users.xml 才能访问 Manager 页面
默认 Tomcat 禁用所有管理界面,直接访问 http://localhost:8080/manager/html 会 403。这不是端口或防火墙问题,是权限配置缺失。