dsh-tunnel-preview

DSH PLUGIN浏览器与联网

仓库 SOVLOOKUP/dsh-tunnel-preview

浏览器与联网 L4 · 沙盒安装通过 安全审查:低风险 可信度:银 可安装插件
安装这个插件

dsh-tunnel-preview 是 SOVLOOKUP 维护的 浏览器与联网 类 DSH 可安装插件, 仓库为 SOVLOOKUP/dsh-tunnel-preview,许可证 MIT。 下面按「装什么、怎么装、验没验过、跑起来要注意什么」逐项列出。

一句话选型结论

按资料字段整理

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

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

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:SOVLOOKUP/dsh-tunnel-preview#v0.2.0
  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 查看包信息

能做什么

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

上游标签

cloudflare-tunneldeepseek-harnessdsh-pluginport-previewpreview

验证等级与安全审查

L4 · 沙盒安装通过
自动化流程结论,不是人工审核
验证等级L4 · 沙盒安装通过安装命令在隔离沙盒内真实执行成功,无依赖错误
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度银综合仓库活跃度与验证结果

选择建议

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

值得选的地方

  • 验证等级 L4:在沙盒里真实装过,依赖能装上,不是纸面声明。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-tunnel-preview当前 L4 · 沙盒安装通过 低风险 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 未标注 有

仓库档案

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

README 全文

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

dsh-tunnel-preview

给 agent 一把「开/关公网入口」的钥匙:把容器里正在监听的端口登记成
https://<端口>.<你的域名>,用完自己注销。复用已有的 Cloudflare 命名隧道,
不新增对外端口、不需要人来改配置。

它做三件事

  1. 反代:插件监听 127.0.0.1:9999(listen 可改),隧道的 catch-all 指向它;
    它按 Host 里的端口号把请求转发到 127.0.0.1:<端口>。HTTP 与 WebSocket(HMR)
    走同一条路径,所以改代码的热更新在公网链接上也是通的。
  2. 登记表:只有登记过的端口才会被转发,登记表落盘在 stateDir/previews.json,
    宿主重启不丢。没登记的端口 403,登记完注销立刻恢复 403。
  3. 闸门:URL 不带 token 打不开(容器内直连 127.0.0.1 除外)。用
    ?dp_token= 验一次就换成一个域级 Cookie,
    之后所有端口子域都免 token,浏览器里点一次就够。

工具

工具 作用
preview_register({ port, label? }) 建 DNS 记录(API 优先,退回 CLI)+ 入登记表,返回可直接打开的链接
preview_unregister({ port }) 出登记表,公网入口立刻 403;绑定了 API token 时顺带删 DNS 记录
preview_list() 列出所有登记项:端口、公网地址、本地服务还在不在听

登记前服务必须已经在听(插件读 /proc/net/tcp{,6} 的 LISTEN 套接字判断),
否则登记出来的链接是 502——先起服务,再登记。

GUI:右侧栏「服务」标签与快捷入口

插件为 DSH Web 界面提供了内置伴生前端:

  1. 右侧栏「服务」标签(Services Tab):
    - 位于 DSH 右侧栏标签页,图标为专用服务/网络地球标;
    - 服务卡片一览:实时展示所有通过隧道暴露的端口、备注、公网域名与创建时间;
    - 在线状态检测:动态检测本地端口监听状态(🟢 正常监听 / 🔴 端口未监听);
    - 一键快捷操作:
    - 🚀 新标签打开:浏览器新窗口直接打开免密分享链接;
    - 🌐 侧栏并排预览:与内置浏览器标签页联动,在右侧栏内并排预览;
    - 📋 复制链接:带弹性动效与“已复制 ✓”浮动反馈;
    - 🗑️ 注销服务:一键安全注销并切断公网访问(若绑定 Cloudflare Token 则自动清理 DNS 记录);
    - 快速暴露新端口:支持自动探测容器内当前正在监听的本地端口(如 :3000、:8000),支持一键快速暴露;
    - 隧道与 DNS 状态:底部常驻提示 Cloudflare 隧道连接状态与 API 绑定情况。
  2. 会话顶栏快捷入口:
    - 会话右上角工具条常驻「暴露的服务」图标按钮,点击直接展开右侧栏并聚焦到「服务」标签。
  3. REST API 扩展:
    - GET /api/tunnel-preview/services:获取当前暴露服务、候选端口与隧道状态;
    - POST /api/tunnel-preview/register:动态暴露端口 { port, label };
    - POST /api/tunnel-preview/unregister:动态注销端口 { port }。

配置

见 cordis.patch.yml,全部有默认值:

键 默认 说明
listen 9999 反代监听地址,必须与隧道 config 的 catch-all 一致
domain example.com 子域后缀(主域名)。设置页「公网域名」可改,保存立即生效
stateDir $HOME/devpreview token、previews.json 落盘目录
tunnelName dsh-dev cloudflared tunnel route dns 用的隧道名
cloudflared $HOME/bin/cloudflared 可执行文件
tunnelConfig $HOME/.cloudflared/config.yml 隧道 config
manageTunnel true 托管 cloudflared 进程:宿主退出一起走,崩了自动重连(最多 5 次)
manageDns true 登记时自动建 CNAME(已存在视为成功)
deny VNC/调试端口 永不公开的端口
rewriteHost true 改写 Host/Origin/Referer,避免 dev server 的 host 校验拦截
cookieMaxAge 2592000 域级 Cookie 有效期(秒)
minPort 1024 允许公开的最小端口
cloudflareApiToken 空 粘贴即绑定:插件自己校验 token、自己找 zone,之后 DNS 记录能建也能删。字段是 secret + volatile:读回不回显明文,保存只热更新、不重挂插件
cloudflareZoneId / cloudflareAccountId 空 一般留空,自动探测
dnsOnUnregister delete 注销时的 DNS:delete 删(需已绑定 token)/ keep 留

