本篇教程介绍如何在Alibaba Cloud Linux 3系统的ECS实例上部署Java web项目,适用于刚开始使用阿里云进行建站的个人用户。
前提条件
- 已创建操作系统为Alibaba Cloud Linux 3的云服务器ECS。具体操作,请参见创建方式导航。
- 在安全组入方向添加规则放行所需端口。本示例中,需要放行SSH协议的22端口、HTTP协议的80端口、HTTPS协议的443端口和Tomcat默认使用的8080端口。具体操作,请参见添加安全组规则。
背景信息
说明 手动部署Java Web环境可能需要较长时间,如果您对Linux命令不熟悉,建议您通过云市场镜像部署Java Web环境。镜像部署Java Web服务器即装即用,省去安装配置服务器的过程。具体操作,请参见
云市场镜像部署Java Web环境。
本文在示例步骤中使用了以下实例规格和软件版本。操作时,请您以实际软件版本为准。
- 实例规格:ecs.c6.large
- 操作系统:Alibaba Cloud Linux 3.2104 LTS 64位
- JDK版本:JDK 1.8.0_352
- Tomcat版本:8.5.83
步骤一:准备工作
- 远程连接Linux实例。
- 关闭防火墙。
- 运行以下命令,查看当前防火墙的状态。
systemctl status firewalld

