Bt Website Troubleshoot
诊断并修复 bt panel 网站访问异常和服务启动失败问题。 当用户报告以下问题时使用此技能:网站无法打开、403/404/500/502/503 错误、 空白页/白屏、数据库连接错误、nginx 或 php-fpm 启动失败、 服务启动失败但没有明确原因,或任何网站宕机/访问被拒绝问题。 触发关键词:网站宕机、网站打不开、网站无法访问、502、 500、403、404、空白页、白屏、nginx 错误、php-fpm 错误、启动失败、 数据库连接失败、连接被拒绝、连接数过多、访问被拒绝、 网站不可达、服务不可用、错误网关、网站异常。
Install
npx skills add aaPanel/btpanel-skills --skill bt-website-troubleshootgit 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-website-troubleshoot ~/.claude/skills/bt-website-troubleshootPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# bt panel 网站故障排查
> **停止。在执行任何操作前,必须完整阅读本文档。**
> **第一个动作:若当前环境有 todo 工具(`TodoWrite`),先用它创建诊断任务列表**;没有则直接进入诊断。
> 不要跳过任何章节。按顺序执行决策树。
> 永远不要向用户展示原始命令、btpython 路径或代码块 —— 仅使用自然语言报告。
---
## 核心规则
1. **始终先执行预检查** —— 永远不要跳过 `curl --resolve` 本地回环验证。
2. **修复前先读取** —— 在执行任何修复操作前,先诊断根因。
3. **每个任务最多调用 15 次工具** —— 超出后,汇总当前发现并停止。
4. **绝不让用户手动输入命令** —— 始终通过 `RunCommand/Bash` 执行。
5. **修复过程中发生错误时** —— 向用户报告,不要自动重试。
6. **服务报告“启动失败”时,始终检查原始服务日志** —— 面板提示通常过于模糊,无法直接采取行动。
7. **禁止操作**:删除网站、删除数据库、删除文件、`rm -rf`、`DROP TABLE/DATABASE`。
8. **任务跟踪(可选)** —— 若当前环境提供 todo 工具(`TodoWrite`/`TodoRead`),用它跟踪诊断:开始 Step 0 前建任务列表,保持单任务 `in_progress`,完成后标 `completed`,被中断用 `TodoRead` 恢复。没有 todo 工具则跳过,直接按决策树推进。
9. **工具名双写(两个部署环境)** —— 同一个能力在内置宝塔 AI 端和插件对外接口里名字不同:执行命令是 `RunCommand` / `Bash`,精确编辑是 `SearchReplace` / `Edit`。本文档统一写成 `RunCommand/Bash`、`SearchReplace/Edit`,你按当前手头可用的那个调用即可。
---
## Step 0 —— 预检查(强制)
在任何诊断前,确认网站确实属于当前服务器,并且请求能够到达该服务器。
1. **创建任务列表(若可用)**:若当前有 `TodoWrite` 工具,先列出本次案例的步骤(预检查 → 探测 → 状态码分支 → 修复);没有则跳过本步,直接进入第 2 步。
2. **执行**:`RunCommand/Bash: curl --resolve <domain>:80:127.0.0.1 -sS -o /dev/null -w '%{http_code}\\n' http://<domain>/`
- 返回实际到达面板 nginx 的 HTTP 状态码。
3. **列出网站**:`SiteList()` → 找到匹配的 `name`(域名,作为 `site_name` 传给 `SiteGetConfig`)、`path`、`project_type`。
4. **如果网站不在当前面板上**(`curl` 返回连接错误或返回了其他网站):告知用户该域名可能并未托管在此处,不要继续。
> 仅当用户明确确认网站位于当前服务器,或直接提供了 `site_name`(域名)时,才可跳过预检查。
---
## Step 1 —— 双探针
这些探针是只读验证,不产生持久副作用。创建、测试,并在完成后**删除**。
### 探针 A —— 静态文件(验证域名绑定 + nginx + 根目录)Details
- Skill name
bt-website-troubleshoot- Repository
- aaPanel/btpanel-skills
- Path
assets/bt-skills/bt-website-troubleshoot/SKILL.md- License
- MIT
- Repo updated
- 21 August 2026
FAQ
What does the Bt Website Troubleshoot skill do?
诊断并修复 bt panel 网站访问异常和服务启动失败问题。 当用户报告以下问题时使用此技能:网站无法打开、403/404/500/502/503 错误、 空白页/白屏、数据库连接错误、nginx 或 php-fpm 启动失败、 服务启动失败但没有明确原因,或任何网站宕机/访问被拒绝问题。 触发关键词:网站宕机、网站打不开、网站无法访问、502、 500、403、404、空白页、白屏、nginx 错误、php-fpm 错误、启动失败、 数据库连接失败、连接被拒绝、连接数过多、访问被拒绝、 网站不可达、服务不可用、错误网关、网站异常。
How do I install the Bt Website Troubleshoot skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add aaPanel/btpanel-skills --skill bt-website-troubleshoot. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Bt Website Troubleshoot popular?
It lives in aaPanel/btpanel-skills, which has 43 GitHub stars and 8 forks.
Related skills
Bt Go Project Deploy
43aaPanel/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,直接按工具描述调用即可。
Bt HTML Project Deploy
43aaPanel/btpanel-skills
在宝塔面板上管理 Html(静态)项目:创建静态站点(域名 + 网站根目录)、把前端构建产物部署到站点目录、 编辑伪静态 rewrite 配置(SPA try_files / 自定义 location / 缓存)、改域名/网站根目录/运行目录/启停, 并在静态站点访问异常(404 / SPA 刷新 404 / 伪静态不生效 / 目录权限)时排错。 当用户要求把前端静态页面(HTML/SPA/单页应用)挂到域名上,或静态站点访问异常需要排查时使用。 触发关键词:静态网站、HTML项目、部署前端、SPA、单页应用、伪静态、rewrite、运行目录、静态站 404、 SPA 404、BT-Html-Project-Deploy。 日常的查看/启停/改备注等简单操作不依赖本 SOP,直接按工具描述调用即可。
Bt Java Project Deploy
43aaPanel/btpanel-skills
在宝塔面板上部署 Java jar 项目(Spring Boot),并在项目启动失败时排错。 当用户要求把本机已有的 jar 包部署成面板可管理的 Java 项目(含 JDK、Nginx 代理/域名), 或 Java 项目启动失败/访问异常需要排查根因时使用。 触发关键词:部署 Java、jar 包部署、Spring Boot 部署、Java 项目创建、 Java 项目启动失败、jar 起不来、jar 启动报错、502、访问异常、JDK 版本不匹配。 日常的启停/状态/日志/改配置等简单操作不依赖本 SOP,直接按工具描述调用即可。
Timovi Devops
49theminimalcreator/timovi
DevOps for the Timovi project. Manages packaging, distribution, versioning, and release of the Timovi skill framework. Use when packaging the skill for distribution, managing version bumps, validating releases, or setting up distribution infrastructure.
Bt Reverse Proxy
43aaPanel/btpanel-skills
在宝塔面板上管理反向代理项目:创建反代站点(域名 + 目标上游)、查看/增删改 URL 级转发规则、 自由编辑 nginx 反代配置、改备注/启停/绑删域名/强制 HTTPS,并在反代访问异常(502/404/转发不生效)时排错。 当用户要求把某个域名/路径转发到后端服务(HTTP/HTTPS 或 unix socket),或反代站点访问异常需要排查时使用。 触发关键词:反向代理、反代、代理转发、proxy_pass、location 转发、域名转发到端口、nginx 反代配置、 反代 502、反代 404、转发不生效、BT-Reverse-Proxy。 日常的查看/启停/改备注等简单操作不依赖本 SOP,直接按工具描述调用即可。
Syncable Deploy Pipeline
43syncable-dev/syncable-cli
Use when the user asks to deploy through Syncable, ship to production, push to staging, run a deploy pipeline, or deploy a service with security checks first
Browse the most popular Claude skills, all devops & cloud skills, or write your own with the skills generator.