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

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

# 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/new_springboot_tomcat.png)

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

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

## 前期准备

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

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

![宝塔面板](https://docs.bt.cn/img/1f4fbf22-1d7b-4b02-8ed4-74dbb0c6ff37.png)

### 2. 安装 MySQL 数据库

![MySQL数据库](https://docs.bt.cn/img/8310550d-7361-4f2a-9d17-0134344e336c.png)

### 3. 安装 JDK 环境

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

![JDK环境](https://docs.bt.cn/img/bb365996-481c-4e89-9715-036f4f52a266.png)

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

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

![Tomcat安装](https://docs.bt.cn/img/1280X1280.PNG)

### 5. 验证 Tomcat 安装

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

![Tomcat验证](https://docs.bt.cn/img/718f3864-505d-4665-970b-71653cfd5991.png)

## Tomcat 项目部署

### 上传项目文件

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

![上传项目](https://docs.bt.cn/img/ea5ee9fa-edb2-49a6-b7c6-09b93375ffdc.png)

### 导入数据库

#### 创建数据库

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

![创建数据库](https://docs.bt.cn/img/d445e817-a7cd-4553-b237-b0a164859898.png)

#### 导入 SQL 数据

![导入数据库](https://docs.bt.cn/img/809b3a5a-c87a-4737-bb5a-b08ba0c029ae.png)

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

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

**获取 root 密码：**

![获取root密码](https://docs.bt.cn/img/3e62a9fc-e34e-4920-989f-7a60b80fc534.png)

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

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

![连接数据库](https://docs.bt.cn/img/373bde5f-459b-435c-9441-eb206d1c0aab.png)

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

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

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

![验证远程连接](https://docs.bt.cn/img/92796e52-0a26-4842-90ca-9a55c78dd283.png)

### 部署 Java 项目

#### 添加项目

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

![添加项目](https://docs.bt.cn/img/45998c7a-9ab9-4771-b379-6da2880f7a64.png)

#### 配置项目信息

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

![配置项目](https://docs.bt.cn/img/6c8496be-b8f3-4a22-8508-b5051b65ca1d.png)

#### 访问测试

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

![访问项目](https://docs.bt.cn/img/a9c90d3b-b7c0-4508-b326-643ced21f8eb.png)

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

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

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

![外网映射配置](https://docs.bt.cn/img/7f4d52f6-8146-480e-aea5-e020fac40617.png)

## Spring Boot 项目部署

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

### 部署前准备

:::tip 重要信息
如果有项目部署文档，请按照文档配置环境。如果没有，务必向开发人员确认以下三要素：
- **端口号**：项目运行端口
- **数据库信息**：数据库类型、名称、用户名、密码
- **JDK 版本**：项目所需的 JDK 版本

本例使用：端口 8888、MySQL 数据库（支持远程连接）、JDK 1.8.0
:::

### 上传 JAR 包

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

![上传JAR包](https://docs.bt.cn/img/deaee4ba-2ee8-4f4a-b2a3-5b259a3a7245.png)

### 查看项目配置

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

![查看配置文件](https://docs.bt.cn/img/2b71b65f-bb88-4273-af97-0bd4cd53da31.png)

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

### 准备数据库

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

![创建数据库](https://docs.bt.cn/img/798e52b0-ddd5-43dd-818d-8be60d1d2fb3.png)

### 部署 Spring Boot 应用

#### 创建项目

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

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

#### 配置并部署

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

![部署配置](https://docs.bt.cn/img/93ad9c16-eef4-4e0e-b690-77cf6e864ef0.png)

#### 访问测试

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

### 配置 80 端口访问

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

![配置80端口](https://docs.bt.cn/img/4a3b3c04-f68e-4df7-9da0-6dd6dcf4cfd1.png)

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

![80端口访问](https://docs.bt.cn/img/244d8551-16b6-4c7d-aa4e-0a02888b8ba3.png)

## 总结

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