温馨提示×

如何配置Debian上Tomcat

小樊
45
2026-08-05 07:57:51
栏目: 智能运维

下面给你一份在 Debian 系统上配置 Apache Tomcat的完整流程(以 Tomcat 9 + Debian 11/12 为例,其他版本类似)。


一、准备工作

1. 更新系统

sudo apt update
sudo apt upgrade -y

2. 安装 Java(JDK)

Tomcat 需要 Java 运行环境。

sudo apt install default-jdk -y

验证:

java -version

二、下载并安装 Tomcat

方式一(推荐):使用官方二进制包

1. 创建 tomcat 用户(安全)

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

2. 下载 Tomcat

前往官网查看最新版本:https://tomcat.apache.org/

cd /tmp
wget https://dlcdn.apache.org/tomcat/tomcat-9/v9.0.85/src/apache-tomcat-9.0.85.tar.gz

⚠️ 注意:请替换为当前最新稳定版

3. 解压并安装

sudo mkdir -p /opt/tomcat
sudo tar -xzf apache-tomcat-*.tar.gz -C /opt/tomcat --strip-components=1

4. 设置权限

sudo chown -R tomcat:tomcat /opt/tomcat
sudo chmod -R u+x /opt/tomcat/bin

三、配置 Tomcat

1. 配置 systemd 服务

创建服务文件:

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

内容如下(按实际路径调整):

[Unit]
Description=Apache Tomcat
After=network.target

[Service]
Type=forking

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_PID=/opt/tomcat/temp/tomcat.pid

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

Restart=on-failure

[Install]
WantedBy=multi-user.target

重新加载 systemd:

sudo systemctl daemon-reload

2. 启动并设置开机启动

sudo systemctl start tomcat
sudo systemctl enable tomcat

查看状态:

sudo systemctl status tomcat

四、配置防火墙(如启用 UFW)

sudo ufw allow 8080/tcp

五、访问 Tomcat

浏览器访问:

http://服务器IP:8080

看到 Tomcat 默认页面即成功 ✅


六、配置管理用户(可选但常用)

编辑用户配置文件:

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

<tomcat-users> 中添加:

<role rolename="manager-gui"/>
<role rolename="admin-gui"/>
<user username="admin" password="strongpassword" roles="manager-gui,admin-gui"/>

允许远程访问管理界面(默认限制本地)

编辑:

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

注释掉:

<!-- <Valve className="org.apache.catalina.valves.RemoteAddrValve" ... /> -->

重启 Tomcat:

sudo systemctl restart tomcat

七、常见配置调整

1. 修改端口(如 80)

编辑:

sudo nano /opt/tomcat/conf/server.xml
<Connector port="80" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443" />

2. 增加 JVM 内存

编辑:

sudo nano /opt/tomcat/bin/setenv.sh
export CATALINA_OPTS="-Xms512M -Xmx1024M"

八、常见问题排查

问题 排查方式
无法访问 systemctl status tomcat
端口占用 `ss -tlnp
Java 错误 /opt/tomcat/logs/catalina.out

如果你需要:

  • Tomcat 10
  • Debian + Nginx 反向代理
  • HTTPS / SSL 配置
  • 多实例 Tomcat

告诉我你的具体需求,我可以给你定制方案。

0