Bt Reverse Proxy
在宝塔面板上管理反向代理项目:创建反代站点(域名 + 目标上游)、查看/增删改 URL 级转发规则、 自由编辑 nginx 反代配置、改备注/启停/绑删域名/强制 HTTPS,并在反代访问异常(502/404/转发不生效)时排错。 当用户要求把某个域名/路径转发到后端服务(HTTP/HTTPS 或 unix socket),或反代站点访问异常需要排查时使用。 触发关键词:反向代理、反代、代理转发、proxy_pass、location 转发、域名转发到端口、nginx 反代配置、 反代 502、反代 404、转发不生效、BT-Reverse-Proxy。 日常的查看/启停/改备注等简单操作不依赖本 SOP,直接按工具描述调用即可。
Install
npx skills add aaPanel/btpanel-skills --skill bt-reverse-proxygit 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-reverse-proxy ~/.claude/skills/bt-reverse-proxyPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# 反向代理项目运维 SOP > **停止。执行任何操作前,必须完整阅读本文档。** > 本 Skill 的工具均指 bt_agent_mcp 插件暴露的 MCP 工具;同一能力在宝塔 AI 内置端可能有不同命名,按当前环境可用工具调用。 > 本 SOP 覆盖三个主场景:**① 创建反代项目;② 编辑/增删 URL 转发规则(自由配置);③ 反代访问异常排错**。其他简单操作(状态查看、启停、改备注、绑删域名、强制 HTTPS、删除)不做 SOP,直接使用工具。 --- ## 核心规则 1. **先只读侦察,再执行变更** —— 操作前先 `ProxyProjectInfo`(site_name 留空)列项目找到站点名(可能带 `_<端口>` 后缀),再 `ProxyProjectInfo(site_name=...)` 看当前规则/域名/端口/SSL;排错先读日志,不盲目重写配置。 2. **反代项目 = sites 行 + 反代 JSON** —— 真正的配置在 `/www/server/proxy_project/sites/<name>/<name>.json`(`proxy_info[]` 多条 URL 规则);nginx conf 由它渲染。**改配置必须走 MCP 工具**(ProxyWriteConfig),保持 JSON 与 nginx 同步。 3. **URL 规则增删改走自由配置** —— 不要期待 add/set/del_url_proxy 之类的工具(未提供)。改规则 = 读 conf → 改 location 块 → `ProxyWriteConfig` 回传完整 conf → `Bash` `nginx -t` 验证。**面板保存后会自动把 proxy_info/域名/端口同步回反代 JSON。** 4. **改配置三步走**:`ProxyProjectInfo` 拿 `config_file` 路径 → filesystem `Read` 读当前 conf 作基线 → 修改后 `ProxyWriteConfig(conf_data=<完整 conf>)` → `Bash` 执行 `nginx -t` 验证。**改前必须 Read 留基线**,写坏可恢复。 5. **域名增删走 `ProxyProjectModify`** —— 用 comMod 的方法(会同步反代 JSON);**不要用通用网站域名工具**(不更新反代 JSON,面板会不同步)。至少保留一个域名。 6. **创建即生效** —— `ProxyProjectCreate` 成功即写 nginx + 放行防火墙 + 重载服务;返回的 `site_name_hint` 是主域名小写形式,**实际站点名以 `ProxyProjectInfo` 列表返回的 name 为准**(非 80 端口会带 `_<端口>`)。 7. **每个任务最多调用 15 次工具**,超出后汇总当前发现并停止。 8. **禁止操作**:`rm -rf` 反代站点根目录外的路径、修改宝塔/插件自身文件、读取插件 `data/` 凭据、直接用 filesystem Write 覆盖反代 nginx conf(必须走 ProxyWriteConfig 保持 JSON 同步)。
Details
- Skill name
bt-reverse-proxy- Repository
- aaPanel/btpanel-skills
- Path
assets/bt-skills/bt-reverse-proxy/SKILL.md- License
- MIT
- Repo updated
- 21 August 2026
FAQ
What does the Bt Reverse Proxy skill do?
在宝塔面板上管理反向代理项目:创建反代站点(域名 + 目标上游)、查看/增删改 URL 级转发规则、 自由编辑 nginx 反代配置、改备注/启停/绑删域名/强制 HTTPS,并在反代访问异常(502/404/转发不生效)时排错。 当用户要求把某个域名/路径转发到后端服务(HTTP/HTTPS 或 unix socket),或反代站点访问异常需要排查时使用。 触发关键词:反向代理、反代、代理转发、proxy_pass、location 转发、域名转发到端口、nginx 反代配置、 反代 502、反代 404、转发不生效、BT-Reverse-Proxy。 日常的查看/启停/改备注等简单操作不依赖本 SOP,直接按工具描述调用即可。
How do I install the Bt Reverse Proxy skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add aaPanel/btpanel-skills --skill bt-reverse-proxy. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Bt Reverse Proxy 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,直接按工具描述调用即可。
Bt Website Troubleshoot
43aaPanel/btpanel-skills
诊断并修复 bt panel 网站访问异常和服务启动失败问题。 当用户报告以下问题时使用此技能:网站无法打开、403/404/500/502/503 错误、 空白页/白屏、数据库连接错误、nginx 或 php-fpm 启动失败、 服务启动失败但没有明确原因,或任何网站宕机/访问被拒绝问题。 触发关键词:网站宕机、网站打不开、网站无法访问、502、 500、403、404、空白页、白屏、nginx 错误、php-fpm 错误、启动失败、 数据库连接失败、连接被拒绝、连接数过多、访问被拒绝、 网站不可达、服务不可用、错误网关、网站异常。
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.
R00 Travisvn Awesome Claude Skills Devops
36TopCoppersmithRuin/r09-travisvn-awesome-claude-skills-devops
☁️ DevOps & Cloud Infrastructure skill suite derived from travisvn/awesome-claude-skills. CI/CD pipelines, container orchestration, IaC, monitoring and incident response. Provides 10 specialised commands for devops, cloud, docker workflows.
Browse the most popular Claude skills, all devops & cloud skills, or write your own with the skills generator.