在本页

  • 先决条件
  • 第 1 步 - 安装 Java
  • 第 2 步 - 创建系统用户
  • 第 3 步 - 下载 Tomcat
  • 第 4 步 - 创建 Systemd 单元文件
  • 第 5 步 - 启动并启用 Tomcat 服务
  • 第 6 步 - 配置防火墙
  • 第 7 步 - 配置 Tomcat Web 管理界面
  • 第 8 步 - 安装 SSL
  • 第 9 步 - 安装 Nginx
  • 第 10 步 - 运行 Tomcat
  • 结论

Tomcat 是一个用于基于 Java 的应用程序的开源 Web 服务器。它用于部署 Java Servlet 和 JSP 应用程序。Java servlet 是定义服务器如何处理请求和响应的小程序。Tomcat 充当 Java Servlet、JavaServer Pages、Java Expression Language 和 Java WebSocket 技术的开源实现。

Tomcat 有多个可用版本。我们将在本教程中讨论 Tomcat 10 的安装。如果你想安装 Tomcat 9,步骤是相同的。如果有任何变化,将在教程中说明。

在本教程中,我们将安装 Tomcat 10,并配合 Nginx 服务器作为反向代理,使用 SSL 对其进行保护。有一个 Tomcat 10.1.x 版本,它是 Tomcat 最新的 alpha 版本,但我们不会安装它。

先决条件

  • 一台运行 Rocky Linux 8.5 的服务器
  • 一个具有超级用户权限的非 sudo 用户。
  • 确保所有内容都是最新的。$ sudo dnf update
  • 安装所需的软件包。$ sudo dnf install wget tar

一台运行 Rocky Linux 8.5 的服务器

一个具有超级用户权限的非 sudo 用户。

确保所有内容都是最新的。

$ sudo dnf update

安装所需的软件包。

$ sudo dnf install wget tar

第 1 步 - 安装 Java

Tomcat 9 和 10 需要 Java 8 或更高版本。我们将安装 OpenJDK 11,它是 Java 平台的开源实现。

运行以下命令以安装 OpenJDK。

$ sudo dnf install java-11-openjdk-devel

验证安装。

$ java -version
openjdk version "11.0.13" 2021-10-19 LTS
OpenJDK Runtime Environment 18.9 (build 11.0.13+8-LTS)
OpenJDK 64-Bit Server VM 18.9 (build 11.0.13+8-LTS, mixed mode, sharing)

第 2 步 - 创建系统用户

我们将创建一个新系统用户,以最大限度降低以 root 用户运行 Tomcat 带来的安全风险。对于新用户,我们将 /opt/tomcat 设置为主目录。

运行以下命令为 Tomcat 创建一个新的系统用户。

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

第 3 步 - 下载 Tomcat

Tomcat v10 的最新版本可以从其下载页面下载。在撰写本教程时,v10.0.14 是最新版本。在下载 Tomcat 之前请检查最新版本。

使用 wget 下载 Tomcat。

$ VERSION=10.0.14
$ wget https://dlcdn.apache.org/tomcat/tomcat-10/v${VERSION}/bin/apache-tomcat-${VERSION}.tar.gz

将文件解压到 /opt/tomcat 目录。

$ sudo tar -xf apache-tomcat-${VERSION}.tar.gz -C /opt/tomcat/

创建一个指向 Tomcat 最新版本(即 Tomcat 安装目录)的符号链接。

$ sudo ln -s /opt/tomcat/apache-tomcat-${VERSION} /opt/tomcat/latest

将目录的所有权更改为此前创建的用户。

$ sudo chown -R tomcat:tomcat /opt/tomcat

第 4 步 - 创建 Systemd 单元文件

下一步是为 Tomcat 服务器创建一个服务文件,以便它可以自动启动。

创建并打开文件 /etc/systemd/system/tomcat.service 进行编辑。

$ sudo nano /etc/systemd/system/tomcat.service

粘贴以下代码。

[Unit]
Description=Apache Tomcat 10 Servlet container
Wants=network.target
After=network.target

