CentOS 下搭建 Tomcat 9 环境指南

准备工作

1. 确保你有一台运行 CentOS 的服务器（本文以 CentOS 7/8 为例）
2. 确保你有 root 或 sudo 权限
3. 确保服务器已连接互联网

步骤 1：安装 Java 环境

Tomcat 9 需要 Java 8 或更高版本，推荐安装 OpenJDK：

# 更新系统包
sudo yum update -y

# 安装 OpenJDK 11
sudo yum install -y java-11-openjdk-devel

# 验证安装
java -version

步骤 2：下载 Tomcat 9

# 创建安装目录
sudo mkdir -p /opt/tomcat
cd /opt/tomcat

# 下载 Tomcat 9（请访问 https://tomcat.apache.org/download-90.cgi 获取最新版本链接）
sudo wget https://downloads.apache.org/tomcat/tomcat-9/v9.0.85/bin/apache-tomcat-9.0.85.tar.gz

# 解压
sudo tar xzvf apache-tomcat-9.0.85.tar.gz --strip-components=1

# 删除下载的压缩包
sudo rm apache-tomcat-9.0.85.tar.gz

步骤 3：创建 Tomcat 用户

# 创建系统用户和组
sudo groupadd tomcat
sudo useradd -s /bin/false -g tomcat -d /opt/tomcat tomcat

# 设置目录权限
sudo chown -R tomcat:tomcat /opt/tomcat
sudo chmod -R u+x /opt/tomcat/bin

步骤 4：配置环境变量

# 编辑 /etc/profile 文件
sudo vi /etc/profile

# 在文件末尾添加以下内容
export CATALINA_HOME=/opt/tomcat
export PATH=$PATH:$CATALINA_HOME/bin

# 使配置生效
source /etc/profile

步骤 5：创建 systemd 服务

# 创建服务文件
sudo vi /etc/systemd/system/tomcat.service

# 添加以下内容
[Unit]
Description=Apache Tomcat 9
After=syslog.target network.target

[Service]
Type=forking
User=tomcat
Group=tomcat
Environment=CATALINA_PID=/opt/tomcat/temp/tomcat.pid
Environment=CATALINA_HOME=/opt/tomcat
Environment=CATALINA_BASE=/opt/tomcat
ExecStart=/opt/tomcat/bin/startup.sh
ExecStop=/opt/tomcat/bin/shutdown.sh
Restart=on-failure

[Install]
WantedBy=multi-user.target

步骤 6：启动 Tomcat 服务

# 重新加载 systemd
sudo systemctl daemon-reload

# 启动 Tomcat
sudo systemctl start tomcat

# 设置开机启动
sudo systemctl enable tomcat

# 检查状态
sudo systemctl status tomcat

步骤 7：配置防火墙

# 开放 8080 端口（Tomcat 默认端口）
sudo firewall-cmd --zone=public --add-port=8080/tcp --permanent
sudo firewall-cmd --reload

步骤 8：验证安装

在浏览器中访问：

http://your_server_ip:8080

你应该能看到 Tomcat 9 的默认欢迎页面。

可选配置

1. 修改默认端口

编辑 /opt/tomcat/conf/server.xml，找到以下内容并修改端口号：

<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443" />

2. 配置管理界面

# 编辑 tomcat-users.xml
sudo vi /opt/tomcat/conf/tomcat-users.xml

# 在 </tomcat-users> 前添加
<role rolename="manager-gui"/>
<role rolename="admin-gui"/>
<user username="admin" password="your_password" roles="manager-gui,admin-gui"/>

3. 配置内存参数

编辑 /opt/tomcat/bin/setenv.sh（如果不存在则创建）：

export CATALINA_OPTS="-Xms512m -Xmx1024m -XX:MaxPermSize=256m"

常见问题解决

1. 无法访问 Tomcat 页面

   • 检查防火墙设置
   • 检查 Tomcat 是否正在运行：sudo systemctl status tomcat
   • 查看日志：tail -f /opt/tomcat/logs/catalina.out

2. 内存不足

   • 调整 setenv.sh 中的内存参数
   • 增加服务器内存

3. 权限问题

   • 确保 /opt/tomcat 目录及其子目录属于 tomcat 用户
   • 检查 SELinux 状态：sudo setenforce 0（临时禁用）

现在你已经成功在 CentOS 上安装了 Tomcat 9 环境！