Linux服务器首次部署Tomcat,如何配置运行环境并验证应用可访问?
首次在Linux服务器上运行Tomcat,关键是先确定JDK与Tomcat版本匹配,再让Tomcat以独立系统用户运行,最后通过本机和远程请求分别验证服务、端口及应用是否可访问。仅能看到Java进程并不代表应用已经部署成功,还需要检查监听地址、WAR包上下文路径、应用日志和服务器防火墙。
下面以使用systemd的Debian/Ubuntu服务器为例,采用JDK 17、Tomcat 10.1和8080端口。命令以首次部署为前提,适合尚未运行其他Tomcat实例的环境。Tomcat 10.1要求应用使用jakarta.<em>命名空间;如果现有应用仍基于javax.servlet.</em>,应优先评估Tomcat 9,而不是直接替换运行环境。
面向Java应用、Tomcat业务后台及接口服务,A5idc数据提供中国香港、美国、日本、韩国、中国台湾、新加坡和马来西亚等地区的物理服务器租用资源,覆盖Xeon与AMD EPYC平台,并提供SSD、NVMe、大内存及不同带宽线路配置,可为网站、数据库和多任务应用提供相应的计算、存储与网络基础。
准备条件
环境与版本确认
建议先确认操作系统、CPU架构、Java和systemd状态:
cat /etc/os-release
uname -m
command -v systemctl
java -version 2>&1 || true
本文示例使用以下组合:
| 项目 | 示例值 | 检查方式 | 说明 |
|---|---|---|---|
| 操作系统 | Ubuntu 22.04/24.04、Debian 12 | cat /etc/os-release | 使用apt安装依赖 |
| 服务管理 | systemd | command -v systemctl | 用于开机启动和状态检查 |
| Java | OpenJDK 17 | java -version | Tomcat 10.1可使用Java 11及以上版本 |
| Tomcat | 10.1.x | bin/version.sh | 应用需要兼容Jakarta Servlet |
| HTTP端口 | 8080 | ss -lntp | 仅作为示例,可按实际端口调整 |
需要准备一个具有sudo权限的账号,以及待部署的应用文件,例如/tmp/demo.war。如果服务器需要通过公网或办公网访问,还要确认云平台安全组、网络ACL和操作系统防火墙允许对应来源访问8080端口。
Tomcat安装包和应用包都属于服务器上的可执行或可运行内容。正式操作前,建议记录当前服务器状态;如果目标主机已经存在Java、Tomcat或8080端口占用,不要直接覆盖原文件。
sudo ss -lntp
sudo systemctl list-units --type=service | grep -i tomcat || true
df -h /
free -h
通常建议为Tomcat预留至少2GB内存用于基础运行和应用测试。-Xmx512m只是小型示例应用的起始值,不代表所有业务的通用配置。
逐步部署与验证
1. 安装并验证JDK
先安装JDK 17及下载、解压所需工具:
sudo apt update
sudo apt install -y openjdk-17-jdk ca-certificates curl tar
确认Java命令可用:
java -version
readlink -f "$(command -v java)"
预期能看到17.x版本,并且Java实际路径通常类似:
/usr/lib/jvm/java-17-openjdk-amd64/bin/java
如果java -version显示的不是17,或者命令不存在,先处理Java环境,不要继续创建Tomcat服务。systemd启动服务时不会读取所有交互式Shell配置,因此仅在~/.bashrc中配置JAVA_HOME并不足够。
可以用以下命令推导当前Java安装目录:
dirname "$(dirname "$(readlink -f "$(command -v java)")")"
记录该命令输出,后面写入systemd服务文件。如果输出路径与示例不同,应使用实际路径。
2. 下载Tomcat并校验安装包
为了让文件名完整,下面使用Tomcat 10.1.20作为命令示例。正式环境应根据应用兼容性选择仍适合维护的10.1.x版本,并同步替换版本变量。版本变化后,必须重新确认下载地址和校验文件名称。
cd /tmp
export TOMCAT_VERSION=10.1.20
export TOMCAT_FILE="apache-tomcat-${TOMCAT_VERSION}.tar.gz"
export TOMCAT_BASE_URL="https://archive.apache.org/dist/tomcat/tomcat-10/v${TOMCAT_VERSION}/bin"
curl -fLO "${TOMCAT_BASE_URL}/${TOMCAT_FILE}"
curl -fLO "${TOMCAT_BASE_URL}/${TOMCAT_FILE}.sha512"
sha512sum -c "${TOMCAT_FILE}.sha512"
校验成功时,结果中应出现:
apache-tomcat-10.1.20.tar.gz: OK
如果出现FAILED、文件不存在或下载中断,不要解压和启动。先检查版本号、下载地址及文件是否完整。
创建专用系统用户,并把Tomcat解压到/opt:
if ! id tomcat >/dev/null 2>&1; then
sudo useradd --system --home-dir /opt/tomcat \
--shell /usr/sbin/nologin tomcat
fi
sudo tar -xzf "/tmp/${TOMCAT_FILE}" -C /opt
sudo ln -sfn "/opt/apache-tomcat-${TOMCAT_VERSION}" /opt/tomcat
sudo chown -R tomcat:tomcat "/opt/apache-tomcat-${TOMCAT_VERSION}"
sudo chmod +x /opt/tomcat/bin/*.sh
验证目录和版本:
sudo -u tomcat /opt/tomcat/bin/version.sh
sudo ls -ld /opt/tomcat /opt/tomcat/{bin,conf,logs,webapps}
version.sh应显示Tomcat版本和Java版本。若脚本提示没有执行权限,检查前面的chmod命令;若提示无法找到Java,检查JAVA_HOME对应的JDK目录。
3. 创建systemd运行服务
先确认Java目录:
dirname "$(dirname "$(readlink -f "$(command -v java)")")"
以下服务文件使用Ubuntu/Debian常见的JDK 17路径。如果上一步输出不同,请替换JAVA_HOME的值:
sudo tee /etc/systemd/system/tomcat.service >/dev/null <<'EOF'
[Unit]
Description=Apache Tomcat
After=network.target
[Service]
Type=simple
User=tomcat
Group=tomcat
Environment="JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64"
Environment="CATALINA_HOME=/opt/tomcat"
Environment="CATALINA_BASE=/opt/tomcat"
Environment="CATALINA_OPTS=-Xms256m -Xmx512m -Dfile.encoding=UTF-8"
WorkingDirectory=/opt/tomcat
ExecStart=/opt/tomcat/bin/catalina.sh run
ExecStop=/bin/kill -TERM $MAINPID
Restart=on-failure
RestartSec=5
SuccessExitStatus=143
LimitNOFILE=65535
TimeoutStopSec=30
[Install]
WantedBy=multi-user.target
EOF
-Xms256m -Xmx512m适合用于基础验证。若服务器只有1GB内存,不建议盲目增加堆内存;若应用启动后频繁出现内存不足,应结合应用规模和系统剩余内存调整。
重新加载服务定义并启动:
sudo systemctl daemon-reload
sudo systemctl enable --now tomcat
立即检查服务状态:
sudo systemctl is-enabled tomcat
sudo systemctl is-active tomcat
sudo systemctl status tomcat --no-pager
预期结果分别为enabled和active。如果服务处于failed,先查看日志,不要反复重启:
sudo journalctl -u tomcat -n 100 --no-pager
确认Java进程正在监听8080:
sudo ss -lntp | grep ':8080'
正常情况下可以看到类似以下监听信息:
LISTEN 0 100 0.0.0.0:8080 0.0.0.0:* users:(("java",pid=...,fd=...))
4. 先从服务器本机验证Tomcat
Tomcat服务启动后,先不排查公网网络,直接从服务器本机请求:
curl -I --max-time 10 http://127.0.0.1:8080/
全新安装的Tomcat通常会返回200或3xx。如果默认应用已被移除,也可能返回404,这只能说明根路径没有应用,不一定表示Tomcat没有启动。此时以ss、systemd状态和日志为准。
进一步查看响应内容:
curl -sS --max-time 10 http://127.0.0.1:8080/ | head -n 20
如果本机请求超时或连接被拒绝,优先检查:
sudo systemctl status tomcat --no-pager
sudo ss -lntp | grep ':8080' || true
sudo journalctl -u tomcat -n 100 --no-pager
5. 部署WAR应用
将应用包复制到Tomcat的webapps目录。以下假设应用文件为/tmp/demo.war,实际文件名应替换为待部署的WAR包:
test -f /tmp/demo.war
sha256sum /tmp/demo.war
sudo install -o tomcat -g tomcat -m 0640 \
/tmp/demo.war /opt/tomcat/webapps/demo.war
WAR文件名会影响访问路径:

demo.war通常对应http://服务器地址:8080/demo/ROOT.war通常对应根路径http://服务器地址:8080/orders-1.0.war通常对应http://服务器地址:8080/orders-1.0/
如果应用包来自构建流水线,建议在复制前记录SHA-256值,便于确认服务器上的文件与交付文件一致。
重启Tomcat以触发部署:
sudo systemctl restart tomcat
sleep 5
sudo systemctl is-active tomcat
sudo ls -lh /opt/tomcat/webapps
sudo ls -ld /opt/tomcat/webapps/demo 2>/dev/null || true
Tomcat可能会自动解压demo.war为demo目录。部署结果应通过日志和应用接口共同确认:
sudo journalctl -u tomcat -n 120 --no-pager
sudo ls -1 /opt/tomcat/logs
如果应用提供健康检查接口,例如/health,可以执行:
curl -i --max-time 10 http://127.0.0.1:8080/demo/health
没有约定健康接口时,可以先访问应用根路径:
curl -i --max-time 10 http://127.0.0.1:8080/demo/
200或业务约定的204通常表示接口成功;3xx表示发生跳转,需要继续确认跳转目标;404应检查上下文路径和接口路径;500则需要查看应用日志和兼容性配置。
6. 配置外部访问并验证
本机访问成功后,再处理外部网络。先查看UFW状态:
sudo ufw status verbose
如果只需要允许指定办公出口或管理端访问,建议限制来源地址。下面的203.0.113.10是文档示例地址,执行前必须替换成实际来源IP:
sudo ufw allow from 203.0.113.10 to any port 8080 proto tcp
sudo ufw status numbered
如果确实需要临时允许所有来源访问8080,可使用:
sudo ufw allow 8080/tcp
sudo ufw status numbered
开放端口会扩大Tomcat的网络暴露范围,操作前应确认业务确实需要,并记录新增规则。云服务器还需要在云平台安全组中放行相同端口;仅修改UFW不能绕过云侧规则。
从另一台允许访问的主机验证:
curl -i --max-time 10 http://服务器公网IP:8080/demo/
如果本机成功、远程失败,通常按以下顺序检查:

- 云安全组或网络ACL是否允许来源IP访问8080。
- UFW是否处于
active状态,并且规则来源、端口和协议正确。 ss -lntp显示的监听地址是否为服务器可达地址,而不是仅监听127.0.0.1。- 远程请求使用的IP是否对应当前服务器,DNS是否已解析到正确地址。
- 服务器运营商或上级网络是否限制了该端口。
常见异常处理
Java版本或运行时路径不匹配
如果日志出现UnsupportedClassVersionError,通常表示应用编译所用JDK高于当前运行时。先检查:
java -version
sudo systemctl show tomcat -p Environment
sudo journalctl -u tomcat -n 80 --no-pager
如果systemd中的JAVA_HOME写错,修改服务文件后执行:
sudo systemctl edit --full tomcat
sudo systemctl daemon-reload
sudo systemctl restart tomcat
不要只修改当前Shell的JAVA_HOME,因为systemd服务不会自动继承当前终端的环境变量。
8080端口已被占用
检查占用进程:
sudo ss -lntp | grep ':8080'
如果占用者不是本次Tomcat,不要直接终止进程。可以选择使用其他空闲端口,并在修改前备份配置:
sudo cp -a /opt/tomcat/conf/server.xml \
"/opt/tomcat/conf/server.xml.bak.$(date +%Y%m%d%H%M%S)"
sudoedit /opt/tomcat/conf/server.xml
将对应HTTP Connector的port="8080"改为已确认空闲的端口,例如8081,然后重启并验证:
sudo systemctl restart tomcat
sudo ss -lntp | grep ':8081'
curl -I http://127.0.0.1:8081/
如果改端口后出现问题,使用备份文件恢复server.xml,再重启服务。端口变更还需要同步修改UFW和云安全组规则。
WAR部署后返回404
先检查文件名和目录:
sudo ls -lh /opt/tomcat/webapps
sudo ls -ld /opt/tomcat/webapps/demo
sudo journalctl -u tomcat -n 150 --no-pager | grep -Ei 'demo|deploy|error|exception'
常见原因包括访问路径错误、WAR包没有成功解压、应用启动失败,以及应用实际上下文路径与预期不同。demo.war对应的是/demo/,不是/。如果日志显示应用启动失败,先处理最早出现的异常,不要只关注最后一行的HTTP 404。
返回500或启动时报Servlet类错误
Tomcat 10.1使用Jakarta Servlet API。如果日志出现找不到javax.servlet.*类、过滤器或监听器,通常是应用仍按旧命名空间构建。此时应确认应用交付说明:
- 使用
jakarta.*的应用,可以继续排查应用配置、依赖和外部服务。 - 使用
javax.*的传统应用,应评估Tomcat 9或完成应用迁移。 - 不要通过随意复制Servlet API JAR包的方式混用两个命名空间。
结果检查
部署完成后,至少保留以下验证结果:
sudo systemctl is-enabled tomcat
sudo systemctl is-active tomcat
sudo ss -lntp | grep ':8080'
curl -I --max-time 10 http://127.0.0.1:8080/
curl -i --max-time 10 http://127.0.0.1:8080/demo/
sudo journalctl -u tomcat -n 50 --no-pager
判断顺序应为:

systemctl is-active为active,说明systemd认为服务正在运行。ss能看到Java监听目标端口,说明TCP监听已经建立。- 本机
curl能获得HTTP响应,说明Tomcat连接器可以处理请求。 - 应用路径返回业务预期状态码,说明WAR已部署并能处理请求。
- 远程
curl成功,说明外部网络、防火墙和云安全组配置基本连通。 - 日志没有持续出现启动异常、类加载错误或反复重启,说明运行环境较完整。
回滚方案
回滚前先停止服务,避免Tomcat继续读取或写入正在调整的文件:
sudo systemctl disable --now tomcat
应用包回滚前保留当前版本,不要直接删除:
sudo mkdir -p /root/tomcat-rollback
sudo cp -a /opt/tomcat/webapps/demo.war /root/tomcat-rollback/demo.war.current
sudo cp -a /opt/tomcat/conf /root/tomcat-rollback/conf.current
如果有上一版WAR包,将其复制回原路径:
sudo install -o tomcat -g tomcat -m 0640 \
/root/tomcat-rollback/demo.war.previous \
/opt/tomcat/webapps/demo.war
sudo rm -rf /opt/tomcat/webapps/demo
sudo systemctl enable --now tomcat
rm -rf /opt/tomcat/webapps/demo只适用于确认该目录是由当前demo.war展开生成、且没有需要保留的运行时数据的情况。应用上传文件或本地持久化内容不应放在可随意删除的展开目录中。
如果要撤销本次Tomcat安装,可以先将目录改名保留现场,再移除服务定义:
sudo systemctl disable --now tomcat
sudo mv /opt/tomcat "/opt/tomcat.rollback.$(date +%Y%m%d%H%M%S)"
sudo rm -f /etc/systemd/system/tomcat.service
sudo systemctl daemon-reload
确认不再需要回收的安装目录后,再单独清理对应的/opt/apache-tomcat-*目录和tomcat系统用户。删除前应确认目录中没有应用包、配置备份或日志。
如果回滚了防火墙规则,先查看规则编号:
sudo ufw status numbered
再按实际规则删除。例如此前添加的是指定来源规则:
sudo ufw delete allow from 203.0.113.10 to any port 8080 proto tcp
如果此前开放的是所有来源:
sudo ufw delete allow 8080/tcp
验收与回滚检查项
验收时确认:
- JDK版本与Tomcat、应用编译版本兼容。
- Tomcat由
tomcat非登录系统用户运行,而不是由root直接运行。 - systemd服务为
enabled,服务器重启后可自动拉起。 - 监听端口、监听地址与预期一致。
- 本机根路径和应用实际上下文路径均得到合理HTTP响应。
- 应用日志没有持续出现类加载、权限、配置或内存异常。
- 外部访问仅从已批准的来源放行,并已同步检查云安全组。
- 已记录WAR包校验值、Tomcat版本、配置文件备份位置和端口规则。
回滚时确认:
- 已停止并禁用Tomcat服务。
- 当前WAR包、
conf目录和端口配置已备份。 - 回滚版本已复制到正确的
webapps路径,并重新设置tomcat用户权限。 - 回滚后重新检查
systemctl、监听端口、HTTP响应和日志。 - 不再需要的防火墙规则已删除。
- 未误删应用持久化数据、证书、外部配置或其他服务文件。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/7929.html



