# 宝塔 Linux 面板 Java 项目部署教程

> 宝塔面板（BT Panel）Linux 环境下部署 Java 项目的完整教程，包含 Tomcat 与 Spring Boot 两种部署方式、JDK 安装、MySQL 数据库配置与反向代理设置。

原文：[宝塔 Linux 面板 Java 项目部署教程](https://docs.bt.cn/practical-tutorials/Java-Project-Deployment-Tutorial)

文档范围：宝塔面板及相关产品（当前文档）。生成时间：2026-09-22。

## Java 项目部署教程（Linux 面板）

本文详细介绍如何在宝塔面板中部署 Java 项目，包括基于 Tomcat 的传统项目和 Spring Boot 项目的部署方法。

## 环境要求

| 组件     | 版本        |
| ------ | --------- |
| 操作系统   | Debian 12 |
| 宝塔面板   | 11.1.0    |
| Tomcat | 8.5.81    |
| JDK    | 1.8.0     |
| MySQL  | 5.7       |

## 部署方式对比

### Tomcat 部署 vs Spring Boot 部署

![部署方式对比](https://docs.bt.cn/img/practical-tutorials/new_springboot_tomcat.png)

**主要区别：**

- **Tomcat 部署**：需要安装 Tomcat 容器，将 WAR 包部署到容器中
- **Spring Boot 部署**：内置容器，只需要 JDK 环境，直接运行 JAR 包

**总结：**
Spring Boot 是一种更现代的架构，只需要 JDK 即可运行，相比传统 Tomcat 方式更易管理、维护和使用。

## 前期准备

### 1. 准备服务器环境

确保已安装宝塔面板的服务器

![宝塔面板](https://docs.bt.cn/img/practical-tutorials/java-project-deployment-tutorial-2.png)

### 2. 安装 MySQL 数据库

![MySQL数据库](https://docs.bt.cn/img/practical-tutorials/java-project-deployment-tutorial-14.png)

### 3. 安装 JDK 环境

> **提示：版本选择**
>
> 建议提前咨询开发人员所需的 JDK 版本，或查看项目部署文档。本教程使用 JDK 1.8.0 版本。

![JDK环境](https://docs.bt.cn/img/practical-tutorials/java-project-deployment-tutorial-18.png)

### 4. 安装 Tomcat（Tomcat 项目需要）

安装时注意勾选端口放行选项

![Tomcat安装](https://docs.bt.cn/img/practical-tutorials/java-project-deployment-tutorial.png)

### 5. 验证 Tomcat 安装

访问 `http://服务器IP:7702` 验证 Tomcat 是否正常运行

![Tomcat验证](https://docs.bt.cn/img/practical-tutorials/java-project-deployment-tutorial-10.png)

## Tomcat 项目部署

### 上传项目文件

将项目包通过宝塔面板上传到服务器并解压

![上传项目](https://docs.bt.cn/img/practical-tutorials/java-project-deployment-tutorial-21.png)

### 导入数据库

#### 创建数据库

根据项目部署文档创建相应的数据库名称和密码（本例中数据库名为 "resume"）

![创建数据库](https://docs.bt.cn/img/practical-tutorials/java-project-deployment-tutorial-19.png)

#### 导入 SQL 数据

![导入数据库](https://docs.bt.cn/img/practical-tutorials/java-project-deployment-tutorial-13.png)

#### 配置 MySQL 远程连接（如需要）

> **警告：注意**
>
> 如果项目需要直接连接 root 用户而非特定数据库用户，需要开启 root 远程权限（宝塔默认不开启）。

**获取 root 密码：**

![获取root密码](https://docs.bt.cn/img/practical-tutorials/java-project-deployment-tutorial-6.png)

**通过 SSH 连接数据库：**

```bash
mysql -uroot -p[复制的密码]
```

![连接数据库](https://docs.bt.cn/img/practical-tutorials/java-project-deployment-tutorial-5.png)

**执行以下 SQL 命令开启远程权限：**

```sql
use mysql;
update user set host='%' where user='root';
FLUSH PRIVILEGES;
select user,host from user;
```

**验证远程连接是否正常：**

![验证远程连接](https://docs.bt.cn/img/practical-tutorials/java-project-deployment-tutorial-15.png)

### 部署 Java 项目

#### 添加项目

进入 **网站** > **Java项目**，点击 **添加项目**

![添加项目](https://docs.bt.cn/img/practical-tutorials/java-project-deployment-tutorial-7.png)

#### 配置项目信息

填写项目相关信息并确认，等待创建完成

![配置项目](https://docs.bt.cn/img/practical-tutorials/java-project-deployment-tutorial-9.png)

#### 访问测试

创建完成后使用 `http://服务器IP:7702` 访问项目

![访问项目](https://docs.bt.cn/img/practical-tutorials/java-project-deployment-tutorial-17.png)

### 配置 80 端口访问（可选）

如需通过 80 端口访问项目：

1. 首先安装 Nginx 或 Apache
2. 在 Java 项目设置中配置外网映射

![外网映射配置](https://docs.bt.cn/img/practical-tutorials/java-project-deployment-tutorial-12.png)

## Spring Boot 项目部署

Spring Boot 的部署过程与 Tomcat 部署类似，但不需要安装 Tomcat 容器。

### 部署前准备

> **提示：重要信息**
>
> 如果有项目部署文档，请按照文档配置环境。如果没有，务必向开发人员确认以下三要素：
>
> - **端口号**：项目运行端口
> - **数据库信息**：数据库类型、名称、用户名、密码
> - **JDK 版本**：项目所需的 JDK 版本
>
> 本例使用：端口 8888、MySQL 数据库（支持远程连接）、JDK 1.8.0

### 上传 JAR 包

将 Spring Boot 项目的 JAR 包上传到服务器

![上传JAR包](https://docs.bt.cn/img/practical-tutorials/java-project-deployment-tutorial-20.png)

### 查看项目配置

如果不确定项目的配置信息，可以查看项目中的配置文件（如 `application.yml` 或 `application.properties`）

![查看配置文件](https://docs.bt.cn/img/practical-tutorials/java-project-deployment-tutorial-4.png)

> **说明**
>
> 从配置文件中可以获取数据库名称、端口等关键信息。如果找不到相关信息，请联系开发人员确认。

### 准备数据库

根据配置文件信息创建相应的数据库（本例中为 "blog"）并导入数据

![创建数据库](https://docs.bt.cn/img/practical-tutorials/java-project-deployment-tutorial-11.png)

### 部署 Spring Boot 应用

#### 创建项目

进入 **网站** > **Spring Boot**，添加新项目

![部署Spring Boot](https://docs.bt.cn/img/practical-tutorials/new_springboot_web.png)

#### 配置并部署

填写项目信息后点击确认开始部署

![部署配置](https://docs.bt.cn/img/practical-tutorials/java-project-deployment-tutorial-16.png)

#### 访问测试

部署成功后会显示项目端口，使用 `http://服务器IP:端口` 访问测试

### 配置 80 端口访问

如需通过 80 端口访问项目，可以配置反向代理

![配置80端口](https://docs.bt.cn/img/practical-tutorials/java-project-deployment-tutorial-8.png)

配置完成后直接使用服务器 IP 访问

![80端口访问](https://docs.bt.cn/img/practical-tutorials/java-project-deployment-tutorial-3.png)

## 总结

通过以上步骤，您已经完成了 Tomcat 和 Spring Boot 两种方式的 Java 项目部署。Spring Boot 方式相对更简单，推荐用于新项目开发。