温馨提示×

debian怎样配置tomcat

小樊
37
2026-07-10 00:39:57
栏目: 智能运维

在 Debian 系统上配置 Apache Tomcat,一般流程包括 安装 JDK、下载/安装 Tomcat、配置环境变量、配置用户与端口、设置开机自启 等。下面以 Tomcat 9 + Debian 11/12 为例,给你一套常用且规范的配置方法。


一、安装 Java(JDK)

Tomcat 依赖 Java 环境。

1️⃣ 安装 OpenJDK(推荐)

sudo apt update
sudo apt install openjdk-11-jdk -y

验证:

java -version

输出类似:

openjdk version "11.0.20"

二、创建 Tomcat 专用用户(安全推荐)

不建议用 root 运行 Tomcat。

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

三、下载并安装 Tomcat

1️⃣ 下载 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

(版本号可自行替换)

2️⃣ 解压并移动到 /opt

tar -xzf apache-tomcat-9.0.85.tar.gz
sudo mv apache-tomcat-9.0.85 /opt/tomcat

3️⃣ 设置权限

sudo chown -R tomcat:tomcat /opt/tomcat
sudo chmod -R 755 /opt/tomcat

四、配置环境变量(可选但推荐)

编辑文件:

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

1️⃣ 创建 systemd 服务

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

[Service]
Type=forking

User=tomcat
Group=tomcat

Environment="JAVA_HOME=/usr/lib/jvm/java-11-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

⚠️ JAVA_HOME 路径可用 update-alternatives --config java 查看


五、启动并设置开机自启

sudo systemctl daemon-reexec
sudo systemctl daemon-reload
sudo systemctl start tomcat
sudo systemctl enable tomcat

查看状态:

sudo systemctl status tomcat

六、配置 Tomcat 管理用户(重要)

编辑用户配置文件:

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

<tomcat-users> 标签内添加:

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

⚠️ 生产环境请使用强密码


七、允许远程访问 Manager(可选)

默认只允许 localhost 访问。

编辑:

sudo nano /opt/tomcat/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" />
-->

重启 Tomcat:

sudo systemctl restart tomcat

八、访问 Tomcat

浏览器访问:

http://服务器IP:8080

管理页面:

http://服务器IP:8080/manager/html

九、修改端口(可选)

编辑:

sudo nano /opt/tomcat/conf/server.xml

修改:

<Connector port="8080" protocol="HTTP/1.1" ... />

例如改为 808888


十、防火墙放行端口

sudo ufw allow 8080/tcp
sudo ufw reload

✅ 常见问题

1️⃣ Tomcat 启动但无法访问?

  • 检查端口
  • 检查防火墙
  • 查看日志:
tail -f /opt/tomcat/logs/catalina.out

2️⃣ Java 路径错误?

update-alternatives --config java

如果你需要:

  • APT 方式安装 Tomcat
  • Tomcat + Nginx 反向代理
  • 多实例 Tomcat
  • Debian 10 / 12 特定配置

可以直接告诉我你的 Debian 版本和使用场景。

0