把 Java Web 项目放到云服务器上,除了上传应用,还要确认操作系统、Java 版本、网络入口和服务管理都能配合。本文以常见的阿里云 ECS Linux 实例为例,介绍阿里云服务器部署 Tomcat 的基本流程,并通过一个小型业务系统说明如何验证上线结果。命令适用于常见的 Alibaba Cloud Linux、CentOS 系环境;不同系统的软件包名称和目录路径可能不同,执行前需要核对。
部署前确认版本、登录和访问方式
- 确认实例可以登录:先检查 ECS 是否已创建,并通过 SSH 登录。日常操作建议使用普通运维账号,需要安装软件或修改系统配置时再使用 sudo。
- 按项目要求选择 Java 和 Tomcat:Tomcat 10.1 通常需要 Java 11 或更高版本。旧项目如果依赖 javax 命名空间,可能需要 Tomcat 9。先核对项目依赖,再选版本,避免只追求使用较新的版本。
- 确定对外访问方式:测试时可以临时开放 8080 端口;正式服务通常由 Nginx 或负载均衡提供 HTTPS 入口。不要长期把 Tomcat 端口直接暴露到公网。
还要检查阿里云控制台中的安全组规则。安全组负责控制实例的网络访问;即使 Tomcat 已在服务器上启动,如果规则没有放行对应端口,外部浏览器仍然无法访问。
安装 Java 运行环境
登录 ECS 后,安装与项目兼容的 JDK。以 Alibaba Cloud Linux 或兼容的 yum/dnf 系统为例,可以尝试执行:
sudo dnf install java-17-openjdk -y
如果系统使用 yum,可以将命令中的 dnf 替换为 yum。项目需要其他 Java 版本时,应安装相应版本,而不是直接照搬示例。安装完成后执行:
java -version
终端应显示 Java 版本信息。如果提示找不到命令,先检查软件包是否安装成功。正式环境还要确认应用所需的 JDK 版本、启动参数和证书配置,尽量避免开发环境与 ECS 上的运行环境不一致。
下载并配置 Tomcat
从 Apache Tomcat 官方网站选择与项目兼容的稳定版本,并下载官方二进制压缩包。不要使用来源不明的安装包。以下以将 Tomcat 放在 /opt 目录为例,版本号和下载地址需要替换为官网提供的实际信息。
先创建安装目录:
sudo mkdir -p /opt/tomcat
下载并解压后,检查目录中是否包含 bin、conf、logs 和 webapps 等子目录。建议为 Tomcat 创建独立运行账号,降低服务出现安全问题时对系统其他部分的影响:
sudo useradd --system --home /opt/tomcat --shell /sbin/nologin tomcat
假设解压后的目录是 /opt/tomcat/apache-tomcat-版本号,就将它作为 CATALINA_HOME。调整目录所有权,并给启动脚本添加执行权限:
sudo chown -R tomcat:tomcat /opt/tomcat/apache-tomcat-版本号
sudo chmod +x /opt/tomcat/apache-tomcat-版本号/bin/*.sh
部署时可以把版本目录和实际运行目录分开,用软链接指向当前版本。升级时切换链接,或保留旧版本目录,就不必直接覆盖正在使用的安装目录,也更方便在新版本启动异常时回退。
配置 systemd 服务
手动运行启动脚本适合临时测试,但 ECS 重启后不会自动恢复。可以通过 systemd 管理 Tomcat,实现开机启动和统一查看服务状态。创建服务文件:
sudo nano /etc/systemd/system/tomcat.service
写入以下配置,并将目录和 Java 路径替换为服务器上的实际值:
[Unit]
After=network.target
[Service]
Type=forking
User=tomcat
Group=tomcat
Environment=JAVA_HOME=/usr/lib/jvm/java-17-openjdk
Environment=CATALINA_HOME=/opt/tomcat/apache-tomcat-版本号
Environment=CATALINA_BASE=/opt/tomcat/apache-tomcat-版本号
ExecStart=/opt/tomcat/apache-tomcat-版本号/bin/startup.sh
ExecStop=/opt/tomcat/apache-tomcat-版本号/bin/shutdown.sh
Restart=on-failure
[Install]
WantedBy=multi-user.target
JAVA_HOME 的实际路径会随系统和安装方式变化。可以先执行 readlink -f $(which java) 查看 Java 可执行文件的位置,再据此确认路径。保存服务文件后运行:
sudo systemctl daemon-reload
sudo systemctl enable --now tomcat
sudo systemctl status tomcat
状态显示 active 通常表示服务已启动。若启动失败,先查看 sudo journalctl -u tomcat -n 100,再检查 Tomcat 的 logs 目录。Java 路径不正确、目录权限不足、端口被占用或配置文件写错,都可能导致启动失败。
部署 WAR 包并检查访问
将构建好的 WAR 包上传到 Tomcat 的 webapps 目录,并确认 tomcat 账号有权限读取。默认情况下,名为 shop.war 的应用通常可以通过“服务器地址:8080/shop”访问。如果项目需要使用根路径,可以根据项目部署方式将包命名为 ROOT.war。
应用启动后查看 Tomcat 日志,确认数据库地址、连接账号、配置文件和依赖服务都已正确设置。排查网络问题时,先在 ECS 本机执行:
curl -I http://127.0.0.1:8080/
如果本机能收到 HTTP 响应,外部浏览器却无法访问,重点检查阿里云安全组是否放行 TCP 8080、系统防火墙是否拦截,以及实例是否绑定公网 IP。临时测试只开放必要端口,并尽量限制来源 IP。
正式环境可以让 Nginx 监听 80/443,再将请求反向代理到本机 Tomcat 的 8080 端口,并配置 HTTPS 证书。这样 8080 不必对公网开放,外部访问统一经过 HTTPS 入口。
案例:上线内部订单查询系统
某小型贸易团队将一个 Spring 项目部署在 2 核 4GB 的 ECS 上,项目使用 Java 17,打包文件为 order.war。团队先在测试环境确认项目兼容的 Tomcat 版本,再安装 Java 和 Tomcat,并把 Tomcat 配置为开机启动。首次上线时,他们只给测试人员的固定 IP 临时开放 8080,通过“公网 IP:8080/order”检查登录、查询和数据库连接是否正常。
测试通过后,团队在同一台 ECS 上配置 Nginx 处理 HTTPS 请求,并把外部流量转发到 127.0.0.1:8080,随后关闭安全组中的公网 8080 入口。更新应用前,他们保留旧 WAR 包和配置备份。新版本启动异常时,先查看 Tomcat 日志,再恢复上一版本。这个做法能覆盖版本兼容、网络访问、服务自启和回滚等常见问题,操作也不复杂。
上线前检查
- 确认 Java 版本与项目依赖兼容,Tomcat 版本符合应用要求。
- 让 Tomcat 使用独立账号运行,避免把目录权限设置得过宽。
- 通过 systemctl 管理服务,并在 ECS 重启后确认 Tomcat 能正常启动。
- 安全组只开放业务需要的端口;正式环境优先使用 HTTPS 入口,不直接暴露 Tomcat 的 8080 端口。
- 确认应用日志、访问日志和备份安排,并为升级保留回退方案。
阿里云服务器部署 Tomcat 的安装步骤并不繁琐,版本、权限和网络规则更容易影响上线结果。先在小范围验证,再逐步开放访问;升级前留好备份和回退路径,出问题时也更容易定位。