Bt Java Project Deploy

在宝塔面板上部署 Java jar 项目(Spring Boot),并在项目启动失败时排错。 当用户要求把本机已有的 jar 包部署成面板可管理的 Java 项目(含 JDK、Nginx 代理/域名), 或 Java 项目启动失败/访问异常需要排查根因时使用。 触发关键词:部署 Java、jar 包部署、Spring Boot 部署、Java 项目创建、 Java 项目启动失败、jar 起不来、jar 启动报错、502、访问异常、JDK 版本不匹配。 日常的启停/状态/日志/改配置等简单操作不依赖本 SOP,直接按工具描述调用即可。

43 stars 8 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add aaPanel/btpanel-skills --skill bt-java-project-deploy
Manual install
git clone --depth 1 https://github.com/aaPanel/btpanel-skills.git /tmp/btpanel-skills
mkdir -p ~/.claude/skills
cp -r /tmp/btpanel-skills/assets/bt-skills/bt-java-project-deploy ~/.claude/skills/bt-java-project-deploy

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Java 项目部署与启动排错 SOP

> **停止。执行任何操作前,必须完整阅读本文档。**
> 本 Skill 的工具均指 bt_agent_mcp 插件暴露的 MCP 工具;同一能力在宝塔 AI 内置端可能有不同命名,按当前环境可用工具调用。
> 本 SOP 只覆盖两个主场景:**① 部署 Java 项目;② 项目启动排错**。其他简单操作(状态查看、启停、日志、域名、改配置、删除)不做 SOP,直接使用工具。

---

## 核心规则

1. **先只读侦察,再执行变更** —— 部署前必须完成 jar 分析;排错先读日志,不盲目重启。
2. **创建后必须验证启动** —— "创建成功"不算完,必须确认进程存活 + 监听端口 + 日志无致命错误;验证失败即转入场景二。
3. **删除项目属高风险**,必须先获得用户明确确认;启停/重启/改配置属中风险,操作前说明影响。
4. **JDK 匹配** —— Spring Boot 3.x 需 JDK 17+,Boot 2.x 需 JDK 8/11;安装或切换前先检测本机 JDK。
5. **端口唯一性** —— 创建/改端口前检查占用。
6. **域名可访问 = 三件事** —— ① `add_domain` 写入 `server_name`;② `bind_extranet` 开启外网框架(生成 conf 骨架,**不含反代**);③ `add_proxy(proxy_port=应用端口)` 真正注入 `proxy_pass http://127.0.0.1:port`。**漏掉 ③ 会访问 403**。创建时带 `domains` 会完成 ①② 并尝试自动建 ③,但**必须验证**(`proxy_list` 或 grep `proxy_pass`),缺失即补 `add_proxy`。
7. **每个任务最多调用 15 次工具**,超出后汇总当前发现并停止。
8. **禁止操作**:删除 jar 源文件、`rm -rf` 项目目录、修改宝塔/插件自身文件、读取插件 `data/` 凭据。

---

# 场景一:部署 Java 项目

## Step 0 —— 预检
1. 确认任务确为"部署新 Java 项目"(非排错/运维)。
2. 需要外网域名访问时,确认 Nginx 已安装;否则只能本机/内网访问。
3. (可用 todo 工具时)建任务列表:定位 jar → 分析 → JDK → 创建 → 验证。

## Step 1 —— 定位 jar 包
- 用户直接给出 jar 绝对路径,或:
- 用文件工具 `Glob(pattern='**/*.jar')` / `LS(path=...)` 在服务器上定位 jar(排除运行目录与 `lib/` 依赖库)。
- **校验**:路径存在、是普通文件、非敏感目录(`/etc`、`/boot`、插件 `data/` 等)。
- 记录 jar 绝对路径与所在目录(jar_path)。

## Step 2 —— 分析 jar(部署前必须)
调用 `JavaProjectCreate(jar_path=..., analyze_only=true)`(只读,不创建)。返回:
1. 是否 Spring Boot 可执行 jar(jar_info)。
2. **应用端口**(`application.yml/properties` 的 `server.port`,或命令行/环境变量覆盖)。
Read the full skill on GitHub

Details

Skill name
bt-java-project-deploy
Path
assets/bt-skills/bt-java-project-deploy/SKILL.md
License
MIT
Repo updated
21 August 2026

FAQ

What does the Bt Java Project Deploy skill do?

在宝塔面板上部署 Java jar 项目(Spring Boot),并在项目启动失败时排错。 当用户要求把本机已有的 jar 包部署成面板可管理的 Java 项目(含 JDK、Nginx 代理/域名), 或 Java 项目启动失败/访问异常需要排查根因时使用。 触发关键词:部署 Java、jar 包部署、Spring Boot 部署、Java 项目创建、 Java 项目启动失败、jar 起不来、jar 启动报错、502、访问异常、JDK 版本不匹配。 日常的启停/状态/日志/改配置等简单操作不依赖本 SOP,直接按工具描述调用即可。

