阿里云虚拟主机为什么无法直接部署war包？

将Java Web应用（WAR包）部署到云端服务器是现代软件开发的标准流程，而阿里云弹性计算服务（ECS，即虚拟主机）因其稳定、灵活和强大的生态支持，成为众多开发者的首选，本文将详细、系统地介绍如何将一个WAR文件部署到阿里云ECS虚拟主机上，涵盖从环境准备到最终验证的全过程。

前期准备工作

在开始部署之前,确保你已经具备了以下基本条件，这些准备工作是顺利部署的基础。

1 阿里云ECS实例准备
你需要一个已经创建并运行中的阿里云ECS实例，推荐选择CentOS或Alibaba Cloud Linux等主流Linux发行版作为操作系统，在创建实例时，请特别注意以下几点：

• 网络配置：确保ECS实例分配了公网IP地址，以便能够从外部访问。
• 安全组规则：安全组是云服务器的虚拟防火墙，必须预先配置好入方向规则，至少放行SSH（端口22）、HTTP（端口80）和Tomcat默认端口（如8080）的访问权限，如果忘记配置，后续将无法连接服务器或访问Web应用。

2 本地工具准备
在你的本地计算机上，需要准备以下工具：

• SSH客户端：用于远程连接到ECS服务器，如Xshell、PuTTY或Mac/Linux系统自带的终端。
• 文件传输工具：用于将本地的WAR包上传到服务器，推荐使用支持SFTP协议的工具，如FileZilla、Xftp或WinSCP。
• WAR应用包：确保你已经拥有一个通过Maven或Gradle等工具打包好的、可运行的.war文件。

3 Java Web应用 (WAR包)
确认你的WAR包没有问题，并且你知道它的上下文路径，如果你的WAR包名为myapp.war，那么部署后，它的默认访问路径通常是http://<服务器IP>:8080/myapp。

服务器环境配置

一台全新的ECS实例就像一台裸机,需要安装和配置Java运行环境以及Web服务器来承载Java应用。

1 安装Java运行环境 (JRE/JDK)
Tomcat需要Java环境才能运行，以CentOS系统为例，可以通过yum命令快速安装OpenJDK。

# 更新软件包列表
sudo yum update -y
# 安装OpenJDK 8 (可根据项目需求选择其他版本，如11, 17)
sudo yum install java-1.8.0-openjdk-devel -y
# 验证安装是否成功
java -version

如果成功执行,终端会显示出已安装的Java版本信息。

2 安装与配置Tomcat
Apache Tomcat是最流行的Java Web应用服务器之一，推荐直接从Tomcat官网下载稳定版，并手动安装配置。

# 进入/usr/local目录
cd /usr/local
# 下载Tomcat (以Tomcat 9为例，可替换为最新稳定版链接)
sudo wget https://downloads.apache.org/tomcat/tomcat-9/v9.0.85/bin/apache-tomcat-9.0.85.tar.gz
# 解压
sudo tar -xvf apache-tomcat-9.0.85.tar.gz
# 重命名目录（可选，便于管理）
sudo mv apache-tomcat-9.0.85 tomcat9

为了方便管理,可以为Tomcat创建一个专用的用户，并赋予相应权限。

# 创建tomcat用户
sudo useradd -r -s /bin/false tomcat
# 更改tomcat9目录的所有者
sudo chown -R tomcat:tomcat /usr/local/tomcat9

启动Tomcat：

# 切换到bin目录
cd /usr/local/tomcat9/bin
# 启动Tomcat
sudo ./startup.sh

在浏览器中访问 http://<你的ECS公网IP>:8080，如果看到Tomcat的欢迎页面，说明环境配置成功。

Tomcat核心目录结构
为了更好地进行后续操作和故障排查，了解Tomcat的关键目录至关重要。

部署WAR包

环境就绪后,就可以将WAR包部署到服务器上了，这里介绍两种最常用的方法。

1 方法一：直接上传至webapps目录（推荐）
这是最直接、最简单的方式，Tomcat会自动检测webapps目录下的文件变化，并自动部署新的应用。