[Service]
Type=forking

User=tomcat
Group=tomcat

Environment="JAVA_HOME=/usr/lib/jvm/jre"
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
Restart=always

[Install]
WantedBy=multi-user.target

按 Ctrl + X 保存文件,并在提示时输入 Y 进行保存。

第 5 步 - 启动并启用 Tomcat 服务

重新加载服务守护进程以启用 Tomcat 服务。

$ sudo systemctl daemon-reload

启用并启动 Tomcat 服务。

$ sudo systemctl enable tomcat --now

检查服务状态。

$ sudo systemctl status tomcat
? tomcat.service - Apache Tomcat 10 Servlet container
   Loaded: loaded (/etc/systemd/system/tomcat.service; enabled; vendor preset: disabled)
   Active: active (running) since Fri 2021-12-17 15:54:28 UTC; 24s ago
  Process: 86219 ExecStart=/opt/tomcat/latest/bin/startup.sh (code=exited, status=0/SUCCESS)
 Main PID: 86226 (java)
    Tasks: 19 (limit: 11411)
   Memory: 132.7M
   CGroup: /system.slice/tomcat.service
           ??86226 /usr/lib/jvm/jre/bin/java -Djava.util.logging.config.file=/opt/tomcat/latest/conf/logging.properties>

Dec 17 15:54:27 example systemd[1]: Starting Apache Tomcat 10 Servlet container...
Dec 17 15:54:28 example systemd[1]: Started Apache Tomcat 10 Servlet container.

第 6 步 - 配置防火墙

Rocky Linux 使用 Firewalld 防火墙。检查防火墙的状态。

$ sudo firewall-cmd --state
running

允许 HTTP 和 HTTPS 端口。

$ sudo firewall-cmd --permanent --add-service=http
$ sudo firewall-cmd --permanent --add-service=https

重新加载防火墙以使更改生效。

$ sudo firewall-cmd --reload

第 7 步 - 配置 Tomcat Web 管理界面

只有当我们为其创建用户凭据后,才能访问 Web 管理界面。

Tomcat 用户和角色在 /opt/tomcat/latest/conf/tomcat-users.xml 文件中定义。打开该文件进行编辑。

$ sudo nano /opt/tomcat/latest/conf/tomcat-users.xml

在

为 Manager 和 Administrator Tomcat 门户选择不同的凭据。

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

按 Ctrl + X 保存文件,并在提示时输入 Y 进行保存。

默认情况下,Tomcat 界面只能从 localhost 访问。如果你需要从任何地方访问它,需要对其进行配置。

打开 /opt/tomcat/latest/webapps/manager/META-INF/context.xml 进行编辑。

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

删除以下各行,或如下所示用 将其括起来以注释掉。

<!--
  <Valve className="org.apache.catalina.valves.RemoteAddrValve"
         allow="127\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1" />
-->

允许从任何 IP 地址访问都存在安全风险。你可以通过仅允许从你的公网 IP 地址访问来加以限制。如果你的公网 IP 地址是 22.22.22.22,则按如下方式更改该行。

 <Valve className="org.apache.catalina.valves.RemoteAddrValve"
         allow="127\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1|22.22.22.22" />

允许的 IP 地址列表用竖线 ( | ) 分隔。你可以添加单个 IP 地址,也可以使用正则表达式。

按 Ctrl + X 保存文件,并在提示时输入 Y 进行保存。

对文件 /opt/tomcat/latest/webapps/host-manager/META-INF/context.xml 也执行相同的更改。

完成后,重启 Tomcat 服务器。

$ sudo systemctl restart tomcat

第 8 步 - 安装 SSL

要使用 Let's Encrypt 安装 SSL 证书,我们需要安装 Certbot 工具。

首先,你需要下载并安装 EPEL 存储库。

$ sudo dnf install epel-release

运行以下命令以安装 Certbot。

$ sudo dnf install certbot

生成 SSL 证书。

$ sudo certbot certonly --standalone --agree-tos --no-eff-email --staple-ocsp --preferred-challenges http -m 
[email protected]
 -d tomcat.example.com