- 如果防火墙的状态参数是inactive,则防火墙为关闭状态。
- 如果防火墙的状态参数是active,则防火墙为开启状态。本示例中防火墙为开启状态,因此需要关闭防火墙。具体操作如下:
- 关闭SELinux。
- 运行以下命令,查看SELinux的当前状态。
getenforce
- 如果SELinux状态参数是Disabled, 则SELinux为关闭状态。
- 如果SELinux状态参数是Enforcing,则SELinux为开启状态。
- 关闭SELinux。如果SELinux为关闭状态,请忽略此步骤。
- 如果您想临时关闭SELinux,运行命令
setenforce 0
。
说明 这只是暂时关闭SELinux,下次重启Linux后,SELinux还会开启。
- 如果您想永久关闭SELinux,运行命令vi /etc/selinux/config编辑SELinux配置文件。回车后,把光标移动到
SELINUX=enforcing
这一行,按i键,将其修改为SELINUX=disabled
, 按Esc键,然后输入:wq并回车以保存并关闭SELinux配置文件。 最后重启系统使设置生效。
步骤二:安装JDK
JDK为Java开发工具包,本文以JDK 1.8.0_351为例。
- 运行以下命令,通过yum命令查找JDK软件包。
- 运行以下命令,安装JDK软件包。
本示例以安装JDK 1.8.0为例。
yum -y install java-1.8.0-openjdk-devel.x86_64
- 运行以下命令,查看JDK版本。
本示例中版本信息如下所示。
[root@iZbp14h7n3cwipjln62**** ~]# java -version
openjdk version "1.8.0_352"
OpenJDK Runtime Environment (build 1.8.0_352-b08)
OpenJDK 64-Bit Server VM (build 25.352-b08, mixed mode)
- 运行以下命令,查看JDK安装后的路径。
find /usr/lib/jvm -name 'java-1.8.0-openjdk-1.8.0*'
返回信息类似如下所示。
[root@iZbp14h7n3cwipjln62kxvZ ~]# find /usr/lib/jvm -name 'java-1.8.0-openjdk-1.8.0*'
/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.352.b08-2.al8.x86_64
- 配置Java环境变量。
- 打开配置文件。
- 在配置文件末尾,按i进入编辑模式。
- 添加以下信息。
JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.352.b08-2.al8.x86_64
PATH=$PATH:$JAVA_HOME/bin
CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
export JAVA_HOME CLASSPATH PATH
其中:
JAVA_HOME
需要改为JDK安装的路径。JDK安装的路径,具体请参见
查看JDK安装后的路径。
- 按Esc键,输入
:wq
并回车以保存并关闭文件。
- 运行以下命令,立即生效环境变量。
步骤三:安装Apache Tomcat
Apache Tomcat为Web应用服务器,本文以安装Apache Tomcat 8.5.83为例。
- 下载并解压omcat安装包。
- 运行以下命令,下载Tomcat安装包。
本示例以下载Tomcat 8.5.83为例。
wget --no-check-certificate https://dlcdn.apache.org/tomcat/tomcat-8/v8.5.83/bin/apache-tomcat-8.5.83.tar.gz
说明 由于Tomcat的版本会持续更新,如果上述下载地址失效,请您直接访问
Tomcat官网获取最新下载地址。
- 运行以下命令,解压Tomcat安装包。
tar -zxvf apache-tomcat-8.5.83.tar.gz
- 运行以下命令,移动Tomcat所在目录。
mv apache-tomcat-8.5.83 /usr/local/tomcat/
- 为保证系统安全性,建议创建一般用户来运行Tomcat。
例如,本示例中创建一般用户www。
useradd www
- 运行以下命令,将文件的所属用户设置为www。
chown -R www.www /usr/local/tomcat/
在/usr/local/tomcat/目录下:
- bin:存放Tomcat的一些脚本文件,包含启动和关闭Tomcat服务脚本。
- conf:存放Tomcat服务器的各种全局配置文件,其中最重要的是server.xml和web.xml。
- webapps:Tomcat的主要Web发布目录,默认情况下把Web应用文件放于此目录。
- logs:存放Tomcat执行时的日志文件。
- 配置server.xml文件。
- 运行以下命令,切换到/usr/local/tomcat/conf/目录。
cd /usr/local/tomcat/conf/
- 运行以下命令,重命名server.xml文件。
mv server.xml server.xml_bk
- 新建一个server.xml文件。
- 运行以下命令,创建并打开server.xml文件。
vim server.xml
- 按i键,添加以下内容。
<?xml version="1.0" encoding="UTF-8"?>
<Server port="8006" shutdown="SHUTDOWN">
<Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener"/>
<Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener"/>
<Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener"/>
<Listener className="org.apache.catalina.core.AprLifecycleListener"/>
<GlobalNamingResources>
<Resource name="UserDatabase" auth="Container"
type="org.apache.catalina.UserDatabase"
description="User database that can be updated and saved"
factory="org.apache.catalina.users.MemoryUserDatabaseFactory"
pathname="conf/tomcat-users.xml"/>
</GlobalNamingResources>
<Service name="Catalina">
<Connector port="8080"
protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443"
maxThreads="1000"
minSpareThreads="20"
acceptCount="1000"
maxHttpHeaderSize="65536"
debug="0"
disableUploadTimeout="true"
useBodyEncodingForURI="true"
enableLookups="false"
URIEncoding="UTF-8"/>
<Engine name="Catalina" defaultHost="localhost">
<Realm className="org.apache.catalina.realm.LockOutRealm">
<Realm className="org.apache.catalina.realm.UserDatabaseRealm"
resourceName="UserDatabase"/>
</Realm>
<Host name="localhost" appBase="/data/wwwroot/default" unpackWARs="true" autoDeploy="true">
<Context path="" docBase="/data/wwwroot/default" debug="0" reloadable="false" crossContext="true"/>
<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
prefix="localhost_access_log." suffix=".txt" pattern="%h %l %u %t "%r" %s %b" />
</Host>
</Engine>
</Service>
</Server>
- 按Esc键,输入
:wq
并回车以保存并关闭文件。
- 设置JVM内存参数。
- 运行以下命令,创建并打开/usr/local/tomcat/bin/setenv.sh文件。
vim /usr/local/tomcat/bin/setenv.sh
- 按i键,添加以下内容。
指定
JAVA_OPTS
参数,用于设置JVM的内存信息以及编码格式。本示例将编码格式设置为UTF-8。
JAVA_OPTS='-Djava.security.egd=file:/dev/./urandom -server -Xms256m -Xmx496m -Dfile.encoding=UTF-8'
- 按Esc键,输入
:wq
并回车以保存并关闭文件。
- 设置Tomcat自启动脚本。
- 运行以下命令,下载Tomcat自启动脚本文件。
说明 该脚本来源于社区,仅供参考。阿里云对其可靠性以及操作可能带来的潜在影响,不做任何暗示或其他形式的承诺。如果您运行wget命令下载失败,您可以通过浏览器访问https://raw.githubusercontent.com/oneinstack/oneinstack/master/init.d/Tomcat-init
直接获取脚本内容。
wget https://raw.githubusercontent.com/oneinstack/oneinstack/master/init.d/Tomcat-init
- 运行以下命令,移动并重命名Tomcat-init。
mv Tomcat-init /etc/init.d/tomcat
- 运行以下命令,为/etc/init.d/tomcat添加可执行权限。
chmod +x /etc/init.d/tomcat
- 运行以下命令,设置启动脚本JAVA_HOME。
重要 脚本中JDK的路径信息必须与您安装的JDK路径保持一致,否则Tomcat会启动失败。JDK的安装路径,具体请参见
查看JDK的安装路径。
sed -i 's@^export JAVA_HOME=.*@export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.352.b08-2.al8.x86_64@' /etc/init.d/tomcat
- 依次运行以下命令,设置Tomcat开机自动启动。
chkconfig --add tomcat
chkconfig tomcat on
- 运行以下命令,启动Tomcat。
service tomcat start
回显信息类似如下所示,表示启动Tomcat成功。
[root@iZbp14h7n3cwipjln62**** conf]# service tomcat start
Starting tomcat
Using CATALINA_BASE: /usr/local/tomcat
Using CATALINA_HOME: /usr/local/tomcat
Using CATALINA_TMPDIR: /usr/local/tomcat/temp
Using JRE_HOME: /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.352.b08-2.al8.x86_64
Using CLASSPATH: /usr/local/tomcat/bin/bootstrap.jar:/usr/local/tomcat/bin/tomcat-juli.jar
Using CATALINA_OPTS:
Tomcat started.
Tomcat is running with pid: 6849
步骤四:部署测试项目并验证
将需要部署的Java Web项目文件WAR包上传到网站根目录下,并将网站根目录下文件所属用户改为www。您可以使用支持文件传输功能的远程连接工具或搭建FTP站点上传项目文件。搭建FTP站点的具体操作,请参见搭建FTP站点(Alibaba Cloud Linux 3)。本示例中,网站根目录为/data/wwwroot/default,运行以下命令直接在网站根目录下新建一个Tomcat测试页面,并进行访问。
- 运行以下命令,创建网站根目录。
mkdir -p /data/wwwroot/default
- 运行以下命令,将网站根目录的所属用户设置为www。
chown -R www.www /data/wwwroot
- 运行以下命令,新建测试文件。
echo Tomcat test > /data/wwwroot/default/index.jsp
- 在本地浏览器地址栏中,输入以下地址,查看环境配置是否成功。
返回页面如下图所示,则表示环境配置成功。

常见问题
如果Java Web环境无法访问,您可以参考以下思路排查问题:
- ECS实例中的安全组中是否放行Tomcat默认使用的8080端口。具体操作,请参见添加安全组规则。
- Java安装路径配置是否正确。您可以执行命令find /usr/lib/jvm -name 'java-1.8.0-openjdk-1.8.0*'查看Java安装路径。涉及Java安装路径的配置主要涉及2处,具体请参见设置Java环境变量和设置启动脚本JAVA_HOME。