liuwudi123/dsh-lan-exposure

README 摘要

dsh-lan-exposure English 简体中文 · English version → 将 dsh 的 Web GUI 安全地暴露到局域网：手机、平板等同一 WiFi 下的设备可直接访问，并与电脑端实时同步。 dsh 出于安全考虑，其 Web 服务只监听 127.0.0.1 （回环地址，拒绝 0.0.0.0 ）。本插件在 dsh 进程 内部 启动一个反向代理，监听 0.0.0.0:8080 并将请求转发到 dsh 的回环端口 127.0.0.1:3080 ，从而让局域网设备可以访问。 特性 - 进程内反向代理 ：随 dsh 一起启动/停止，无需额外部署任何服务 - 实时同步 ：完整支持 WebSocket / SSE 升级，聊天、状态等实时数据在手机上同样流畅 - 实时连接指示器 ：页面右下角注入状态徽章，绿点表示已监听，并显示当前连接设备数（按 IP 去重） - 内置状态接口 ： GET /api/dsh-lan-exposure/status ，返回监听端口、目标地址与当前连接列表 - 兼容手机浏览器 ：自动注入 crypto.randomUUID polyfill，解决手机在非安全上下文（ http:// ）下的兼容问题 - 可选 Basic 认证 ：通过环境变量开启，防止同网段他人随意访问 - 零依赖 ：仅使用 Node.js 内置模块，随插件包加载，无 node modules 解析问题 工作原理 代理会重写 Host 与 Origin 请求头，让 dsh 的信任机制放行局域网设备；同时拦截 HTML 响应，注入连接状态徽章与兼容性补丁。 安装 在 dsh 仓库根目录执行： 启动 看到以下日志说明插件已激活： 从手机访问 1. 在电脑上打开命令行，执行 ipconfig ，找到 WLAN 下的 IPv4 地址 （例如 10.170.9.172 ）。 2. 手机连接 同一个 WiFi ，在浏览器打开 http:// :8080 （例如 http://10.170.9.172:8080 ）。 3. 手机与电脑在侧边栏打开 同一个会话 ，即可实时同步。 效果预览 手机通过 http:// :8080 访问 dsh 的效果——页面右下角会显示实时连接信息（绿点 = 已监听，含当前设备数）： 配置（可选） 所有配置通过环境变量读取（插件加载时一次性生效）： 环境变量 默认值 说明 DSH LAN ENABLED true 是否启用插件（设为 false 可关闭） DSH LAN PORT 8080 对外监听端口（手机访问的端口） DSH LAN LISTEN HOST 0.0.0.0 对外监听地址 DSH LAN TARGET HOST 127.0.0.1 dsh 回环监听地址 DSH LAN TARGET PORT 3080 dsh 回环端口（…

分类