本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-full-remote

— 源: plugin_wiki.wiki_content

安装与验证

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

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• settings.*
• credentials.*
• host.listDirectory
• 转发前将 Host、Origin 改写为 127.0.0.1，使特权接口通过 Harness 的信任校验；
• 任何请求都须先通过访问令牌或设备会话校验；

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件解决的是什么问题？

DSH 默认只在回环地址放行特权接口（设置、凭据、目录浏览），公网隧道或局域网访问时会被 403 拦截；插件在隧道和 Web 服务之间插入鉴权代理，改写请求头让特权接口继续可用，并自己提供访问控制。

必须用 Cloudflare 快速隧道吗？

不是。快速隧道只是面板里的一键选项，适合临时共享或救急；日常使用建议把已有的 cloudflared 命名隧道、ngrok、frp、SSH、Tailscale 指向代理监听的 127.0.0.1:3081，或者把监听地址改成局域网 IP 让手机走 WiFi。

快速隧道每次启动 URL 都变吗？

是的。trycloudflare.com 临时隧道每次启动随机分配地址，旧的邀请链接和已登录的设备会话都会失效。要稳定地址请用 named tunnel 或自建隧道。

可以只在局域网使用，不暴露公网吗？

可以。把监听地址从 127.0.0.1 改成局域网 IP（如 192.168.x.x），手机在同一 WiFi 内直接访问；面板里可复制的「隧道目标」就是该地址。

怎样卸载？

从 cordis.patch.yml 里删除 dsh-full-remote 对应的两层（reverse-proxy 插入和 directory-picker 行），重启 dsh web；状态文件 $DSH_HOME/reverse-proxy.json 可保留也可手动删除。

远程打开设置页保存设置报「settings are unavailable in this browser」怎么办？

升级到 DSH 0.1.1-rc.1，插件已在客户端页面引导里钉住 isLoopback。0.1.0-rc.8 起的官方 ModuleLoader create() 替换了 load，插件已适配该版本，但更早版本会触发该报错。

多设备同时登录会被互相踢下线吗？

不会。每个设备登录后获得独立的设备凭据和会话 cookie，状态文件里只保存哈希；最多 16 台设备同时在线（可调），超过会淘汰最久未活跃的一台。

头像/图片从手机粘贴会被 413 拒绝吗？

不会。默认请求体上限 160 MiB，与 DSH Web /api 桥保持一致，远程粘贴 deepseek-v4-flash-vision-exp 图片走同一条已认证 /api 路径不会被代理拦截。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.1.0-rc.5 <0.2（已在 0.1.1-rc.1 验证，需 web profile）
• Node: ^22.19.0 || >=24.0.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则