2. 前置配置（开放外部监听）

由于 DSH 默认仅监听 127.0.0.1，为了使 Tailscale 私网或局域网设备能够正常连通，请确保在 ~/.dsh/profiles/web/cordis.patch.yml（Windows 对应 C:\Users\\.dsh\profiles\web\cordis.patch.yml 或在资源管理器直接输入 %USERPROFILE%\.dsh）中包含以下配置：


### 3. 启动并使用

```bash
dsh web --no-open

启动后，在电脑浏览器打开 DSH Web 控制台，进入 设置 ⚙️ -> 远程与移动端，使用手机微信或系统相机扫描二维码即可立即开启移动端接入！

设置面板按 「接入 / 设备与安全 / 样式覆写 / 本地数据」 四个页签分组显示，避免长页面；页签选择会被记住，切换不重置配对码等状态。

⚙️ 高级配置

插件已完全接入 DSH 官方 Settings 体系，配置项支持在 Web 界面中直观调整，也可在 ~/.dsh/settings.yaml 的 dsh-remote-mobile 命名空间下手动修改：

dsh-remote-mobile:
  allowTailscale: false       # boolean，默认 false：是否允许 Tailscale 虚拟私网免密访问
  allowLan: false             # boolean，默认 false：是否允许局域网免密访问（高危警示）
  secretHash: ""              # string，默认空：长期访问密码的 scrypt 加盐哈希值
  maxVisitsPerMinute: 60      # number，默认 60：单 IP 每分钟最大访问登录页次数
  maxFailedAttempts: 5        # number，默认 5：触发封禁的连续认证失败最大次数
  lockDurationMs: 900000      # number，默认 900000 (15分钟)：IP 锁定持续时间（毫秒）

🎨 移动端样式片段（可选）

自定义样式片段（样式小插件）与启停状态持久化于 ~/.dsh/remote-mobile/style-snippets.json，可在设置面板图形化管理，也可直接编辑该文件：

{
  "version": 2,
  "presetStates": {
    "preset-sidebar": { "pc": false, "mobile": true },
    "preset-settings": { "pc": false, "mobile": true },
    "preset-main": { "pc": true, "mobile": true }
  },
  "custom": [
    {
      "id": "custom-xxx",
      "name": "我的样式小插件",
      "css": "html[data-dsh-mobile] .我的选择器 { ... }",
      "pcEnabled": false,
      "mobileEnabled": true
    }
  ],
  "customOrder": ["custom-xxx"]
}

所有启用片段会拼接为单个 `` 注入主页面与 /auth 登录页，生效与否由视口宽度决定：mobileEnabled 的片段包在 @media (max-width: 900px)（≤900px 生效，PC 拉小窗口同样生效），pcEnabled 的片段包在 @media (min-width: 901px)（宽视口生效），两端都开则全宽度生效（v1 旧格式自动迁移，presetStates 按三个预设分组齐全落盘）。注意：PC 开启侧边栏抽屉预设会改变桌面布局，如不想用可关闭该预设的 PC 开关。

dsh-remote-mobile

설치

문서

2. 前置配置（开放外部监听）

⚙️ 高级配置

🎨 移动端样式片段（可选）