把 DSH Web 分享给指定的人——而不是整个网络。
这是一个 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH) 插件：在 DSH Web 前面放一层私有的零信任网关。调用方通过 Tailscale Serve、 Cloudflare Access，或（在 Headscale 上）私有 TCP Serve 前面的系统生成网关凭证 完成认证；一份私有允许名单决定谁能进来。没有用户自选密码要你管。 它**不是**内网穿透工具，也不替代 Tailscale / Cloudflare。它为你已有的 Tailscale / Cloudflare 内网穿透方案加上身份校验——自托管的访问控制，面向零信任 家庭实验室：能连上不等于被允许。 回环网关和 DSH 都只监听回环地址。受支持的入口（Tailscale Serve，带 Cloudflare Access 的 Cloudflare Tunnel，或 Headscale 上的 Tailscale TCP Serve） 只负责把请求送到本机。加入该私有网络 **从来不是**授权决定。任何请求在转发到 DSH 之前，都必须解析出一个明确的、在允许名单中的主体。 ```text 允许名单中的浏览器 ─ HTTPS ─> 入口（Tailscale Serve、Cloudflare Access， │ 或 Headscale TCP Serve） └─ 回环网关 ─> 本地 DSH 127.0.0.1:3088 127.0.0.1:3080 ``` **你得到的是：** DSH 前面的精确主体允许名单、仅回环的 HTTP/WebSocket 代理，以及 一条会预览计划并拒绝公开/匿名默认值的引导命令。只安装插件不会做任何事，直到你 运行 setup。 完整命令是 `dsh-one-gateway`；同时安装较短的 `dsh-gateway` 别名，方便输入。 ## 和同类插件的差别 其他 DSH 网关可能在回环之外监听、给 DSH 内部打补丁以便升级后门控覆盖仍穷尽， 或在 DSH 前面做反向代理。那些设计也可以覆盖 `/api` 和 WebSocket；差别不在谁 覆盖得更全。本插件是另一套约定：DSH 本身从不离开回环。 1. **私有网络成员身份从来不是授权。** 监听 `0.0.0.0`、把 RFC1918 当成放行，都 不在范围内。监听只在回环。同一 Wi-Fi、同一 tailnet 或同一 mesh，都不会让你 进来。 2. **失效关闭的 DSH 源。** DSH 只待在回环；它前面唯一的监听者是本网关。DSH 升级不会悄悄增加一条可从网外到达的路由——没有一张必须保持穷尽的门控路由表， 因为 DSH 一开始就不可从网外到达。全覆盖门控漏掉一条路由是静默绕过；本桥接 漏掉一条只是那条代理路径坏了，不会把 DSH 暴露出去。 3. **不给 DSH 核心或客户端库打补丁。** 有些门控靠给 DSH 的 HTTP 与 upgrade 入口打补丁来保持覆盖穷尽，并在每次升级后重新打上——因为上游变更会悄悄把 补丁冲掉。本网关是外部进程，从不改 DSH 自己的代码。 4. **对 Tailscale Serve 和 Cloudflare Access，身份来自入口本身——不是登录页、 密码或共享令牌。** 密码表单、共享令牌、会话 cookie 门是很大的认证面，也是 常见出 bug 的地方。这两种已交付模式使用 Serve 注入的 `Tailscale-User-Login`，或本地校验的 Cloudflare Access JWT。我们核对允许名单， 不让你自设密码。`gateway-credential` 是给没有原生身份的传输准备的、更小的 专用登录：系统生成的每主体凭证（不是用户自选密码）、只存校验值、有界的 `HttpOnly`/`Secure`/`SameSite=Strict` 会话、可单独吊销、限速但不永久锁定。 相对于典型的用户自选或共享密码，它在可猜测性、存储泄露和吊销范围上更强； 这不是“无密码”或“没有登录”，也不是宣称优于每一种密码或通行密钥。Headscale TCP Serve 是已交付、使用该模式的传输入口。对任何没有原生身份的纯传输入口， 约定都是：由产品自己把私有 overlay 桥接到不变的回环网关，用 `gateway-credential` 认证——绝不伪造身份头。 5. **一个插件、一条引导命令、一份允许名单。** 不必为每个入口单独搭一套。 Tailscale Serve、带 Access 的 Cloudflare Tunnel，以及 Headscale TCP Serve 共用同一个回环网关。新的入口是再加一个适配器，不是再做一个产品。 ## 明确不做 - 让 DSH 本身变成多租户，或降低允许名单用户的权限（每个被允许的主体都是完整的 DSH 管理员）。 - 把设备、节点或 mesh 成员身份当成人类身份。 - 提供可配置的通用反向代理，或任意可信任头名称。 - 支持公开匿名隧道、Funnel 或 Cloudflare quick tunnel。 - 管理入口级 ACL、DNS 区或账号策略。 - 卸载时自动删除持久化的入口路由。 - 接受用户自选密码。 - 在一个网关实例中同时运行多个入口。 - 防御恶意的本机管理员，或已经能读取 DSH 内存/配置、或能直连 DSH 回环的进程。 ## 受支持的入口 | 入口 | 认证模式 | 它证明的身份 | setup 实际做什么 | | --- | --- | --- | --- | | Tailscale Serve | `trusted-header` — Serve 注入登录头 | Serve 注入的精确 `Tailscale-User-Login`（会覆盖调用方自带值）。不是“tailnet 上的任何人”。 | 可以为你创建一条缺失的私有 Serve 路由（`routeManagement: ensure`），或只检查路由已经存在（`verify-only`）。 | | 带 Access 的 Cloudflare Tunnel | `signed-jwt` — 本地校验 Access 身份令牌 | 本地校验的 Access 身份 JWT（`Cf-Access-Jwt-Assertion`、RS256、issuer、audience、`email`、非空 `sub`）。不是方便邮箱头，不是 service token，也不是“主机名是私有的”。 | 你自己配置 Access 应用，并只转发到网关。setup 校验本地 JWT 设置（`routeManagement: verify-only`）；它无法独立证明 Access 仍附着在隧道上。 | | Headscale（经 Tailscale TCP Serve） | `gateway-credential` — 持有网关密钥 | 持有为该操作员签发的高熵网关凭证。TCP Serve 只提供私有可达性，没有 HTTP 身份头，也不能证明你是谁。 | 可以为你创建一条指向 `127.0.0.1:3088` 的缺失私有 TCP Serve 转发（`ensure`），或只检查它已经存在（`verify-only`）。证书和私钥由你提供。在 Tailscale.com 上，setup 会引导你走有身份的 Tailscale Serve，而不是这条更弱的路径。 | | EasyTier | `gateway-credential` — 持有网关密钥 | 持有为该操作员签发的高熵网关凭证。EasyTier 只提供传输。 | **尚未提供。** | 私有可达性不是授权。tailnet 成员、可从互联网路由到的 Cloudflare 主机名、或 mesh 对等节点都可以碰到端点，但若允许名单不匹配，仍会得到 403。 Cloudflare 细节：Access 保护的应用常常可以从互联网访问。未认证的包可以到达边 缘。受支持的形态是“身份门控的应用 + 网关强制本地 JWT 校验”，绝不是匿名公开隧 道。本地令牌校验是扎实的。网关无法在没有宽权限账号凭证的情况下机器证明 Access 仍附着在该隧道上；setup 会如实说明，并且仍然拒绝缺失或无效的 JWT。 ## 快速开始 需要可用的本地 DSH Web profile，以及 Node.js 20+（通常由 DSH 提供）。 1. **安装插件。** 这不会启动监听，也不会改入口状态。在你运行 setup 之前，什么 都不会暴露出去。 ```sh dsh plugin --profile web add -w /path/to/dsh-one-gateway ``` 2. **运行引导 setup，并确认显示的计划。** 在终端里省略 `--provider` 会打开菜单。Tailscale.com 上的操作员会被引导到 有身份的 Tailscale Serve；当现场节点在 Headscale 上时，才会列出 Headscale TCP Serve。检测到本地可执行文件只是提示；当恰好检测到一个入口时，它会成为 默认值——不是配置校验。传入 `--provider` 可跳过菜单。非交互 setup 在恰好 检测到一个入口可执行文件时仍会自动选择，否则必须提供 `--provider`。 Tailscale Serve： ```sh dsh plugin --profile web exec dsh-gateway -- setup --provider tailscale-serve ``` Cloudflare Access（你自己配置 Access；网关只在本地校验令牌）。你必须已经有 一个只转发到 `127.0.0.1:3088` 的 Access 应用： ```sh dsh plugin --profile web exec dsh-gateway -- setup --provider cloudflare-access \ --external-origin 'https://dsh.example.invalid' \ --team-origin 'https://team.example.invalid' \ --application-audience 'replace-with-access-application-audience' \ --trusted-principal 'email:operator@example.invalid' ``` 在 TTY 中，未提供的 Cloudflare 值会按此顺序交互收集：已有 Access origin、 团队 origin、应用 audience、受信任邮箱。无人值守的 `--yes` 仍必须提供全部 四个标志。setup 不会创建隧道、DNS 记录或 Access 应用。 Headscale TCP Serve（私有可达性加上系统生成的网关凭证；证书由你提供）。 在 Tailscale.com 上，setup 不会把它当作同等权重的菜单项： ```sh dsh plugin --profile web exec dsh-gateway -- setup --provider headscale-tcp-serve \ --tls-cert /path/to/dsh-one-gateway/cert.pem \ --tls-key /path/to/dsh-one-gateway/key.pem \ --credential-store /path/to/dsh-one-gateway/credentials.json \ --trusted-principal operator-1 ``` TCP Serve 不终止 HTTPS，也不证明身份。网关在 `127.0.0.1:3088` 上用你提供的 证书终止 TLS。客户端必须信任该证书；本轮不生成私有 CA。确认后，setup 签发 一份凭证，明文只显示一次，绝不写入 profile。`--print` 不会签发任何凭证。 确认后才会写入启用的 profile 条目。setup 不会猜测、杀死或重启你的 supervisor。请自行重启你已经在用的 DSH Web 进程。 3. **以允许名单中的主体打开配置的 HTTPS origin。** 3088 端口本身从局域网和 入口网络都不可达。 用 `--print` 只预览不写入。在 TTY 中，`--print` 仍可能询问入口和缺失值，但 绝不会写入 profile、入口资源或凭证。非交互 `--yes` 必须显式提供所有安全敏感 值。`--yes` 只跳过最后的写入确认，不会替你发明入口或 Cloudflare 参数。 ## 每种认证模式证明什么 这些 `auth.mode` 值就是 YAML 里的字面键。每一种都和固定的入口绑定，不能混用。 - **`trusted-header`（仅 Tailscale）。** Serve 恰好注入一个 `Tailscale-User-Login`，且该值在允许名单中，形式为 `login: