如何在 Ubuntu 18.04 上安装 Tomcat 8.5

Apache Tomcat 是 Java Servlet , JavaServer Pages , Java Expression Language 和 Java WebSocket 等技术的开源实现。它是当今世界上应用最广泛的应用程序和 Web 服务器之一。 Tomcat 易于使用,并且具有强大的附加组件生态。

本教程演示了如何在 Ubuntu 18.04 上安装 Tomcat 8.5 。本教程同样适用于 Ubuntu 16.04 和任何基于 Ubuntu 的发行版,包括 Linux Mint 和 Elementary OS 。

先决条件

在继续本教程之前,请确保以具有 sudo 权限的用户身份登录。

安装 OpenJDK

OpenJDK 是 Java 平台的开源实现,是 Ubuntu 18.04 中的默认 Java 开发和运行时。

安装 OpenJDK 软件包非常简单:

sudo apt install default-jdk

如果要安装 Oracle Java 而不是 OpenJDK ,请查看此说明

创建 Tomcat 用户

我们将创建一个新的系统用户和组来运行 Tomcat 服务,该用户的的主目录是 /opt/tomcat

sudo useradd -m -U -d /opt/tomcat -s /bin/false tomcat

下载 Tomcat

我们将使用 wgetunzip 下载并解压缩 Tomcat 安装文档。如果您的系统上没有安装 unzipwget,请运行以下命令安装软件包:

sudo apt install unzip wget

Tomcat 下载页面下载最新版本的 Tomcat 8.5.x 。在撰写本文时,最新版本为 8.5.37 。在继续下一步之前,您应该从下载页面检查是否有新版本。

切换到 /tmp 目录并使用 wget 命令下载 Tomcat zip 文件:

cd /tmp
wget http://www-us.apache.org/dist/tomcat/tomcat-8/v8.5.37/bin/apache-tomcat-8.5.37.zip

下载完成后,解压缩文件并将其移动到 /opt/tomcat 目录:

unzip apache-tomcat-*.zip
sudo mkdir -p /opt/tomcat
sudo mv apache-tomcat-8.5.37 /opt/tomcat/

为了更好地控制版本和更新,我们将创建一个符号链接 latest 指向 Tomcat 安装目录:

sudo ln -s /opt/tomcat/apache-tomcat-8.5.37 /opt/tomcat/latest

如果以后要升级 Tomcat 安装,只需解压缩较新版本并更改符号链接以指向最新版本。

我们之前设置的 tomcat 用户需要访问 tomcat 目录,因此我们将更改目录所有者为用户和组 tomcat

sudo chown -R tomcat: /opt/tomcat

赋予 bin 目录中的脚本可执行权限:

sudo sh -c 'chmod +x /opt/tomcat/latest/bin/*.sh'

创建 systemd 单元文件

要将 Tomcat 作为服务运行,我们要在 /etc/systemd/system/ 目录中创建一个包含以下内容的新单元文件 tomcat.service

/etc/systemd/system/tomcat.service

[Unit]
Description=Tomcat 8.5 servlet container
After=network.target

[Service]
Type=forking

User=tomcat
Group=tomcat

Environment="JAVA_HOME=/usr/lib/jvm/default-java"
Environment="JAVA_OPTS=-Djava.security.egd=file:///dev/urandom"

Environment="CATALINA_BASE=/opt/tomcat/latest"
Environment="CATALINA_HOME=/opt/tomcat/latest"
Environment="CATALINA_PID=/opt/tomcat/latest/temp/tomcat.pid"
Environment="CATALINA_OPTS=-Xms512M -Xmx1024M -server -XX:+UseParallelGC"

ExecStart=/opt/tomcat/latest/bin/startup.sh
ExecStop=/opt/tomcat/latest/bin/shutdown.sh

[Install]
WantedBy=multi-user.target

通过执行以下命令通知 systemd 我们创建了一个新的单元文件并启动 Tomcat 服务:

sudo systemctl daemon-reload
sudo systemctl start tomcat

您可以使用以下命令检查服务状态:

sudo systemctl status tomcat
● tomcat.service - Tomcat 8.5 servlet container
Loaded: loaded (/etc/systemd/system/tomcat.service; disabled; vendor preset: enabled)
Active: active (running) since Sat 2018-05-05 11:04:40 UTC; 5s ago
Process: 13478 ExecStart=/opt/tomcat/latest/bin/startup.sh (code=exited, status=0/SUCCESS)
Main PID: 13499 (java)
Tasks: 45 (limit: 507)
CGroup: /system.slice/tomcat.service
└─13499 /usr/lib/jvm/default-java/bin/java -Djava.util.logging.config.file=/opt/tomcat/latest/conf/logging.properties -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager -Djava.security.

