dsh-sakurafrp

DSH PLUGIN浏览器与联网

仓库 MentholTea/dsh-sakurafrp

浏览器与联网 未标注验证等级 安全审查:未标注 可信度:未标注 可安装插件
安装这个插件

在 dsh 设置页与侧边栏管理 SakuraFrp 内网穿透:托管 frpc、一键对齐端口、流量与剩余百分比、公网密码门。

一句话选型结论

按资料字段整理

dsh-sakurafrp 是浏览器与联网类的 DSH 可安装插件,未做沙盒验证,暂无安全审查结论,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类浏览器与联网 收录类型可安装插件 验证等级未标注验证等级 安全审查未标注
验证等级 UNKNOWN 未标注验证等级
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-10-30 创建于 2026-10-30
README 7.2 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:MentholTea/dsh-sakurafrp
  1. 1
    确认版本与运行环境

    仓库没有标注兼容版本与 Node.js 要求,先确认你的 DSH 版本能装,再继续。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本未标注版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名未发布到 npm可用 npm view 查看包信息

能做什么

浏览器与联网
字段来自项目仓库与公开索引,中文说明由本站标注

上游标签

cordisdeepseek-harnessdsh-pluginfrpnatfrpreverse-proxysakurafrptunnel

验证等级与安全审查

未标注验证等级
自动化流程结论,不是人工审核
验证等级未标注验证等级上游未给出验证结论,安装前请自行确认
安全审查未标注静态分析结论,未标注不代表已通过审查
仓库健康度未标注按仓库活跃度与最近更新时间给出
可信度未标注综合仓库活跃度与验证结果

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有可直接复制的安装命令,不用自己翻文档找入口。

先想清楚的地方

  • 安全审查还没结论,装之前先看仓库改了什么、要什么权限。
  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在浏览器与联网场景里给 DSH 补能力的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-sakurafrp当前 未做沙盒验证 未标注 0 未标注 有
dsh-our-free-model L3 · 安装规范通过 低风险 8,796 未标注 有
dsh-web L3 · 安装规范通过 低风险 8,549 未标注 无
BrowserSkill L4 · 沙盒安装通过 低风险 8,456 未标注 有
dsh-pocket L5 · 运行验证通过 低风险 1,656 0.2.0-rc.2 等 12 个 有
Browser4 L4 · 沙盒安装通过 中风险 1,152 未标注 有

仓库档案

浏览器与联网
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方MentholTea仓库 dsh-sakurafrp · 默认分支 master
分类浏览器与联网web-tools
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言未标注仓库主语言
许可证未标注商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-10-30 · 2026-10-30最后推送 2026-10-30
本站收录2026-10-30首次进入本站目录的时间

README 全文

7.2 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-sakurafrp

DeepSeek Harness 内建的内网穿透面板——替代 SakuraFrp 启动器。
同一台机器上装了本插件后,不需要再开 SakuraLauncher。

  • 设置页入口:设置 → 内网穿透 (SakuraFrp)
  • 侧边栏入口:左侧面板列表里的「内网穿透」,带三色状态点(🟢已连接 / 🟡未连接 / 🔴故障)
    和一键启停开关(🟢开 / 🔴关);折叠成图标栏时状态点回到图标右上角

架构

