温馨提示×

debian如何配置tomcat

小樊
42
2026-07-09 23:45:58
栏目: 智能运维

在 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 8,可改为 openjdk-8-jdk

2. 验证 Java

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

建议下载 Binary Distributions → Core → tar.gz

2. 解压并安装

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

3. 设置权限

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

四、配置 Tomcat 环境变量

编辑配置文件:

sudo nano /opt/tomcat/bin/setenv.sh

写入以下内容(可选但推荐):

export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
export CATALINA_HOME=/opt/tomcat
export CATALINA_BASE=/opt/tomcat

赋予执行权限:

sudo chmod +x /opt/tomcat/bin/setenv.sh

五、配置 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"/>

⚠️ 生产环境请使用复杂密码


六、允许远程访问管理页面(可选)

默认只允许 localhost 访问。

编辑:

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

注释掉 IP 限制:

<!--
<Valve className="org.apache.catalina.valves.RemoteAddrValve"
       allow="127\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1" />
-->

七、创建 systemd 服务(开机自启)

1. 创建服务文件

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-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

2. 启动并设置开机启动

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

3. 查看状态

systemctl status tomcat

八、防火墙放行 8080 端口

sudo ufw allow 8080/tcp

九、访问 Tomcat

浏览器访问:

http://服务器IP:8080

管理页面:

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

十、常见配置修改

修改端口(如 80)

编辑:

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

修改:

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

改为:

<Connector port="80" ...

十一、目录结构说明

目录 作用
bin 启动/停止脚本
conf 配置文件
webapps 部署应用
logs 日志
lib 依赖库

如果你需要:

  • APT 方式安装
  • Tomcat 10 / Jakarta EE
  • Nginx + Tomcat 反向代理
  • HTTPS / SSL 配置
  • 与 Spring Boot 部署结合

可以直接告诉我你的具体需求。

0