xchannel1987/dsh-reverse-proxy-xc

中文 | English

DSH 局域网反向代理插件 —— 让手机/平板等设备在局域网内无缝访问 DSH Web GUI，获得与本地完全一致的体验。

DSH 0.1.7 兼容（>=0.1.7-rc.1）：0.1.7 起设置接口与客户端设置服务均有 breaking 变更（ctx.settings.register 移除、settingsScope 更名 configForms），本版本已完整适配： 设置入口位于「设置」页的「局域网反向代理」分区；保存后经控制路由 /api/dsh-reverse-proxy-xc/control 立即热启停代理（含端口/认证变更）。

✨ 核心特性

🌐 完整功能访问

• 侧边栏可用：工作区、会话列表正常显示
• 设置面板：可访问所有设置项
• 凭据管理：可管理 API 凭据
• WebSocket 支持：实时事件推送正常工作

🔧 问题修复

本插件修复了通过反向代理访问时的关键问题：

问题	原因	解决方案
设置面板无法打开	前端判断非回环环境禁用	代理层注入 isLoopback=true
randomUUID 报错	HTTP 下 API 不可用	自动注入 polyfill
WebSocket 断开	代理未正确转发	流式透传支持
提示 authentication required	移动端访问缺少启动 token 凭证	自动换取并注入合法 session cookie (bypassToken)

🚀 技术实现

• 独立服务：默认监听 0.0.0.0:3090
• 请求转发：转发到 DSH 主服务 127.0.0.1:3080
• Header 改写：改写 Host/Origin 为回环地址
• HTML 注入：自动注入必要的 polyfill

🔒 安全设计

• 局域网限定：仅在内网/VPN 环境使用
• 信任栅栏：保留 DSH 原有安全机制
• 配置可控：默认禁用，需手动开启

📦 安装

# 使用 DSH CLI
dsh plugin --profile web add dsh-reverse-proxy-xc

# 或使用 npm
npm install dsh-reverse-proxy-xc

安装后重启 DSH。

⚙️ 配置

1. 打开 DSH 设置
2. 找到「局域网反向代理」分区
3. 打开「启用代理」开关
4. 配置端口（默认 3090）

配置选项

选项	默认值	说明
enabled	false	是否启用代理
port	3090	监听端口
host	0.0.0.0	监听地址
bypassToken	true	免 Token 认证（反代流量自动注入本机凭据，手机访问免输启动 Token）
authEnabled	false	是否启用访问认证（Basic）
authUser	admin	认证用户名
authPass	123456	认证密码

🎮 使用

1. 确保目标设备与主机在同一局域网或 VPN
2. 在目标设备浏览器访问：

http://<主机内网IP>:3090

例如：http://10.100.50.125:3090

3. 享受与本地 http://127.0.0.1:3080 完全一致的体验

🔧 工作原理

手机浏览器
    ↓ HTTP/WS
反向代理 (0.0.0.0:3090)
    ↓ 改写 Header
DSH 主服务 (127.0.0.1:3080)
    ↓ 视为回环访问
完整功能解锁

⚠️ 安全注意

• 不要暴露到公网：此插件设计用于可信内网环境
• VPN 推荐：跨网访问建议使用 VPN
• 敏感操作：涉及凭据和设置，请确保网络安全

📄 许可证

MIT

🔗 链接

• GitHub
• npm
• 问题反馈