How do I install the Bt Java Project Deploy skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add aaPanel/btpanel-skills --skill bt-java-project-deploy. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Bt Java Project Deploy popular?

It lives in aaPanel/btpanel-skills, which has 43 GitHub stars and 8 forks.

Related skills

Bt Go Project Deploy

43

aaPanel/btpanel-skills

在宝塔面板上部署 Go 项目(编译好的二进制,含 Go SDK 版本安装、项目注册、进程启停、域名/外网映射), 并在项目启动失败时排错。当用户要求把本机编译好的 Go 二进制部署成面板可管理的项目(含 Go SDK 安装、 端口/运行用户配置、域名绑定),或 Go 项目启动失败/访问异常需要排查根因时使用。 触发关键词:部署 Go、Go 项目、go build 产物部署、Go 二进制、Gin/Beego/Echo 服务、Go SDK 安装、 go1.xx、GOPROXY、Go 项目启动失败、error while loading shared libraries、Address already in use。 日常的启停/状态/日志/改配置/删项目等简单操作不依赖本 SOP,直接按工具描述调用即可。

Software Development

Bt HTML Project Deploy

43

aaPanel/btpanel-skills

在宝塔面板上管理 Html(静态)项目:创建静态站点(域名 + 网站根目录)、把前端构建产物部署到站点目录、 编辑伪静态 rewrite 配置(SPA try_files / 自定义 location / 缓存)、改域名/网站根目录/运行目录/启停, 并在静态站点访问异常(404 / SPA 刷新 404 / 伪静态不生效 / 目录权限)时排错。 当用户要求把前端静态页面(HTML/SPA/单页应用)挂到域名上,或静态站点访问异常需要排查时使用。 触发关键词:静态网站、HTML项目、部署前端、SPA、单页应用、伪静态、rewrite、运行目录、静态站 404、 SPA 404、BT-Html-Project-Deploy。 日常的查看/启停/改备注等简单操作不依赖本 SOP,直接按工具描述调用即可。

DevOps & Cloud

Bt Node Project Deploy

43

aaPanel/btpanel-skills

在宝塔面板上部署 Node.js 项目(nodejs/general/pm2 三种类型,含 Nginx 域名/反代), 并在项目启动失败或访问异常时排错。 当用户要求把本机已有的 Node 项目目录部署成面板可管理的项目(含 node 版本、依赖安装、 Nginx 代理/域名、pm2 守护),或 Node 项目启动失败/访问异常需要排查根因时使用。 触发关键词:部署 Node、Node 项目部署、nodejs 部署、npm 项目部署、PM2 部署、 Node 项目启动失败、npm 起不来、Node 报错、502、访问异常、pm2 errored、Cannot find module。 日常的启停/状态/日志/改配置等简单操作不依赖本 SOP,直接按工具描述调用即可。

Software Development

Bt Python Project Deploy

43

aaPanel/btpanel-skills

在宝塔面板上部署 Python 项目(uwsgi/gunicorn/command 三种运行方式,含虚拟环境配置、 Python 版本安装、requirements 依赖、Nginx 域名/反代),并在环境准备或启动失败时排错。 当用户要求把本机已有的 Python 项目目录部署成面板可管理的项目(含 Python 版本安装、 虚拟环境创建、pip 依赖、uwsgi/gunicorn 托管或自定义命令启动),或 Python 项目 启动失败/访问异常/环境准备失败需要排查根因时使用。 触发关键词:部署 Python、Python 项目部署、django/flask/fastapi/sanic 部署、 uvicorn/gunicorn/uwsgi、虚拟环境 venv、pip install、Python 项目启动失败、 ImportError、ModuleNotFoundError、502、访问异常、celery、关联进程、requirements。 日常的启停/状态/日志/改配置/装包等简单操作不依赖本 SOP,直接按工具描述调用即可。

Software Development

Vibe Coding Advisor

32

uxuiprinciples/agent-skills

Inject UX principle context into your AI coding session before generating components. Maps component types (forms, tables, dashboards, navigation, checkout, etc.) to relevant UX principles, fetches their vibeCodingPrompts, and returns an assembled context block ready to paste into Cursor, Claude Code, Windsurf, or any AI coding tool. API key optional — enriched prompts with research citations require uxuiprinciples.com API Access.

Software DevelopmentIn 1 list

Timovi Backend Engineer

49

theminimalcreator/timovi

Backend Engineer for the Timovi project. Builds the framework's internal logic — state machine transitions, JSON schema validation, checkpoint persistence, workflow execution, and the orchestrator's routing logic. Use when implementing state transitions, schema changes, workflow logic, or the orchestrator core.

Software Development

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.