dsh-proxy

面向使用者的快速上手与下载指引见 GUIDE.md（项目简介、下载地址、快速开始）。

HTTP + WebSocket 反向代理：把局域网端口转发到本地 DSH 服务 127.0.0.1:3080。 支持 Basic Auth、局域网访问、crypto.randomUUID polyfill 注入。

项目包含两个等价的实现版本，功能完全一致（交互式启动、配置记忆、CLI 免交互参数）：

目录	语言	单文件体积	说明
node/	Node.js（SEA 打包）	83-119 MB	原版；用 Node 官方 SEA 打包，无需安装 Node
go/	Go（静态编译）	6-7 MB	轻量版；Go 标准库实现，体积小 95%，推荐

功能

• HTTP + WebSocket 反向代理（Go 版用标准库 httputil.ReverseProxy，原生支持 WS 升级）
• Basic Auth（默认 admin/admin，HTTP 与 WS 握手统一校验）
• Origin 对齐 + Host 改写（通过 DSH /api 同源校验，LAN 访问 WS 不 403）
• HTML 注入 crypto.randomUUID polyfill（LAN 非安全上下文下实时通道可用）
• 交互式启动：4 项配置预填可编辑（源端口 3080 / 目标端口 3081 / admin / admin），端口与账号密码均可手动修改
• 配置记忆：config.json 存于可执行文件同目录，下次启动自动预填
• CLI 免交互参数（供计划任务/自动化）： dsh-proxy --source-port 3080 --target-port 3081 --user admin --pass admin

构建

# Node 版（产物在 node/dist/）
cd node
npm install
npm run build          # 全部 5 个平台（首次需下载 Node 二进制，之后缓存于 .sea-cache/）
npm run build:win      # 只构建 Windows

# Go 版（产物在 go/dist/，无需安装 Go 运行时）
cd go
./build.ps1            # 全部 5 个平台
./build.ps1 -Target win-x64

产物清单（两个版本各 5 个平台：win-x64、linux-x64、linux-arm64、macos-x64、macos-arm64）：

• Node 版：dsh-proxy-<平台>（如 dsh-proxy-win-x64.exe）
• Go 版：dsh-proxy-go-<平台>（如 dsh-proxy-go-win-x64.exe，避免与 Node 版同名）

macOS/Linux 版传到对应系统后先 chmod +x。

启动横幅显示的版本号在打包时注入：CI 自动取标签版本（如 v1.1.0）； 本地构建可用 -Version（Go）或 --version（Node）指定，缺省取最近 git 标签。

自动发布

推送 v* 标签（如 v1.1.0）即触发 GitHub Actions，同时构建 Node 版和 Go 版 并发布到 GitHub Release（含 SHA256SUMS.txt 校验和）；也可在 Actions 页面手动触发：

git tag v1.1.0
git push origin v1.1.0

工作流见 .github/workflows/release.yml。

验证

# 免交互启动（示例端口 3091）
./dsh-proxy-win-x64.exe --source-port 3080 --target-port 3091 --user admin --pass admin

# 无凭据 → 401；带凭据 → 200
curl -i http://127.0.0.1:3091/
curl -u admin:admin http://127.0.0.1:3091/

# WebSocket 握手 → OPEN
node -e "const ws=new WebSocket('ws://127.0.0.1:3091/api/events.mux',{headers:{Authorization:'Basic '+Buffer.from('admin:admin').toString('base64')}});ws.onopen=()=>{console.log('OPEN');ws.close()}"