前言¶
本地开发机上的 Web 服务、SSH、NAS 或 webhook 回调，往往只能在内网访问。要临时或长期暴露到公网，常见做法是自建 frps、手写 frpc 配置、再记一套运维命令。步骤多、云厂商防火墙和备案又容易踩坑，对话里也很难一次说清「装什么、配哪几项」。
下面介绍 SkillHub 上的 frp-cli内网穿透（@user_2ea8b68d/frp-cli，v2.0.0）。它把 frp 内网穿透从首次安装 frp-cli、可选阿里云轻量与域名、部署 frps、连客户端、加第一条映射，到日常增删隧道、热重载、多 profile 切换等，收敛成一条可幂等执行的引导流程；已初始化环境会自动跳过安装与购机引导。
这是什么¶
frp-cli内网穿透 是社区来源（community）的 Agent Skill，分类为 it-ops-security，发布者为 user_2ea8b68d。标签标明 requires_api_key=false，不依赖额外 API Key。
定位可以概括为：围绕 frp / frp-cli 的「一站式」对话能力——既覆盖 NAT/反向代理场景下的 首次搭建，也覆盖 持续运维（隧道管理、体检、日志与 admin API 等）。底层工具链指向 Gitee 上的 frp-cli 二进制（官方说明含源码构建兜底）。
核心功能¶
以下能力均来自 SkillHub 官方简介，按阶段归纳。
首次使用（未初始化）¶
- 从
gitee.com/DYXZYT/frp-cli安装 frp-cli 二进制（必要时可走源码构建兜底）。 - 可选：选购阿里云轻量应用服务器与域名——含套餐选型、地域选择、ICP 备案说明。
- 配置阿里云控制台与系统 双层防火墙。
- 在云端 部署 frps 服务端。
- 本机 连接客户端（frpc 侧）。
- 按场景添加 第一条端口映射，官方列举场景包括：SSH、Web、RDP、MySQL、Minecraft、NAS、Webhook。
已初始化后的运维¶
Skill 会先检查初始化标记；若已存在，则 不重复 安装与购机引导，直接进入运维：
- 隧道的 新增 / 更新 / 删除
- 热重载
- 多 profile、多 frp 服务器切换（例如 dev 与 prod）
- xtcp / stcp 等 P2P 直连（visitor 侧能力在简介中一并提及）
- doctor 体检、status、logs
- admin API 透传
幂等与触发¶
每次进入 Skill 会检查 $FRP_HOME/.setup-done。文件存在则视为已初始化，跳过安装与阿里云 walkthrough。
对话中若出现下列意图或关键词，适合唤起该 Skill（节选官方列表）：
- 中文：「内网穿透」「NAT 穿透」「暴露本地服务到公网」「反向代理」「SSH 跳板」「公网访问家里 NAS / 路由器 / 摄像头 / 家里电脑」「webhook 本地调试」「我想做内网穿透但还没装 frp」「帮我搭一个 frps」「我刚买了阿里云想做穿透」「教我用 frp 暴露 SSH / Web / Minecraft」「新机器装 frp-cli」「切换 dev 和 prod 的 frp 服务器」
- 英文：「expose localhost」「tunnel localhost」
- 或直接提到 frp / frpc / frps / frp-cli
安装与启用¶
在 AI 助手中安装 Skill¶
SkillHub 页面给出的通用安装方式：让助手阅读官方安装说明，并按坐标安装本 Skill。可将下面提示词发给 Cursor、Claude Code 等支持 Skill 的客户端：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_2ea8b68d/frp-cli`。
具体子命令（如 npx skillhub 等）以 skillhub.md 为准；本文不展开各客户端差异，避免与文档版本不一致。
Skill 引导下的 frp-cli（运行时）¶
首次走完整流程时，Skill 会引导从 Gitee 安装 frp-cli，而不是让你自行拼凑 frpc 配置片段。安装源：
https://gitee.com/DYXZYT/frp-cli
初始化完成后，本机应出现 $FRP_HOME/.setup-done 标记；后续同一环境再次对话时，Skill 会据此判断并进入运维分支。
典型用法¶
下面用对话意图说明「第一次」和「日常」两条路径，便于对照官方行为。
路径一：从零穿透本地 SSH 或 Web¶
- 在助手已安装
@user_2ea8b68d/frp-cli的前提下，用自然语言说明目标，例如：「教我用 frp 暴露本机 SSH」或「webhook 本地调试需要公网回调」。 - 若
$FRP_HOME/.setup-done不存在，助手按 Skill 依次处理：安装 frp-cli →（可选）阿里云轻量与域名 → 防火墙 → 部署 frps → 连接客户端 → 添加对应场景的第一条映射。 - 若你已有公网 frps，可在对话中明确「已有服务器」，避免重复购机引导（仍以 Skill 实际检查标记为准）。
路径二：已初始化，只改隧道或换环境¶
- 说明运维动作，例如：「给 MySQL 加一条隧道」「删掉昨天的 Web 映射」「热重载配置」「从 dev 切到 prod 的 frp 服务器」。
- Skill 检测到
.setup-done后，应直接进入增删改、profile 切换、xtcp/stcp、doctor / status / logs 等运维能力，而不再走安装与阿里云首配。
路径三：排查与健康检查¶
需要确认客户端状态、日志或管理接口时，可在对话中要求 doctor、status、logs，或 admin API 透传——这些均在官方简介的运维能力范围内，由 Skill 调度 frp-cli 侧能力完成。
适用场景与注意¶
适合谁
- 需要在公网访问内网 SSH、Web、RDP、数据库、游戏端口、NAS 或 webhook 回调的开发者或运维。
- 希望用对话完成「买轻量 → 配防火墙 → 起 frps → 本机映射」整链，而不是分散查文档的人。
- 多台 frp 服务器或多环境（dev/prod）需要 profile 切换 与 热重载 的场景。
限制与注意
- Skill 侧重 frp-cli 工具链与上述流程；公网合规（如域名 ICP 备案）在首次引导中会提及，落地仍以阿里云与当地政策为准。
- 云资源费用、安全组规则、暴露端口带来的安全风险需自行评估；Skill 提供配置引导，不替代安全审计。
- 评分与下载量以 SkillHub 页面为准（截至资料抓取：评分 100000，下载 730 次）；与第三方转载数据不一致时，以 官方 Skill 页 为准。
结尾¶
frp-cli内网穿透 把 frp 内网穿透拆成「可幂等的首次搭建」和「可重复的运维操作」，并用 $FRP_HOME/.setup-done 避免重复装环境与重复购机说明。若你经常在对话里处理穿透、反向代理或 localhost 暴露，可按坐标安装后在真实需求里直接触发。
- SkillHub 页面：https://www.skillhub.cn/skills/user_2ea8b68d/frp-cli
- API 地址：https://api.skillhub.cn/user_2ea8b68d/frp-cli
- 安装坐标：
@user_2ea8b68d/frp-cli（v2.0.0）
