Path: 宝塔面板 API 参考 › Java 项目

`POST /mod/java/project/create_spring_boot_project/stype`

将已有的 Spring Boot jar 包创建为面板管理的 Java 项目，支持开机启动、日志管理和状态监控。

## Request body

_Required._

- `opPostModJavaProjectCreateSpringBootProjectStype.request_time` (string, required) — 时间戳
- `opPostModJavaProjectCreateSpringBootProjectStype.request_token` (string, required) — 签名

## Example request

```text
{
  "request_time": "string",
  "request_token": "string"
}
```

## Code samples

### cURL（填写面板地址与签名）

```curl
curl --request POST \
  --url "https://your-panel.example.com:8888/mod/java/project/create_spring_boot_project/stype" \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "request_time=<Unix时间戳>" \
  --data-urlencode "request_token=<按 API 概览生成的签名>"
```

## Responses

### default

接口响应，业务状态见下方详细说明。

#### Example

```json
{
  "status": true,
  "msg": "操作已执行"
}
```

- `opPostModJavaProjectCreateSpringBootProjectStype.response.default.status` (boolean, optional) — `true` 创建成功


## create_spring_boot_project

将已有的 Spring Boot jar 包创建为面板管理的 Java 项目，支持开机启动、日志管理和状态监控。

**前置条件**：JDK 已安装，jar 文件已上传到服务器。

- **路由**：`POST /mod/java/project/create_spring_boot_project/stype`
- **方法**：POST

## 输入参数

### 基本参数（URL query string）

| 参数名称 | 必选 | 类型 | 描述 |
|----------|------|------|------|
| request_time | 是 | String | 时间戳 |
| request_token | 是 | String | 签名 |

### 项目参数（POST body `data` 字段，JSON 字符串）

| 参数名称 | 必选 | 类型 | 描述 |
|----------|------|------|------|
| project_name | 是 | String | 项目名称（唯一） |
| project_jar | 是 | String | jar 文件完整路径 |
| project_jdk | 是 | String | JDK 路径，如 `/www/server/java/jdk1.8.0_371` |
| run_user | 是 | String | 运行用户，如 `root` |
| project_cmd | 是 | String | 完整的启动命令，如 `/www/server/java/jdk1.8.0_371/bin/java -jar /path/to/app.jar` |
| domains | 否 | Array&lt;String&gt; | 绑定的域名列表，如 `["app.bt.local:8080"]` |
| port | 否 | Integer | 运行端口 |
| project_ps | 否 | String | 备注 |
| proxy_path | 否 | String | 代理路径，默认 `/` |

> **重要**：`project_cmd` 必须包含完整的 `java` 可执行文件路径，不能只用 `-jar` 参数。

## 输出参数

| 参数名称 | 类型 | 描述 |
|----------|------|------|
| status | Boolean | `true` 创建成功 |

## 示例

### 请求

```
POST /mod/java/project/create_spring_boot_project/stype
Content-Type: application/x-www-form-urlencoded

request_time=1779500000&request_token=xxx&data={"project_name":"myapp","project_jar":"/tmp/app.jar","project_jdk":"/www/server/java/jdk1.8.0_371","run_user":"root","project_cmd":"/www/server/java/jdk1.8.0_371/bin/java -jar /tmp/app.jar","domains":["app.bt.local:8080"]}
```

### 响应

```json
{"status": true, "msg": "操作已执行"}
```

## 完整流程

创建项目并部署 SSL 证书：

```
1. create_spring_boot_project (带 domains) → 创建项目
2. bind_extranet → 生成 Nginx 配置
3. /ssl?action=SetCertToSite → 部署 SSL 证书
```

## 相关接口

- [install_jdk_new](/api/java/install_jdk_new) — 安装 JDK
- [bind_extranet](/api/java/bind_extranet) — 外网映射
- [project_list](/api/java/project_list) — 项目列表