用哪个域名

预览地址是 https://<端口>.。域名不写死在代码里,在插件设置里改:

  1. 打开 DSH 侧栏 → 插件 → tunnel-preview。
  2. 在表单最上面的 「公网域名」 填主域名,不要带 https:// 和端口,例如 example.com。
  3. 点 保存。domain 是 volatile 字段:宿主只更新这一项并重跑绑定,不重载插件。已填 token 时会按新域名重新查 zone。

出厂默认是插件自带 cordis.patch.yml 里的 domain: example.com。如果在 profile 的 cordis.patch.yml 里给 tunnel-preview 写了 config,loader 是整对象覆盖:那一份里的 domain 才是初始值,插件自带的这份不再生效。之后仍以设置页保存的值为准。

在设置里一键绑定 Cloudflare

不绑定也能用:建记录走 cloudflared tunnel route dns,只是删不掉。要让插件自己管 DNS:

推荐方式:官方模板一键直达(免手动勾选权限)

  1. 进 DSH 侧栏 → 插件 → tunnel-preview,点击设置表单上的 「⚡ 直达 Cloudflare 生成 Token ↗」,或直接打开预置权限直达链接:
    > Cloudflare API Token 预填创建页
    (已自动预选好 Zone → DNS → Edit 与 Zone → Zone → Read 权限,名称预设为 DSH-Tunnel-Preview)
  2. 页面底部点击 Continue to summary → Create Token
  3. 点击 Copy 复制生成的 Token,回到 DSH 插件设置页粘贴并保存即可!

保存即热生效(不重挂插件):宿主只更新 domain 和那三个 Cloudflare volatile 字段并重跑绑定。preview_list() 顶部会显示
Cloudflare API:已绑定(zone example.com …);失败也在这里写明原因
(token 无效 / 缺 Zone.Zone Read / 网络不通),不会静默降级。

表单只认四个顶层字段(domain / cloudflareApiToken / cloudflareAccountId / cloudflareZoneId)。
旧的嵌套 cloudflare: { apiToken, accountId, zoneId } 仍能被读到,但只要 patch 里写过任一
平铺字段,就以平铺为准。token 落在 profile 的 patch 里,字段标了 role('secret'):
设置页与远程调用方读回时是占位符,不回显明文。

绑定后行为变化:

  • preview_register 直接打 API 建记录,不再依赖 ~/.cloudflared/cert.pem;
  • preview_unregister 顺手删掉记录(dnsOnUnregister=delete),公网零残留;
  • 记录已存在但指向别的隧道时不覆盖,如实报错——不静默改别人的解析。

已知取舍

  • DNS 记录删不删,看有没有绑定:未绑定 API token 时建记录只能走 CLI,于是只建不删
    (留着无害,通不通由登记表决定);绑定后默认 dnsOnUnregister=delete,注销即清干净。
  • DNS 失败不阻塞登记表:建/删记录是尽力而为。Cloudflare API 打不通时,登记照做、
    注销照做(登记表里删掉那一行,公网立刻 403),只是 tool 输出与 GUI 会明说「记录没删掉」。
    早先的版本在这里会直接抛错,导致点「注销服务」整条链中断——看着就是「点了没反应」。
  • 容器里的 HTTPS_PROXY 会掐掉 api.cloudflare.com:开了 NODE_USE_ENV_PROXY=1 的
    宿主里,fetch 与核心 http/https 都会走 HTTPS_PROXY;白名单式代理对 Cloudflare API
    常常直接断 TLS(fetch failed / socket disconnected before secure TLS connection),
    而直连 CF 边缘是通的。所以 API 客户端在代理失败时会用 agent: false 直连重试一次
    (见 makeCfClient)。
  • 公网可见:这是真的公网入口,token 只挡「猜不到」的人。要让陌生人彻底进不来,
    应在 Cloudflare 侧加 Access 策略,而不是依赖这里的 token。
  • 只支持一级子域:5173.example.com 可以,5173.dev.example.com 不行
    (Universal SSL 只覆盖一级子域,二级要付费 ACM)。

迁移自手写脚本

这套逻辑原先散在 /workspace/devpreview/{dispatcher.mjs,start.sh,addport.sh}。
装插件前先停掉旧栈,否则 9999 被占:

/workspace/devpreview/start.sh stop

之后 dispatcher 与 cloudflared 都由插件托管,addport.sh 的职责换成
preview_register 工具。旧的 .token 继续被复用,已发出去的链接不会失效。

测试

node --check index.js && node --test test/
  • test/host.test.mjs:纯函数(Host 解析、端口白名单、cookie、隧道 UUID、schema 兜底)
  • test/cloudflare.test.mjs:本地起一个 Cloudflare API 桩,跑绑定、建记录幂等、指向冲突、
    删记录、缺隧道 UUID —— 不碰真 Cloudflare,也不要求有 token

常见问题

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

在 DSH 里执行 `dsh plugin --profile web add github:SOVLOOKUP/dsh-tunnel-preview#v0.2.0` 即可。

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

L4 · 沙盒安装通过。安装命令在隔离沙盒内真实执行成功,无依赖错误

dsh-tunnel-preview 安全吗?

低风险。

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

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

dsh-tunnel-preview 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

浏览器与联网
按星标排序,可作替代方案

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 星

SOVLOOKUP 的其它插件

3 个

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