# @goodandready/dsh-lanmode 中文文档

规范地址：https://npmcn.com/package/%40goodandready/dsh-lanmode/

版本：0\.8\.60
npm 元数据更新时间：2026-11-13T12:11:27.089Z
中文译文更新时间：2026-11-16T19:12:34.792Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40goodandready/dsh-lanmode
原文对照：https://npmcn.com/package/%40goodandready/dsh-lanmode/?lang=original
项目主页：https://github.com/GooDAnDReaDY/dsh-lanmode
源码仓库：https://github.com/GooDAnDReaDY/dsh-lanmode

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：524 kB，65 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- peer 依赖：@deepseek-ai/cordis ^4\.0\.1，@deepseek-ai/dsh-host-webserver ^0\.1\.7-rc\.2 \|\| ^0\.2\.0-rc\.1
- 首次发布：2026-08-20T16:33:26.547Z
- 最新版本发布：2026-11-13T12:11:26.920Z
- 近 30 天下载量：5079（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：104（近 12 个月 104 个）

## 中文简介

用于DeepSeek Harness Web UI的局域网和倒置代理访问:返回非本地主机的页面上的设置服务,在Web API中填写浏览器在平原HTTP上所扣留的浏览器,并且可以打开自己的收听器,因此不需要其他内容. 要求 D

## 安装

```sh
npm install @goodandready/dsh-lanmode
```

也可以使用：`pnpm add @goodandready/dsh-lanmode`、`yarn add @goodandready/dsh-lanmode`、`bun add @goodandready/dsh-lanmode`

## README

# 📦 @goodandready/dsh-lanmode

### 局域网访问 (LAN)、mDNS (dsh.local)、PWA、Root CA、快速二维码、后台推送与自动 TLS 支持 (DeepSeek Harness)

[![npm version](https://img.shields.io/npm/v/@goodandready/dsh-lanmode.svg?style=flat&color=6366f1)](https://www.npmjs.com/package/@goodandready/dsh-lanmode) [![license](https://img.shields.io/badge/License-MIT-10b981.svg?style=flat)](https://npmcn.com/package/%40goodandready/dsh-lanmode/LICENSE)

[**🇬🇧 English**](https://npmcn.com/package/%40goodandready/dsh-lanmode/README.md) • [**🇷🇺 Русский**](https://npmcn.com/package/%40goodandready/dsh-lanmode/README.ru.md) • [**🇨🇳 中文说明**](https://npmcn.com/package/%40goodandready/dsh-lanmode/README.zh.md)

* * *

## ⚡ 功能概览

`dsh-lanmode` 为 DeepSeek Harness 提供完整的局域网与外网安全访问支持：

1.  **📱 Quick QR 快速二维码**：侧边栏底部 (`Quick QR` 位于 `sidebar.footer` / `sidebar.rail`) 提供纯 SVG 二维码弹窗，支持移动端扫码即连。终端支持 `/mobileqr` 工具与 ASCII 二维码输出。
2.  **📲 PWA 与独立应用模式**：提供 `manifest.json`，iOS/Android 全屏独立模式与刘海屏安全边距 (`viewport-fit=cover`)。
3.  **🌐 自动 mDNS (`dsh.local`)**：内置 UDP 5353 responder，自动在局域网广播 `dsh.local`。
4.  **🔐 本地 Root CA 与 HTTPS**：生成 10 年有效期的本地根证书及带 SAN 的服务器证书。访问 `/dsh-lanmode/ca.crt` 即可一键下载信任。
5.  **🔔 后台通知 (Web Notifications API)**：在后台标签页接收回合结束与审批请求系统推送。
6.  **🛡️ 安全与认证体系**：
    -   登录密码支持纯文本与 scrypt 密钥派生，使用 `timingSafeEqual` 进行恒定时间比较防时序攻击。
    -   LAN PIN 验证：支持纯文本与 `PBKDF2` 强哈希（`pbkdf2$sha512$100000$salt$hash`）。5 次失败自动锁定 15 分钟。
    -   设备与会话 Token 均采用 `SHA-256` 哈希加盐存储。
    -   子网角色分离（`adminAllow` 与 `guestAllow`），访客子网禁止改写系统设置。
7.  **☁️ Cloudflare 隧道与 Tailscale Funnel**：
    -   支持临时 `Quick Tunnel` (trycloudflare.com) 与固定 `Named Tunnel` 模式（Token 通过 `TUNNEL_TOKEN` 环境变量传递，不暴露在进程列表）。
    -   配置项 `tunnelPin` 强制外网访问通过 LAN PIN 鉴权。
    -   支持一键开启 `Tailscale Funnel`，自带权威 Let's Encrypt 证书。
8.  **📱 设备与会话管理**：自动识别连接设备型号与操作系统，支持一键撤销单个或全部其它会话。

* * *

## 📦 安装方法

```bash
dsh plugin --profile web add @goodandready/dsh-lanmode
```

* * *

## ⚙️ 配置说明 (`cordis.patch.yml`)

```yaml
- id: dsh-lanmode
  config:
    mode: direct
    directPort: 3080
    tunnel: off              # off, quick 或 named
    tunnelPin: true
    tailscaleFunnel: false
    passwordAuth: false
```

* * *

## 📄 开源许可证

MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)

## 常见问题

### @goodandready/dsh-lanmode 是什么？

用于DeepSeek Harness Web UI的局域网和倒置代理访问:返回非本地主机的页面上的设置服务,在Web API中填写浏览器在平原HTTP上所扣留的浏览器,并且可以打开自己的收听器,因此不需要其他内容\. 要求 D

### 如何安装 @goodandready/dsh-lanmode？

在项目目录运行 npm install @goodandready/dsh-lanmode，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@deepseek-ai/cordis（^4\.0\.1）、@deepseek-ai/dsh-host-webserver（^0\.1\.7-rc\.2 \|\| ^0\.2\.0-rc\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @goodandready/dsh-lanmode 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/goodandready\_\_dsh-lanmode 是否存在。

### @goodandready/dsh-lanmode 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @goodandready/dsh-lanmode 可以商用吗？

@goodandready/dsh-lanmode 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @goodandready/dsh-lanmode 的下载量有多少？

根据 npm 官方下载统计，@goodandready/dsh-lanmode 在 2026/10/17 – 2026/11/15 这 30 天内被下载 5,079 次，日均约 169 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @goodandready/dsh-lanmode 还在维护吗？

最新版本 0\.8\.60 发布于 2026/11/13（3 天前）；至今共发布 104 个版本，其中过去 12 个月发布了 104 个；首次发布于 2026/08/21。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

