dsh-remote-plugin

DSH Remote 的 DSH bundle 插件：在 DSH 左侧原生边栏注册入口，点击从右侧滑出管理抽屉；插件内置网关程序并随 DSH 自动启停（独立 systemd 单元），抽屉直显令牌、主机 IP 与设备监控，配合 dsh-Remote 的 Android App 实现手机远程操控与文件互传（/fs/list、/fs/file、/fs/upload）。

安装

dsh plugin --profile web add dsh-remote-plugin
# 或 pin 版本
dsh plugin --profile web add dsh-remote-plugin@0.5.0

重启 DSH Web 后 Ctrl+F5，左侧边栏底部出现 App 图标入口。

git 源安装（等价）：

dsh plugin --profile web add "github:Blank-not-black/dsh-remote-plugin#main"

网关

• 默认自动启动：DSH 启动或抽屉刷新时，插件会拉起内置 gateway.cjs（0.0.0.0:8787），独立于 DSH 进程。
• 开关持久化在 ~/.dsh-remote/gateway.enabled；抽屉内可停止/启动。
• 令牌在 ~/.dsh-remote/token（首次自动生成，重复使用不覆盖），抽屉里显示并可复制；支持二维码扫码配对与一键轮换。
• 环境变量 DSH_REMOTE_AUTOSTART=0 可关闭自动管理。
• 文件端点：/fs/list（列目录）、/fs/file（下载，支持 Range）、/fs/upload（分块续传，支持暂停/取消，落盘前 SHA-256 校验）；默认根目录 ~，DSH_REMOTE_FS_ROOT 可开多根（: 分隔）。

手机 App

从 Releases 下载 dsh-remote.apk。推荐在抽屉点「二维码」，App「设置 → 扫码连接」直接配对；也可手动添加多个服务器地址（局域网 + Tailscale），点「测速」自动选最快。聊天记录会本地缓存，断网也能看历史；下载的文件统一放系统「下载/dsh-remote」。

License

MIT