在阿里云服务器上部署 Java Web 应用,Tomcat 是常见选择。安装命令本身不复杂,真正容易卡住的地方通常是 Java 版本不匹配、8080 端口未放行,或应用包部署后报错。下面以阿里云 Linux 服务器为例,说明安装、启动和部署时需要检查的环节。
安装前确认系统与应用版本
以下命令适用于常见的 Alibaba Cloud Linux、CentOS Stream 等使用 dnf 的系统。Ubuntu 用户需要将 dnf 换成 apt,并按系统实际路径调整服务配置。操作时使用具备 sudo 权限的账号;还要确认服务器有公网 IP,或者已准备好通过内网、VPN 等方式访问。
Tomcat 运行依赖 Java。Tomcat 10.1 要求 Java 11 或更高版本,但应用本身也必须兼容对应版本。尤其是旧 Java EE 项目:Tomcat 10 起,相关 API 从 javax 命名空间迁移到了 jakarta,旧代码可能无法直接运行。部署前先核对项目依赖;如果暂时无法升级代码,应选择与项目兼容的 Tomcat 版本,例如合适的 Tomcat 9 版本。
安装 Java 并检查默认版本
以安装 Java 17 开发工具包为例:
sudo dnf update -y
sudo dnf install -y java-17-openjdk-devel
java -version
运行 java -version 后,确认输出的是项目要求的版本。如果服务器上装有多个 Java 版本,不能只看“安装成功”,还要检查当前默认版本。可以用下面的命令查看 Java 实际路径:
readlink -f "$(which java)"
路径通常位于 /usr/lib/jvm 下。后续如果 Tomcat 启动时提示找不到 Java,或调用了错误版本,可以在 systemd 配置里明确填写 JAVA_HOME。
下载 Tomcat 并设置安装目录
从 Apache Tomcat 官方下载页面获取与项目兼容的稳定版本,并按照页面提供的校验文件核对下载内容。下面的版本号只是占位符,执行前要替换成实际版本号:
cd /tmp
TOMCAT_VERSION=10.1.替换为实际版本号
curl -fLO "https://dlcdn.apache.org/tomcat/tomcat-10/v${TOMCAT_VERSION}/bin/apache-tomcat-${TOMCAT_VERSION}.tar.gz"
下载完成后解压到 /opt,再建立统一的 /opt/tomcat 软链接。以后升级时可以切换链接,不必改动服务配置:
sudo tar -xzf apache-tomcat-${TOMCAT_VERSION}.tar.gz -C /opt
sudo ln -s /opt/apache-tomcat-${TOMCAT_VERSION} /opt/tomcat
sudo chmod +x /opt/tomcat/bin/*.sh
如果下载提示文件不存在,先检查版本号、目录路径和镜像站地址。Tomcat 发布目录会随版本变化,不要反复执行同一条错误链接;到 Apache 官网确认对应文件名和下载地址后再试。
创建专用账号并配置 systemd
Tomcat 不建议长期以 root 身份运行。创建一个不能交互登录的系统账号,并把安装目录交给该账号管理:
sudo useradd --system --home-dir /opt/tomcat --shell /sbin/nologin tomcat
sudo chown -R tomcat:tomcat /opt/apache-tomcat-${TOMCAT_VERSION}
创建 /etc/systemd/system/tomcat.service,将以下内容写入文件。JAVA_HOME 应替换成前面查到的实际路径;如果 Java 安装目录不同,照抄示例路径可能导致服务启动失败。
[Unit]
Description=Apache Tomcat
After=network.target
[Service]
Type=forking
User=tomcat
Group=tomcat
Environment="JAVA_HOME=/usr/lib/jvm/java-17-openjdk"
Environment="CATALINA_HOME=/opt/tomcat"
Environment="CATALINA_BASE=/opt/tomcat"
ExecStart=/opt/tomcat/bin/startup.sh
ExecStop=/opt/tomcat/bin/shutdown.sh
Restart=on-failure
[Install]
WantedBy=multi-user.target
保存后让 systemd 重新读取配置,再设置开机启动并立即启动服务:
sudo systemctl daemon-reload
sudo systemctl enable --now tomcat
sudo systemctl status tomcat
状态显示 active (running),说明服务已启动。还可以在服务器本机执行下面的命令,确认 8080 端口有 HTTP 响应:
curl -I http://127.0.0.1:8080
本机访问没有响应时,先看 Tomcat 日志,不要急着调整安全组:
sudo tail -n 100 /opt/tomcat/logs/catalina.out
配置安全组后再从外网访问
Tomcat 默认使用 8080 端口。需要外网访问时,在阿里云控制台找到 ECS 实例关联的安全组,在入方向添加 TCP 8080 规则。测试阶段尽量把来源地址限制为自己的公网 IP,不要为了省事直接向所有地址开放。服务器如果启用了 firewalld,还要检查系统防火墙是否允许该端口。
规则配置完成后,访问 http://服务器公网IP:8080。如果本机 curl 能收到响应,外网仍无法访问,优先核对安全组、系统防火墙和公网 IP。正式对外提供网站时,通常由 Nginx 或负载均衡器接收 80、443 端口流量,再转发给 Tomcat,并配置 HTTPS。不要长期暴露管理端口或默认示例页面。
部署 WAR 包:用访问路径检查结果
假设项目打包生成了 shop.war,希望通过 /shop 访问。把文件放入 Tomcat 的 webapps 目录,并确保 Tomcat 账号有权读取:
sudo cp shop.war /opt/tomcat/webapps/
sudo chown tomcat:tomcat /opt/tomcat/webapps/shop.war
sudo systemctl restart tomcat
Tomcat 通常会自动解压 WAR 包。部署后访问 http://服务器公网IP:8080/shop。遇到 404,先核对 WAR 文件名、应用上下文路径和包内目录结构;出现 500 时,到 catalina.out 查异常,重点检查 Java 版本、依赖包和数据库连接配置。文件已经复制到目录,不代表应用一定部署成功。
启动异常与上线前检查
- 外网无法访问:先在服务器执行
curl -I http://127.0.0.1:8080。本机正常、外网不通时,再检查 ECS 安全组、系统防火墙和公网 IP。 - 服务启动失败:运行
systemctl status tomcat并查看catalina.out,重点检查JAVA_HOME、端口冲突和目录权限。 - 8080 端口已被占用:用
ss -lntp | grep 8080查看占用进程。确认进程用途后再处理,不要直接结束不熟悉的进程。 - 准备升级:先备份配置文件、应用包和数据,再切换
/opt/tomcat软链接。正式业务还应安排日志轮转、监控、定期备份和 HTTPS。
阿里云服务器安装 Tomcat 时,先确认 Java 与项目兼容,再用非 root 账号运行服务,最后分别验证服务器本机和外网访问。上线前在测试环境完整部署一次,能更早发现版本、权限和配置问题,也能避免直接开放不必要的端口。