上述命令会将证书下载到服务器上 /etc/letsencrypt/live/tomcat.example.com 目录。

生成 Diffie-Hellman 组证书。

$ sudo openssl dhparam -out /etc/ssl/certs/dhparam.pem 2048

为 Let's Encrypt 自动续期创建一个 challenge webroot 目录。

$ sudo mkdir -p /var/lib/letsencrypt

创建一个 Cron Job 来续期 SSL。它将每天运行以检查证书并在需要时续期。为此,首先创建文件 /etc/cron.daily/certbot-renew 并打开它进行编辑。

$ sudo nano /etc/cron.daily/certbot-renew

粘贴以下代码。

#!/bin/sh
certbot renew --cert-name tomcat.example.com --webroot -w /var/lib/letsencrypt/ --post-hook "systemctl reload nginx"

按 Ctrl + X 保存文件,并在提示时输入 Y。

更改任务文件的权限以使其可执行。

$ sudo chmod +x /etc/cron.daily/certbot-renew

第 9 步 - 安装 Nginx

Rocky Linux 8.5 附带最新稳定版本的 Nginx。使用以下命令安装它。

$ sudo dnf module install nginx:1.20

验证安装。

$ nginx -v
nginx version: nginx/1.20.1

启用并启动 Nginx 服务。

$ sudo systemctl enable nginx --now

创建并打开文件 /etc/nginx/conf.d/tomcat.conf 进行编辑。

$ sudo nano /etc/nginx/conf.d/tomcat.conf

在其中粘贴以下代码。

server {
    listen       443 ssl http2;
    listen       [::]:443 ssl http2;
    server_name  tomcat.example.com;

    access_log  /var/log/nginx/tomcat.access.log;
    error_log   /var/log/nginx/tomcat.error.log;
    
    # SSL
    ssl_certificate      /etc/letsencrypt/live/tomcat.example.com/fullchain.pem;
    ssl_certificate_key  /etc/letsencrypt/live/tomcat.example.com/privkey.pem;
    ssl_trusted_certificate /etc/letsencrypt/live/tomcat.example.com/chain.pem;
    ssl_session_timeout  5m;
    ssl_session_cache shared:MozSSL:10m;
    ssl_session_tickets off;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_prefer_server_ciphers on;
    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384;
    ssl_ecdh_curve X25519:prime256v1:secp384r1:secp521r1;
    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_dhparam /etc/ssl/certs/dhparam.pem;
    resolver 8.8.8.8;

    location / {
      proxy_pass http://127.0.0.1:8080;
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header X-Forwarded-Host $host;
      proxy_set_header X-Forwarded-Server $host;
      proxy_set_header Host $host;
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  }
}
# enforce HTTPS
server {
    listen       80;
    listen       [::]:80;
    server_name  tomcat.example.com;
    return 301   https://$host$request_uri;
}

完成后按 Ctrl + X 保存文件,并在提示时输入 Y。

打开文件 /etc/nginx/nginx.conf 进行编辑。

$ sudo nano /etc/nginx/nginx.conf

在 include /etc/nginx/conf.d/*.conf; 这一行之前添加以下行。

server_names_hash_bucket_size  64;

按 Ctrl + X 保存文件,并在提示时输入 Y。

验证 Nginx 配置文件的语法。

$ sudo nginx -t
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

重启 Nginx 服务以启用新配置。

$ sudo systemctl restart nginx

第 10 步 - 运行 Tomcat

在浏览器中打开 https://tomcat.example.com,它将打开以下界面。

如何在 Rocky Linux 8 服务器上使用 Nginx 安装并配置 Apache Tomcat 10

现在你可以使用我们在第 7 步中配置的登录凭据访问 Server Status、Manager App 和 Host Manager 页面。

结论

至此,我们关于在基于 Rocky Linux 8.5 的服务器上安装和配置 Tomcat Server、通过 Nginx 反向代理提供访问并使用 SSL 对其进行保护的教程就结束了。如果你有任何问题,请在下面的评论中发布。