跳到正文

Blank-not-black/dsh-Remote

30最近提交 2026年8月16日

dsh-Remote DSH 插件

DSH Remote 是一个 DSH 插件，包含内置网关和安卓 App（Capacitor 混合应用，不是 PWA）。它允许你远程管理 DSH 会话、审批工具调用、提问，以及传输最大 2GB 的文件，支持断点续传和 SHA-256 完整性校验。网关随 DSH 自动启停，提供基于令牌的管理面板，可通过浏览器或手机 App 访问。

remote-executionui-productivity

如何安装 dsh-Remote DSH 插件

dsh plugin --profile web add dsh-remote-plugin

复制不会执行命令。安装 dsh-Remote DSH 插件前请核对仓库和版本。

dsh-Remote DSH 插件数据来源

dsh-Remote DSH 插件快照日期：2026年8月16日

discovered

dsh-Remote DSH 插件能做什么

  • 远程会话管理：从手机 App 查看、创建和交互 DSH 会话
  • 文件传输最大 2GB，支持分块续传、暂停/继续/取消，以及 SHA-256 完整性校验
  • 多服务器自动切换：添加多个地址（局域网/Tailscale），App 自动选择最快的
  • 离线缓存：网关断线时会话列表和历史仍可离线浏览
  • 令牌认证与二维码配对：扫码快速设置服务器地址和令牌
  • 网关自愈：网关崩溃后自动重启，也可从抽屉手动停止/启动

dsh-Remote DSH 插件适合哪些场景

  • 离开电脑时，在手机上批准 DSH 的工具调用
  • 将手机照片或文件直接传输到服务器
  • 在外出时通过局域网或 Tailscale 监控和控制 DSH 会话
  • 网关暂时不可用时，离线查看会话历史与目标

dsh-Remote DSH 插件适合谁

  • 需要在安卓手机上远程管理 DSH 的用户
  • 需要在大文件传输中支持断点续传和完整性校验的用户
  • 经常需要远离主电脑时审批工具调用的用户

dsh-Remote DSH 插件的限制

  • 仅支持安卓 App（无 iOS 版）；手机浏览器也可访问网关，但功能有限
  • 需要 DSH（web 配置）正在运行；网关依赖 DSH Web 进程
  • 令牌安全：任何拥有令牌的人都能控制 DSH，必须妥善保管
  • 文件传输根目录限于配置的目录（默认 ~）；路径穿越和符号链接逃逸被禁止

dsh-Remote DSH 插件的仓库 README 摘录

以下文字摘自 dsh-Remote DSH 插件的上游仓库 Blank-not-black/dsh-Remote 的 README，版权归原作者，仅作引用。

> **口袋里的 DSH 控制台** —— 手机远程会话 · 审批 · 提问 · 文件互传，局域网 / Tailscale 都能用 **中文** · [English](README.en.md) [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) [![npm](https://img.shields.io/npm/v/dsh-remote-plugin)](https://www.npmjs.com/package/dsh-remote-plugin) [![Release](https://img.shields.io/github/v/release/Blank-not-black/dsh-Remote?label=release)](https://github.com/Blank-not-black/dsh-Remote/releases/latest) [![Stars](https://img.shields.io/github/stars/Blank-not-black/dsh-Remote)](https://github.com/Blank-not-black/dsh-Remote) [![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE) [![Platform](https://img.shields.io/badge/platform-Android%20%7C%20Linux%20%7C%20Windows-blue)](#) 躺床上也能批准 DSH 的工具调用、随时查看会话、把手机照片直接传进服务器——**安卓 App（Capacitor 混合应用，含相机原生插件），不是 PWA 网页套壳**。 **插件 + 内置网关 + 手机 App 是一个整体**：装插件时网关随插件分发、随 DSH 自动启停，抽屉里直接拿到令牌和主机地址，手机 App 填上即可远程操控 DSH。 ## ✨ 亮点 | | | | --- | --- | | 📱 **安卓 App（Capacitor）** | 不是 PWA 套壳：会话 / 审批 / 提问 / goal / 文件互传，一个 App 全搞定 | | 🔐 **自愈网关** | 插件内置网关随 DSH 自动启停，挂了自动拉起；Bearer token 鉴权，谁拿 token 谁操控 | | 📦 **2GB 文件互传** | `/fs/*` 直连传输，**断点续传** + 暂停/继续/取消 + **SHA-256

阅读完整 README仓库许可: MIT

dsh-Remote DSH 插件常见问题

如何安装 DSH Remote？

在 DSH 终端中运行 `dsh plugin --profile web add dsh-remote-plugin`，然后重启 DSH Web 并强制刷新浏览器（Ctrl+F5）。左侧边栏会出现 DSH Remote 入口。从 Releases 页面下载安卓 App 以获得完整的移动端体验。

如何将手机连接到网关？

安装插件后，打开浏览器侧边栏中的 DSH Remote 抽屉，点击二维码按钮生成配对二维码。在安卓 App 中进入设置 → 扫码连接，扫描二维码即可自动配置服务器地址和令牌。也可以手动输入令牌和主机 IP。

文件传输大小有限制吗？

默认上传上限为 2GB。可以通过设置环境变量 `DSH_REMOTE_FS_MAX_UPLOAD`（单位字节）来增加。注意手机 App 的上传可能受设备存储和网络条件限制。

文件传输安全吗？

所有文件传输都通过 Bearer 令牌认证。网关使用 SHA-256 对上传的分片和最终文件进行完整性校验。如果通过互联网远程访问，建议使用 Tailscale 加密隧道。令牌应妥善保管，因为任何人持有令牌都能控制 DSH。

网关停止工作怎么办？

网关具有自愈功能：崩溃或 DSH 重启后会在几秒内自动重启。你可以在抽屉中手动停止/启动它。如果自动重启被禁用，请检查环境变量 `DSH_REMOTE_AUTOSTART` 是否设置为 0。同时检查令牌文件 `~/.dsh-remote/token` 以及防火墙是否放行了 8787 端口。