Web 设备 → xxx.nyat.app:端口 → SakuraFrp 节点 → frpc(本插件托管)
→ 127.0.0.1: 网关
├─ /natfrp/*  管理路由(仅本机)
├─ 密码门(HMAC cookie / ?gate=)
└─ Host 围栏反代 + WS 透传
→ 127.0.0.1: DSH WebServer

功能清单

  • frpc 全托管:DSH 启动即拉起、退出即停止、崩溃指数退避重连(1s→2s→…→60s 封顶)
  • 密钥零泄漏:token 经 NATFRP_TOKEN 环境变量传递,不出现在 argv / 进程列表
  • 隧道面板:API v4 拉取隧道列表(带节点名 + 在线状态),下拉直接切换
  • 一键对齐(autoAlign):启动前检查面板 local_port 是否等于网关端口,
    不等就先 POST /tunnel/edit 改掉——根治「隧道成功但访问 502」
  • 互踢检测:30s 窗口内断线 ≥6 次判定「疑似互踢」(SakuraLauncher 或其它机器
    连了同一条隧道),状态页醒目告警
  • 侧边栏状态点 + 开关:点管连通(绿/黄/红),开关管启停(红/绿),互不干扰;
    开关点击即时反馈(乐观更新),以服务端返回为准
  • 流量面板:本日已用 / 剩余流量 + 剩余百分比(绿→橙→红三档);
    百分比基于 data_plans 的真实总量,不是用「今日+剩余」硬凑的分母
  • 公网密码门:HMAC 签名 cookie、常量时间比较、按 IP 失败锁定(5 次锁 60s),
    登录页零外部依赖
  • Host 围栏反代:改写 Host/Origin/Referer/Sec-Fetch-Site 为回环权威,
    透传 WebSocket upgrade,注入非安全上下文 polyfill(crypto.randomUUID / AbortSignal.any)
  • DSH 二次认证:实时取 ctx.connection.authenticatedUrl() 的 launch token,
    首次 HTML 导航自动补 ?token=
  • 桌面/浏览器通吃:外链在 Electron 里走宿主内置浏览器标签,浏览器里走新标签页

安装

# 一条命令(desktop profile)
dsh plugin --profile desktop add dsh-sakurafrp -w

# web / CLI 场景把 --profile 换成你的 profile 名,例如:
# dsh plugin --profile web add dsh-sakurafrp -w

# 然后重启 DSH

装完还要做两件事(frpc 二进制不会被 npm 包携带):

  1. 下载 SakuraFrp 官方 frpc 放到 ~/.dsh/bin/frpc-standalone.exe
    (~/.dsh/bin/frpc-standalone 为非 Windows 平台),frpc -V 输出应含 sakura
  2. 重启 DSH → 设置页填访问密钥 → 下拉选隧道 → 设公网密码

> 想走源码:git clone https://github.com/MentholTea/dsh-sakurafrp.git 后把
> dependencies 写成 "dsh-sakurafrp": "link:<克隆目录绝对路径>",并加入
> dsh.profile.bundles,再 dsh plugin --profile desktop install。

frpc 可执行文件默认取 ~/.dsh/bin/frpc-standalone(.exe)(Sakura 官方分发版,
-V 输出应含 sakura)。

配置(cordis.patch.yml → config)

键 默认 说明
enabled true 插件启用(设置页可改,持久化到 state.json)
frpcPath ~/.dsh/bin/frpc-standalone(.exe) frpc 路径
tunnelId — 隧道 ID(设置页下拉选择后持久化)
tokenFile — 访问密钥文件(优先级最高;设置页写密钥即写此文件)
tokenRef NATFRP_TOKEN tokenFile 为空时走 DSH credentials
gatePort 3083 网关端口 = 隧道面板的「本地端口」
gatePassword — 公网密码;也可用设置页写(落 ~/.dsh/dsh-sakurafrp/gate-password.txt)
autoAlign true 启动前自动对齐面板 local_port
maxLogLines 500 日志环形缓冲行数

管理接口(本机 only)

GET  /natfrp/api/state     全量快照(frpc + 网关 + 隧道)
GET  /natfrp/api/tunnels   隧道列表(含节点名)
GET  /natfrp/api/user      账号信息
GET  /natfrp/api/logs      frpc 日志
POST /natfrp/api/start     启用并启动
POST /natfrp/api/stop      停止
POST /natfrp/api/align     一键对齐面板端口
POST /natfrp/api/config    更新配置 {enabled,tunnelId,gatePort,gatePassword,token}

公网侧访问 /natfrp/* 一律 403;只有密码门 + 反代暴露在公网。

首次使用

  1. 重启 DSH 后,设置页出现「内网穿透 (SakuraFrp)」区块
  2. 填 SakuraFrp 访问密钥(管理面板 → 用户信息 → 查看访问密钥)——落盘到本机文件,仅当前用户可读
  3. 下拉选择隧道(列表实时来自 SakuraFrp API v4)
  4. 设置公网访问密码(强烈建议 20 位以上随机串,不设则公网无认证直通)
  5. 手机访问隧道公网地址 → 输密码 → 完整 DSH 界面(WebSocket 流式同步)

证书警告与白屏问题(重要)

通过隧道默认域名(xxx.nyat.app)HTTPS 访问时,浏览器会提示证书不受信任;
部分浏览器在告警页选择继续后仍可能白屏。解决方法是绑定自己的子域名,
让 frpc 从服务端自动加载与域名匹配的证书:

  1. 到 子域绑定页面 申请/绑定子域名,
    并将记录关联到你的隧道
  2. 详细教程见官方文档:子域绑定指南
  3. 绑定完成后,用 你的子域名:远程端口 访问,证书正常加载、无白屏

插件设置页提供这两个页面的快捷跳转。

验证

五个离线测试脚本,不需要安装依赖、不需要真实密钥:

node verify.mjs        # 26 项:模块级 + 网关全链路(API 客户端 / frpc 解析 / 密码门 / 围栏 / WS 透传)
node scroll-test.mjs   # 14 项:主面板滚动容器链(外壳有界高度 → 内层可滚 → 无嵌套滚动)
node switch-test.mjs   # 11 项:侧边栏开关状态机(乐观更新 / 重渲染不被覆盖 / 连点保护)
node traffic-test.mjs  # 27 项:流量口径 + 剩余百分比(含流量包总量与退化路径)
node external-test.mjs # 21 项:外链打开策略(内置浏览器标签 / 退化 / 非绝对地址拒绝)

# 追加真实 API 冒烟(只读端点,会消耗一次 API 调用)
$env:NATFRP_TOKEN='你的密钥'; node verify.mjs

已知边界

  • DSH 关闭 = 隧道断开(frpc 生命周期与宿主绑定);需要常驻请另配系统服务
  • 同一隧道绝不能被两个客户端同时连接(互踢),本插件有检测但无法替你关掉另一端
  • 免费档:2 隧道 / 20 GB 每月 / 10 Mbps
  • API 写操作(edit/delete/create)走官方 OpenAPI,但官方对滥用有风控,别高频调用

License

MIT

常见问题

4 问
答案由本站依据条目字段整理,不引用上游原文
dsh-sakurafrp 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:MentholTea/dsh-sakurafrp` 即可。

dsh-sakurafrp 的验证等级是什么意思?

未标注验证等级。上游未给出验证结论,安装前请自行确认

dsh-sakurafrp 安全吗?

未标注。

dsh-sakurafrp 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

同名或近似条目

1 条
不同作者的仓库分开列,请确认你要装的是哪一个
浏览器与联网
按星标排序,可作替代方案

dsh-our-free-model

dsh-our-free-model

在 DeepSeek Harness 中装上这个 DSH plugin,无需登录、注册或填 API Key,即可直接调用 DeepSeek

L3 · 安装规范通过 8,796 星

dsh-web

dsh-web

侧边栏多列任务看板:卡片交给真实 DSH 智能体会话执行,支持 cron 定时(Host 侧到点执行,关浏览器也生效)。

L3 · 安装规范通过 8,549 星

BrowserSkill

BrowserSkill

BrowserSkill 的 DeepSeek Harness 浏览器自动化桥接插件,通过原生浏览器工具控制可见的 Chrome 和 Edg

L4 · 沙盒安装通过 8,456 星

dsh-pocket

dsh-pocket

DSH Pocket 让 DeepSeek Harness 装进口袋:电脑跑 dsh web,手机扫码即实时同步访问(局域网+公网),人在外

L5 · 运行验证通过 1,656 星

Browser4

Browser4

L4 · 沙盒安装通过 1,152 星

agentrq

agentrq

L4 · 沙盒安装通过 1,140 星

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 —。