DSH Plugins
返回列表
🖥️

dsh-auth-cookie-guard

客户端 更新于 2026.11.03

在终端中运行以下命令:

dsh plugin install jitianjiyan/dsh-auth-cookie-guard

将以下提示词粘贴到 DeepSeek Harness 对话框中:

在 DeepSeek Harness 插件页执行安装,或使用命令安装源码仓库 https://github.com/jitianjiyan/dsh-auth-cookie-guard 对应的插件包 dsh-auth-cookie-guard。

插件介绍

如果你长期使用同一个 DSH 桌面 profile,可能会在某一天突然卡在欢迎页:日志里是「Web authentication failed」,换端口、撤销授权、重装都救不回来,只有整份 profile 换掉才行。根因并不在密钥或会话本身,而是每次启动都会在 127.0.0.1 上多留一条持久的 dsh-auth 启动 cookie,而 Node 默认的 HTTP 请求头上限只有 16 KiB;大约第 71 次之后,Cookie 头就会顶破上限,连接在解析层直接被 431 拒绝,应用层连清理的机会都没有,故障会永久累积。

dsh-auth-cookie-guard 在 Host 侧做两层互补防护:webServer 就绪后把监听器的 maxHeaderSize 提到 64 KiB,让每个请求有机会进入应用;同时在响应里按浏览器发送顺序,只保留最近若干条 dsh-auth 启动 cookie 以及当前端口对应的那一条,对其余同名 cookie 下发 Max-Age=0 的删除指令,分批收敛 jar,避免再次撞墙。插件只读 Cookie 头里的名字与顺序,不解码、不重签、不参与登录判断,认证仍由 DSH 原有签名校验负责。

适合已经遇到固定 profile「启动几十次后再也进不去」的用户,也适合希望提前避免同类累积问题的长期桌面使用者。若同一份 profile 同时跑多个 Host 实例,较旧实例的启动 cookie 可能被退休,需要重新走一次欢迎页握手;对外暴露非回环监听时,应配合反向代理或访问控制,或按需调低头部预算配置。

使用场景

  • 固定 userData 的桌面端连续启动数十次后卡在欢迎页且日志报 Web authentication failed
  • 重启、撤销授权或重装仍无法登录,只有更换整份 profile 才能恢复
  • 希望长期使用同一 profile 时避免 dsh-auth 启动 cookie 无限累积导致 HTTP 431

适合人员

  • 长期使用固定 profile 的 DSH 桌面用户
  • 已遇到约 72 次启动后永久无法进入桌面的用户
  • 需要在 Host 侧预防 Cookie 请求头超限的维护者