如果没有错误,您可以启用 Tomcat 服务在引导时自动启动:

sudo systemctl enable tomcat

调整防火墙

如果您的服务器受防火墙保护,并且您希望从本地网络外部访问 tomcat 接口,则需要打开端口 8080

要允许端口上 8080 的流量,请键入以下命令:

sudo ufw allow 8080/tcp

在生产环境中运行 Tomcat 应用程序时,您很可能将拥有负载平衡器或反向代理,最佳做法是仅将端口 8080 的访问限制到内部网络。

配置 Tomcat Web 管理界面

现在我们已经在 Ubuntu 服务器上安装了 Tomcat ,下一步是创建一个可以访问 Web 管理界面的用户。

Tomcat 用户及其角色在 tomcat-users.xml 文件中定义。

如果您打开该文件,您会注意到文件中充满了描述如何配置文件的注释和示例。

sudo vim /opt/tomcat/latest/conf/tomcat-users.xml

要添加可以访问 tomcat web 界面 (manager-gui 和 admin-gui) 的新用户,我们需要在 tomcat-users.xml 文件中定义用户,如下所示。请务必将用户名和密码更改为更安全的内容:

/opt/tomcat/latest/conf/tomcat-users.xml

<tomcat-users>
<!--
Comments
-->
<role rolename="admin-gui"/>
<role rolename="manager-gui"/>
<user username="admin" password="admin_password" roles="admin-gui,manager-gui"/>
</tomcat-users>

默认情况下, Tomcat Web 管理界面配置为仅允许从本地主机访问,如果您希望能够从远程 IP 或任何不推荐的地方访问 Web 界面,您可以打开以下文件并进行以下更改。一般不建议这么做,因为存在安全风险。

如果您需要从任何地方访问 Web 界面,请打开以下文件并注释或删除以黄色突出显示的行:

/opt/tomcat/latest/webapps/manager/META-INF/context.xml

<Context antiResourceLocking="false" privileged="true" >
<!--
<Valve className="org.apache.catalina.valves.RemoteAddrValve"
allow="127\.\d+\.\d+\.\d+|::1|0000:1" />
-->
</Context>

/opt/tomcat/latest/webapps/host-manager/META-INF/context.xml

<Context antiResourceLocking="false" privileged="true" >
<!--
<Valve className="org.apache.catalina.valves.RemoteAddrValve"
allow="127\.\d+\.\d+\.\d+|::1|0000:1" />
-->
</Context>

如果您只需要从特定 IP 访问 Web 界面,请不要注释掉上面的内容,将的公共 IP 添加到列表中。假设您的公共 IP 是: 32.32.32.32 并且您希望仅允许来自该 IP 的访问:

/opt/tomcat/latest/webapps/manager/META-INF/context.xml

<Context antiResourceLocking="false" privileged="true" >
<Valve className="org.apache.catalina.valves.RemoteAddrValve"
allow="127\.\d+\.\d+\.\d+|::1|0000:1|32.32.32.32" />
</Context>

/opt/tomcat/latest/webapps/host-manager/META-INF/context.xml

<Context antiResourceLocking="false" privileged="true" >
<Valve className="org.apache.catalina.valves.RemoteAddrValve"
allow="127\.\d+\.\d+\.\d+|::1|0000:1|32.32.32.32" />
</Context>

允许的 IP 地址列表是用竖线分隔的列表|。您可以添加单个 IP 地址或使用正则表达式。

重新启动 Tomcat 服务以使更改生效:

sudo systemctl restart tomcat

测试安装

打开浏览器并输入: http://<your_domain_or_IP_address>:8080,如果安装成功,将出现类似于以下内容的屏幕:

通过这个地址 http://<your_domain_or_IP_address>:8080/manager/html 可以访问 Tomcat Web 应用程序管理界面 。您在这里可以部署,取消部署,启动,停止和重新加载您的应用程序。

通过这个地址 http://<your_domain_or_IP_address>:8080/host-manager/html 可以访问 Tomcat 虚拟主机管理界面 。您在这里可以创建,删除和管理 Tomcat 虚拟主机。

结论

您已在 Ubuntu 18.04 系统上成功安装了 Tomcat 8.5 。您如果想了解有关 Apache Tomcat 功能的更多信息,可以访问 Apache Tomcat 8 官方文档