温馨提示×

Debian怎么部署Tomcat项目

小樊
40
2026-07-21 16:52:48
栏目: 智能运维

下面给你一个在 Debian 系统上部署 Tomcat 项目的完整流程,从安装到部署 WAR 包,适合新手和服务器环境。


一、环境准备

1. 更新系统

sudo apt update
sudo apt upgrade -y

2. 安装 JDK(Tomcat 依赖 Java)

推荐安装 OpenJDK 11 或 17(Tomcat 9/10 常用):

sudo apt install openjdk-17-jdk -y

验证:

java -version

二、安装 Tomcat

方式一(推荐):APT 安装(简单、稳定)

1. 安装 Tomcat

sudo apt install tomcat9 tomcat9-admin -y

2. 启动并设置开机自启

sudo systemctl start tomcat9
sudo systemctl enable tomcat9

3. 检查状态

sudo systemctl status tomcat9

方式二:手动安装(适合指定版本)

1. 下载 Tomcat

cd /opt
sudo wget https://dlcdn.apache.org/tomcat/tomcat-9/v9.0.85/bin/apache-tomcat-9.0.85.tar.gz
sudo tar -zxvf apache-tomcat-9.0.85.tar.gz
sudo mv apache-tomcat-9.0.85 tomcat

2. 设置权限

sudo chown -R www-data:www-data /opt/tomcat
sudo chmod +x /opt/tomcat/bin/*.sh

3. 创建 systemd 服务(可选)

# /etc/systemd/system/tomcat.service
[Unit]
Description=Tomcat
After=network.target

[Service]
Type=forking
User=www-data
ExecStart=/opt/tomcat/bin/startup.sh
ExecStop=/opt/tomcat/bin/shutdown.sh

[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl start tomcat
sudo systemctl enable tomcat

三、部署 Tomcat 项目

方式一:部署 WAR 包(最常见)

1. 上传 WAR 包

scp yourapp.war user@server:/var/lib/tomcat9/webapps/

或服务器上直接放:

sudo cp yourapp.war /var/lib/tomcat9/webapps/

2. 自动部署

Tomcat 会自动解压 WAR 包,访问:

http://服务器IP:8080/yourapp

方式二:直接放项目目录

/var/lib/tomcat9/webapps/yourapp/

四、配置管理后台(可选)

1. 设置管理员账号

编辑:

sudo nano /etc/tomcat9/tomcat-users.xml

添加:

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

2. 允许远程访问(默认只允许 localhost)

编辑:

sudo nano /var/lib/tomcat9/webapps/manager/META-INF/context.xml

注释掉:

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

重启:

sudo systemctl restart tomcat9

访问:

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

五、修改端口(默认 8080)

编辑:

sudo nano /etc/tomcat9/server.xml

修改:

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

改为:

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

重启:

sudo systemctl restart tomcat9

六、防火墙放行端口

sudo ufw allow 8080
sudo ufw reload

七、常见问题排查

1. 项目无法访问

  • 查看日志:
sudo tail -f /var/log/tomcat9/catalina.out

2. Java 版本不匹配

java -version

3. 权限问题

chmod -R 755 /var/lib/tomcat9/webapps

八、总结流程

✅ 安装 JDK
✅ 安装 Tomcat
✅ 上传 WAR 包到 webapps
✅ 访问 http://IP:8080/项目名
✅ 配置管理后台(可选)


如果你愿意,我可以:

  • ✅ 帮你写 systemd 完整配置
  • ✅ 给你 Nginx + Tomcat 反向代理
  • ✅ 帮你排查 部署失败日志
  • ✅ 给你 生产环境优化建议

你现在是 本地测试 还是 云服务器部署

0