银河麒麟系统下Tomcat服务器安装配置详细教程

在银河麒麟操作系统上部署Java Web应用，首要任务就是完成Tomcat服务器的安装与配置。动手之前，需要先确认几个关键环节：JDK环境是否就绪、Tomcat二进制包是否下载、权限与服务配置是否完善。银河麒麟V10系列（含SP1、SP2等子版本）默认并未集成Tomcat，且多数版本甚至没有预装兼容的OpenJDK 17。如果直接执行startup.sh启动脚本，必然会遇到“JAVA_HOME not set”或“No Java runtime present”等错误提示。因此，核心前提是：必须显式配置并验证Java运行环境。

先摸清系统底细和Java状态

动手之前，需要先确认两个关键信息：操作系统是基于Debian系还是CentOS系的发行版，CPU架构是x86_64还是aarch64。这两点直接决定了JDK和Tomcat安装包的选择。同时，还要检查系统中是否已预装兼容的OpenJDK，避免重复安装或出现版本冲突问题。

如何判断？执行cat /etc/os-release命令，重点关注ID_LIKE字段——如果包含debian，则为Debian系；如果包含centos或rhel，则为CentOS系。接着运行uname -m查看架构：输出aarch64表示ARM版本，x86_64表示标准AMD/Intel版本。

然后，使用java -version 2>/dev/null || echo "未安装Java"检测Java是否可用。如果返回了版本号，别忘了再执行echo $JAVA_HOME检查环境变量是否配置——这一步非常关键：如果JAVA_HOME为空，即使java命令可以运行，后续Tomcat启动仍然会报错。

安装并配置OpenJDK 17

Tomcat 9.0.115及以上版本要在银河麒麟系统上稳定运行，依赖OpenJDK 17——其JVM特性与安全性表现优于旧版本。需要注意的是，必须同时安装-devel开发包，否则编译型Web应用或startup.sh脚本可能因找不到tools.jar而无法正常启动。

具体操作分为两种情况：

• 如果系统为CentOS系，执行sudo yum install java-17-openjdk java-17-openjdk-devel -y。
• 如果系统为Debian系，执行sudo apt install openjdk-17-jdk -y。

安装完成后，编辑全局环境变量配置文件：sudo nano /etc/profile，在文件末尾添加以下三行内容。这里的路径必须与realpath $(dirname $(dirname $(readlink -f $(which java))))命令输出的路径保持一致——切勿直接写死固定路径：

export JAVA_HOME=/usr/lib/jvm/java-17-openjdk
export JRE_HOME=$JAVA_HOME/jre
export PATH=$PATH:$JAVA_HOME/bin

然后执行source /etc/profile使配置立即生效。最后运行echo $JAVA_HOME && java -version进行双重验证——如果能正确输出路径和17.x版本号，说明Java环境已配置就绪。

下载并解压Tomcat 9.0.115到标准位置

建议使用官方发布的.tar.gz免安装压缩包，这样可以规避麒麟系统中SELinux策略或AppArmor可能带来的访问限制。解压至/usr/local/目录，既便于统一权限管理，也方便后续升级维护，同时符合国产化系统的部署规范要求。

• 首先创建专用安装目录：sudo mkdir -p /usr/local/src/tomcat。
• 进入该目录并下载稳定版本：cd /usr/local/src/tomcat && sudo wget https://dlcdn.apache.org/tomcat/tomcat-9/v9.0.115/bin/apache-tomcat-9.0.115.tar.gz。
• 生产环境务必校验压缩包的完整性：sudo sha512sum apache-tomcat-9.0.115.tar.gz | grep -q "b4e3d9c3" && echo "校验通过" || echo "校验失败"——如果提示“校验失败”，请立即删除文件并重新下载，防止安装包被篡改。
• 校验通过后，解压到标准路径：sudo tar -zxvf apache-tomcat-9.0.115.tar.gz -C /usr/local/，然后创建软链接以便后续维护：sudo ln -s /usr/local/apache-tomcat-9.0.115 /usr/local/tomcat。

创建专用用户并授权运行目录

安全至关重要——绝对禁止使用root身份直接运行Tomcat服务。需要创建一个独立的系统用户，并仅授予其最小必要权限。

• 创建无登录Shell的专用系统用户：sudo useradd -M -s /sbin/nologin tomcat。
• 将Tomcat安装目录的所有权分配给该用户：sudo chown -R tomcat:tomcat /usr/local/tomcat。
• 为bin目录下的所有脚本添加可执行权限：sudo chmod +x /usr/local/tomcat/bin/*.sh。

配置systemd服务实现开机自启

使用systemd管理Tomcat进程具有明显优势——启停操作标准化、日志集成便捷、还能实现故障自动恢复。相比手动执行startup.sh脚本更加稳定可靠。

创建服务定义文件：sudo nano /usr/lib/systemd/system/tomcat.service，填入以下配置内容：

[Unit]
Description=Apache Tomcat Web Application Container
After=syslog.target network.target

[Service]
Type=forking
Environment=JAVA_HOME=/usr/lib/jvm/java-17-openjdk
Environment=CATALINA_PID=/usr/local/tomcat/temp/tomcat.pid
Environment=CATALINA_HOME=/usr/local/tomcat
Environment=CATALINA_BASE=/usr/local/tomcat
ExecStart=/usr/local/tomcat/bin/startup.sh
ExecStop=/usr/local/tomcat/bin/shutdown.sh
RestartSec=10
Restart=always
User=tomcat
Group=tomcat

[Install]
WantedBy=multi-user.target

重新加载systemd配置：sudo systemctl daemon-reload。启用开机自启动：sudo systemctl enable tomcat。立即启动服务：sudo systemctl start tomcat。

开放防火墙端口并验证HTTP访问

银河麒麟系统默认启用firewalld防火墙，如果不放行8080端口，浏览器将无法访问Tomcat欢迎页面。

• 永久开放端口：sudo firewall-cmd --permanent --add-port=8080/tcp。
• 重新加载防火墙规则：sudo firewall-cmd --reload。
• 检查Tomcat进程运行状态：sudo systemctl status tomcat，确保Active状态显示为“active (running)”。

最后，在本地浏览器中访问http://127.0.0.1:8080，如果能够看到Apache Tomcat的欢迎页面，恭喜您——Tomcat部署工作已全部完成。