dsh-web-auth
DSH Web 公网鉴权门：token 登录 + cookie 会话，反向代理到本机 DSH Web（含 WebSocket 透传）。零外部依赖，仅 node 内置模块。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:ChinaBoy0618/dsh-web-auth#fa2a0638c32347c420ed745689cf44d17dc3e819Web Auth 以 dsh-web-auth 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DSH Web 的公网鉴权门:一个跑在 DSH web 进程里的 loopback 反向代理(gate), 给经 frp/隧道暴露的 DSH Web 加 token 登录。
dsh web 只绑 127.0.0.1,其 /api 的 Host 信任栅栏把非 loopback 来源一律 403
(防 DNS-rebinding / cross-origin),所以经 frp 隧道进来的请求全部被栅栏拦下。--trusted-host <公网> 只是"给公网 IP 开栅栏缝",不等于认证。本插件把栅栏和认证合并成一个正确架构:
公网 → frp 隧道 → 127.0.0.1:3081 (gate, token 登录) → 127.0.0.1:3080 (DSH web, Host=loopback → 栅栏放行)
| 请求 | 结果 |
|---|---|
| 未登录浏览器 GET 页面 | 302 → /__dsh-auth__/login 登录页 |
未登录 /api、静态资源、WebSocket upgrade | 401 |
登录页 POST /__dsh-auth__/login(token 字段,JSON 或 urlencoded) | 成功:签 HttpOnly 会话 cookie(默认 12h,滑动续期),302 回原路径 |
X-DSH-Auth: <token> 头 | 免 cookie,供 curl / 脚本 |
POST /__dsh-auth__/logout | 清 cookie |
| 同源 IP 连续失败 10 次 | 限速 10 分钟 |
config.tokenDSH_WEB_AUTH_TOKEN$DSH_HOME/web-auth-token(默认 ~/.dsh/web-auth-token,可用 tokenFile 覆盖)找不到 token 时 gate 不启动(fail closed,公网入口不可用),DSH 本体不受影响。
| key | 默认 | 说明 |
|---|---|---|
gateHost | 127.0.0.1 | gate 绑定地址 |
gatePort | 3081 | gate 监听端口(frpc 应指向这里) |
targetHost | 127.0.0.1 | DSH web 地址 |
targetPort | 3080 | DSH web 端口兜底值(运行时优先取 webServer.port) |
token | — | 直接内联 token |
tokenFile | web-auth-token | token 文件名(相对 $DSH_HOME)或绝对路径 |
sessionTtlMinutes | 720 | 会话 cookie 有效期(分钟,滑动续期) |
maxFails | 10 | 同 IP 连续失败多少次触发限速 |
failWindowMs | 600000 | 限速窗口(毫秒) |
# 把本仓库地址装进指定 profile(命令透传给 pnpm,git 地址 / npm 包名 / 本地路径都认)
dsh plugin --profile web add <git 仓库地址>
然后在 profile 的 package.json 里把 dsh-web-auth 追加进 dsh.profile.bundles:
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"dsh-web-auth"
]
}
}
node_modules(file: 依赖 + pnpm install,或 npm publish 后按 npm 包名装)。package.json 里 dsh.profile.bundles 追加 dsh-web-auth。openssl rand -hex 32 > ~/.dsh/web-auth-token。dsh-web 的 localPort 指向 gatePort(3081)。dsh web。零外部依赖(只用 node 内置模块)。