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

> 宝塔面板（BT Panel）Windows 环境中部署 Java 项目的完整教程，含 SpringBoot 项目从 JDK 安装、代码上传、运行环境配置到端口映射与服务启动的全流程。

原文：[宝塔 Windows 面板 Java 项目部署教程](https://docs.bt.cn/practical-tutorials/java-deployment-windows)

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

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

本教程针对宝塔 Windows 面板 8.5.0 正式版本，详细说明 Java 项目部署相关的功能调整，并结合实战案例演示 SpringBoot 项目的完整部署流程。

> **说明：前置说明**
>
> 本次实战部署基于内网机器完成，演示所用域名为测试用途（通过修改 hosts 文件实现本地访问），核心部署流程与公网环境完全一致。

## 部署准备

### 1. 项目来源

- **后端项目**：renren-fast（SpringBoot 后端服务）
- **前端项目**：renren-fast-vue（Vue 前端静态资源）

### 2. 项目打包

按照官方教程完成项目打包。

> **提示：重要提示**
>
> 打包前可按需修改配置文件，本次部署的核心配置调整也在该环节完成。

## SpringBoot 后端服务部署实战

### 创建数据库

首先在宝塔面板中创建项目所需的数据库。

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

### 导入 SQL 文件

导入项目官方提供的 SQL 文件，确认表都建立完成后，返回 Java 项目页面创建项目。

![导入SQL文件](https://docs.bt.cn/img/practical-tutorials/java-deployment/java-deploy-02.png)
![创建项目](https://docs.bt.cn/img/practical-tutorials/java-deployment/java-deploy-03.png)

### 创建 Java 项目

在宝塔面板中创建 Java 项目，配置相关参数。创建项目后，查看项目日志确认启动成功。

![项目日志](https://docs.bt.cn/img/practical-tutorials/java-deployment/java-deploy-04.png)

![启动成功](https://docs.bt.cn/img/practical-tutorials/java-deployment/java-deploy-05.png)

![关联前端资源](https://docs.bt.cn/img/practical-tutorials/java-deployment/java-deploy-06.png)

### 配置前端资源

在创建项目时，已设置关联前端资源，无需单独配置反向代理。
![访问测试](https://docs.bt.cn/img/practical-tutorials/java-deployment/java-deploy-07.png)

### 访问测试

由于是本地测试，通过修改 hosts 文件访问测试站点。人人开源默认账号密码为 `admin`，`admin`。

![登录界面](https://docs.bt.cn/img/practical-tutorials/java-deployment/java-deploy-08.png)
![项目路径](https://docs.bt.cn/img/practical-tutorials/java-deployment/java-deploy-09.png)

## Java 部署核心功能解析

### 一、项目路径

**功能解析**：

核心指向 Java 项目可执行 JAR 包在服务器上的实际存储路径（也是项目运行的基础目录）。

### 二、项目 JDK

**功能解析**：

1. 选择项目运行依赖的 JDK 版本，需提前在宝塔面板【软件商店】安装对应版本（支持 JDK1.7/11/17 等）
2. 支持自定义 JDK 路径（适配非面板安装的 JDK），需填写 JDK 安装根目录（如 `D:\jdk1.8.0_391`）

**面板安装 JDK**：

![面板安装JDK](https://docs.bt.cn/img/practical-tutorials/java-deployment/java-deploy-10.png)

**自定义 JDK 配置**：

![自定义JDK](https://docs.bt.cn/img/practical-tutorials/java-deployment/java-deploy-11.png)

### 三、项目执行命令

**功能解析**：

1. 面板默认生成基础启动命令（示例：`C:\BtSoft\jdk\xx\bin\java.exe -jar -Xmx1024M -Xms256M xxx.jar`）
2. 支持自定义命令，可添加 JVM 参数、指定外置配置文件等优化项

**示例**：

```bash
C:\BtSoft\jdk\xx\bin\java.exe -jar -Xmx1024M -Xms256M xxx.jar --server.port=xxxx
```

![执行命令](https://docs.bt.cn/img/practical-tutorials/java-deployment/java-deploy-12.png)

### 四、环境变量

**功能解析**：

1. 配置项目运行所需的环境变量
2. 配置格式为 `KEY=VALUE`，多行配置需换行，面板会自动注入到项目运行环境中

**指定变量配置和项目执行命令中使用**：

![环境变量配置](https://docs.bt.cn/img/practical-tutorials/java-deployment/java-deploy-13.png)

**从文件加载配置和项目执行命令中使用**：

![从文件加载](https://docs.bt.cn/img/practical-tutorials/java-deployment/java-deploy-14.png)

**可以在负载状态中查看所配置的环境变量**：

![查看环境变量](https://docs.bt.cn/img/practical-tutorials/java-deployment/java-deploy-15.png)

### 五、绑定域名

**功能解析**：

绑定项目访问的域名（内网测试可填服务器 IP + 端口，公网需提前完成域名解析）。

![绑定域名](https://docs.bt.cn/img/practical-tutorials/java-deployment/java-deploy-16.png)

### 六、后端路由

**功能解析**：

配置项目的上下文路径（Context Path，示例：`/api`），即接口访问的前缀。

### 七、前端资源

**功能解析**：

支持关联前端静态资源（如 renren-fast-vue 的 dist 目录）。

## 总结

通过本教程，您可以在宝塔 Windows 面板 8.5.0 正式版中快速部署 SpringBoot 项目。核心步骤包括：

1. 创建数据库并导入 SQL 文件
2. 配置 JDK 环境
3. 创建 Java 项目并配置运行参数
4. 关联前端资源
5. 绑定域名并测试访问

宝塔面板提供了完善的 Java 项目管理功能，包括 JDK 版本管理、环境变量配置、执行命令自定义等，可以满足各类 Java 项目的部署需求。