1. 使用FileZilla等SFTP工具,连接到你的ECS服务器。
2. 导航到Tomcat的webapps目录，即/usr/local/tomcat9/webapps。
3. 将本地的myapp.war文件直接拖拽上传到此目录。
4. Tomcat会在几秒钟内自动解压WAR包,并创建一个名为myapp的文件夹，你可以通过查看logs/catalina.out日志文件来确认部署过程。
5. 在浏览器中访问 http://<你的ECS公网IP>:8080/myapp，即可看到你的Web应用。

2 方法二：使用Tomcat Manager管理界面
此方法适合需要频繁部署、卸载或重启多个应用的场景，但需要额外配置。

1. 修改Tomcat的配置文件以开启Manager功能,编辑/usr/local/tomcat9/conf/tomcat-users.xml文件，在<tomcat-users>标签内添加一个具有管理权限的用户。

   <role rolename="manager-gui"/>
   <role rolename="admin-gui"/>
   <user username="your_admin" password="your_secure_password" roles="manager-gui,admin-gui"/>

2. 为了安全,Manager App默认只允许本地访问，需要编辑/usr/local/tomcat9/webapps/manager/META-INF/context.xml，注释掉<Valve>部分以允许远程访问，或者在其中加入你的IP地址。
3. 重启Tomcat使配置生效。

   cd /usr/local/tomcat9/bin
   sudo ./shutdown.sh
   sudo ./startup.sh

4. 访问 http://<你的ECS公网IP>:8080/manager/html，输入刚才配置的用户名和密码登录。
5. 在“WAR file to deploy”部分，选择你的WAR文件并上传，Tomcat会自动完成部署。

安全组与防火墙配置

这是一个至关重要但容易被忽略的环节,如果无法访问应用，首先应检查此项。

• 阿里云安全组：登录阿里云控制台，找到你的ECS实例，检查其关联的安全组入方向规则是否已放行8080端口。

• 服务器内部防火墙：Linux系统（如CentOS 7+）默认使用firewalld，需要放行8080端口。

  # 添加8080端口到public zone
  sudo firewall-cmd --zone=public --add-port=8080/tcp --permanent
  # 重新加载防火墙配置
  sudo firewall-cmd --reload
  # 查看已开放的端口
  sudo firewall-cmd --list-ports

验证与常见问题排查

部署完成后,通过浏览器访问应用URL进行验证，如果遇到问题，可以按以下步骤排查：

1. 检查服务状态：执行ps -ef | grep tomcat，确认Tomcat进程是否在运行。
2. 查看端口监听：执行netstat -anp | grep 8080，确认8080端口是否被Tomcat监听。
3. 阅读日志：日志是最好的朋友，优先查看/usr/local/tomcat9/logs/catalina.out，它包含了Tomcat的启动和部署日志，如果应用内部出错，还应查看应用自身生成的日志。
4. 检查URL：确认访问的URL路径、端口号和上下文路径是否正确。

通过以上步骤,你应该能够成功地将WAR应用部署到阿里云虚拟主机上，并使其稳定运行。

相关问答 (FAQs)

Q1: 我使用root用户上传了WAR包到webapps目录，但Tomcat没有自动部署，这是为什么？
A1: 这通常是由于文件权限问题导致的，当你使用root用户上传文件时，该文件的所有者和所属组都是root，而Tomcat进程是以我们之前创建的tomcat用户身份运行的，tomcat用户对root拥有的文件没有写入权限，因此无法解压和部署，解决方法是修改文件的所有者，执行以下命令即可：

# 假设你的Tomcat安装在/usr/local/tomcat9
sudo chown -R tomcat:tomcat /usr/local/tomcat9/webapps/myapp.war
sudo chown -R tomcat:tomcat /usr/local/tomcat9/webapps/myapp

将myapp替换为你的应用名，执行后，Tomcat通常就能成功部署了。

Q2: 我更新了WAR包，如何让Tomcat重新加载新版本的应用？
A2: Tomcat支持热部署，默认情况下，当你删除webapps目录下已解压的应用文件夹（如myapp）并上传新的WAR包时，Tomcat会自动检测到变化并重新部署，另一种方法是，在conf/server.xml的<Host>标签中，确保autoDeploy属性为true（默认即为true），如果热部署失败或你想强制刷新，最稳妥的方式是重启Tomcat服务：

cd /usr/local/tomcat9/bin
sudo ./shutdown.sh
# 等待几秒确保进程完全关闭
sudo ./startup.sh