用 1Panel 思路把服务器运维技能化：提示词 + 面板专属参考案例

一、和裸 SSH 技能的区别

通用 Linux 运维（清理 / 巡检 / 端口 / 部署）两套技能共用同一批脚本；1Panel 技能额外提供三个面板专属脚本：panel_inventory.sh（盘点）、panel_certs.sh（证书）、1panel_api.sh（REST API）。

二、提示词（触发 + 指令）

技能触发描述核心：

当用户要"盘点 1Panel 在管实体（网站/数据库/容器/备份/证书/暴露面）"“检查 SSL 证书到期”"通过面板 API 接管网站/数据库/容器"等需求时使用。

示例对话：

• “帮我盘点这台面板上跑了哪些网站和容器”
• “哪些 SSL 证书快到期了，提前告警”
• “别进网页了，用 API 把容器列表拉出来”

三、参考案例一：面板盘点和证书巡检（只读，可定期跑基线）

panel_inventory.sh            # 全景：面板版本/状态、网站+证书到期、数据库、容器、备份、暴露端口
panel_certs.sh --warn 45      # 自定义告警阈值(天)
# 输出样本：
#   [证书] example.com      剩余 12 天 ⚠️ 临期
#   [证书] api.example.com  剩余 180 天 ✅

⚠️ 面板服务名是 1panel-core / 1panel-agent，不是 1panel。systemctl is-active 1panel 会误报 inactive；正确写法 systemctl is-active 1panel-core。版本用 /usr/local/bin/1pctl version。这是技能里专门标注的易错点。

四、参考案例二：用 REST API 接管，不用进网页

1Panel v2 提供 /api/v2。先在面板"设置 → 安全 → API 接口"生成密钥，再：

export ONE_PANEL_TOKEN=<面板生成的密钥>   # 仅运行环境 export，不写进技能文件
1panel_api.sh health                    # 健康检查
1panel_api.sh dashboard                 # 实时监控（负载/CPU/内存）
1panel_api.sh apps                      # 已安装应用列表
1panel_api.sh get /api/v2/dashboard/current/node

鉴权是脚本自动派生的签名令牌（1Panel-Token = md5("1panel"+密钥+时间戳)），不是直接发密钥，窗口默认 120 分钟。默认连本机 127.0.0.1:面板端口，远程访问需改 host/port 且安全组限定来源 IP。

五、参考案例三：面板"孤儿规则"坑（1Panel + ufw 混用后遗症）

症状：在面板点删除防火墙规则，提示失败，但规则仍在生效。
根因：面板只管自己 DB 里记录的规则；用命令行 ufw deny from <ip> 直接加的规则，面板 DB 没有记录 → 删不了。
识别：

ufw status numbered
# # 1panel-rule:e43ececd-...   → 面板创建，能管
# # block-3xui-aliyun          → 命令行创建，面板不能管

修复用命令行按编号从大到小删。预防：1Panel 环境下要么全走面板，要么全走命令行，别混。

六、给你的启发

面板降低了运维门槛，但也引入"面板状态 vs 命令行状态不一致"的新坑。技能的价值之一，就是把这类"只有踩过才知道"的坑写进判读提示里。

【总结】 1Panel 运维技能 = 通用运维 + 面板专属三件套（盘点/证书/API）+ 孤儿规则等面板坑。参考案例表明：好的技能不只会执行，更会"提醒你哪里容易错"。