dsh-web-remote-frp

DSH 手机 / 外网远程访问插件 · frp 内网穿透版

复刻自 dsh-web-remote：公网通道由 Cloudflare Quick Tunnel 换成 frp（frpc → 你自己的 frps 服务器），速度、稳定性、域名都自己说了算。

✨ 与原版 dsh-web-remote 的区别

两个插件的 DOM id、HTTP 路由、localStorage 键全部不同前缀（frprm- / /frpremote/*），理论上可同时安装互不冲突。

功能亮点

🚀 快速开始

1. 准备 frps 服务器

在你的公网服务器上部署 frp（建议 ≥ 0.52，TOML 配置）：

# frps.toml
bindPort = 7000
auth.method = "token"
auth.token = "改成你自己的强密码"

# —— 仅 http（域名）模式需要下面两项 ——
# vhostHTTPPort = 80
# subdomainHost = "frp.example.com"

# —— 仅 https（域名 + 证书）模式需要 ——
# vhostHTTPSPort = 443
# subdomainHost = "frp.example.com"

./frps -c frps.toml

2. 安装插件

方式一：npm（推荐）

# 在 DSH profile 目录执行
cd $DSH_HOME/profiles/web
pnpm add dsh-web-remote-frp

方式二：GitHub 源码

cd $DSH_HOME/profiles/web
pnpm add github:Casually/dsh-web-remote-frp

pnpm 11 若因新包发布年龄校验报错，加 --config.minimumReleaseAge=0 重试。

然后在 profile package.json 的 "dsh.profile.bundles" 数组中加入 "dsh-web-remote-frp"，重启 DSH：

dsh web

方式三：手动 patch（免重启安装链路）

把本包放入 profile 的 node_modules，在 profile 的 cordis.patch.yml 追加：

- insert:
    - id: web-remote-frp
      name: 'dsh-web-remote-frp'

bundle 方式需重启 DSH；cordis.patch.yml 方式会被 HMR 热加载。

3. 配置 frps 地址

在 profile 的 cordis.patch.yml（或本包 cordis.patch.yml）里给插件加 config：

- insert:
    - id: web-remote-frp
      name: 'dsh-web-remote-frp'
      config:
        frpServerAddr: 'your.vps.example.com'   # frps 服务器地址（必填）
        frpServerPort: 7000
        frpAuthToken: '改成你自己的强密码'
        frpProxyType: 'tcp'      # tcp：远程端口模式（默认）
        frpRemotePort: 13080     # 公网访问端口

重启 DSH 后，侧栏出现「📱 远程frp」按钮 → 打开面板即可看到 http://your.vps.example.com:13080/?token=... 公网链接。

⚙️ 配置项

在插件行的 config 字段覆盖，除 frpServerAddr 外全部可选：

http（域名）模式示例

config:
  frpServerAddr: 'frp.example.com'
  frpServerPort: 7000
  frpAuthToken: '***'
  frpProxyType: 'http'
  frpCustomDomains: 'dsh.example.com'   # 该域名需解析到你的 frps 服务器
  frpVhostHTTPPort: 80

📱 使用方法

1. 启动后侧栏出现「📱 远程frp」按钮
2. 点击 → 面板显示运行状态、公网 / 局域网链接
3. 手机浏览器打开链接即可访问 DSH

公网：http://服务器:端口/?token=...（或你的域名） 局域网：https://192.168.x.x:3082（同 Wi-Fi；默认免 token）

公网访问始终需要 token；「换链接」会重新生成 token。frpc 掉线时面板会提示，点「停止」再「启动」即可重连。

🛠 面板「设置」页（免改 YAML 配置）

面板第四个标签页「设置」可直接填写并持久化配置：

• frps 连接：服务器地址 / 端口 / auth.token / 穿透模式（tcp、http、https）
• frp TLS 证书：frpc↔frps 隧道 TLS（开关 / 客户端证书 / 私钥 / CA / serverName）；https 模式访客侧证书（frps vhostHTTPSPort / 域名证书 / 私钥，支持粘贴 PEM 自动落盘）
• tcp 模式：公网端口；http 模式：自定义域名 / subdomain / vhostHTTPPort
• frpc 路径 + 一键下载 / 定位文件：点「一键下载」自动识别当前系统与架构（darwin / linux / windows × amd64 / arm64…），下载对应的 frp 最新版（自动解压）并自动填入路径；内置国内加速镜像（fengxiaozi，6 平台直链），下载源顺序：GitHub → 加速镜像 → ghfast；点「定位文件」一键在 Finder / 资源管理器中显示 frpc；若已存在 frpc（配置路径 / PATH / toolsDir）则直接复用，不重复下载
• 自定义下载地址：内网 / 自建镜像直连

点「保存并重启」后配置写入 toolsDir/frp-config.json 并立即重建隧道； 「清除本地配置」恢复为 cordis.patch.yml 中的值。

配置优先级：面板设置（frp-config.json）＞ cordis.patch.yml 的 config ＞ 内置默认值；面板中留空的项自动沿用 YAML 值。

分组折叠：设置项按「frp 服务器穿透 / frpc 与下载」分组，默认全部折叠，点开对应分组填写，面板不会一打开就很长。机器人通道凭据（纸飞机 / 钉钉 / 飞书 / 企业微信）已移到「机器人」标签页各通道详情里填写，设置页只保留 frp 相关配置。

🤖 机器人通道（6 通道统一命令路由）

面板「机器人」标签页选择通道，查看接入指引 / 回调地址 / 连接状态。所有通道共用同一套命令：

• /链接 — 获取公网链接（未启动自动开启）
• /停止远程 — 关闭远程服务
• /会话列表 /选择 N /当前会话 /历史内容 — 会话管理
• /当前模型 /切换模型 — 模型切换
• 直接发送内容 → 转发到选中 DSH 会话并回传 AI 结果
• 发送「帮助」查看全部命令

钉钉 / 飞书 / 企业微信的回调地址 = 公网链接 + /frpremote/bot/<通道>，面板通道详情页可一键复制；因此需要先启动远程服务（frp 隧道）。 所有通道均带消息去重（平台重试不会重复回复）。

❓ 常见问题

Q: 面板提示"未配置 frpServerAddr"？ A: frp 不像 Cloudflare Quick Tunnel 有公共隧道，必须有自己的 frps 服务器。在面板「设置」页填写 frps 信息并保存（或配置 cordis.patch.yml）；配置前局域网直连仍然可用。

Q: frpc 自动下载失败？ A: 首次启动需要下载 frp 发行版（约 13MB），下载源按顺序自动切换：① GitHub Releases 直连（最新版）→ ② 国内加速镜像（fengxiaozi，内置 6 平台直链，无需 GitHub API）→ ③ ghfast.top 代理。均失败时可手动下载 frp 发行版 中的 frpc 放入 toolsDir（默认 $DSH_HOME/tools），或配置 frpcPath / frpDownloadUrl（自建镜像）。

Q: 启动失败"auth token is incorrect"？ A: frpAuthToken 与 frps 的 auth.token 不一致。

Q: tcp 模式启动失败"start error"？ A: 多半是 frpRemotePort 在 frps 服务器上已被占用（或被 frps 的 allowPorts 限制），换一个端口。

Q: http 模式打不开？ A: 确认 frps 配置了 vhostHTTPPort、域名已解析到 frps 服务器、且 frpCustomDomains 与 frpc 配置一致。

Q: 开了 TLS 开关，公网地址怎么还是 http？ A: frpTlsEnable 及 transport.tls.* 证书只加密 frpc ↔ frps 之间的隧道（frps 后端看到的仍是 http 代理，这是 frp 的设计，TLS 在传输层不在代理层）。要让访客浏览器用上 https，请把「穿透模式」切换为 https，填好域名证书（frpHttpsCertFile / frpHttpsKeyFile，可直接粘贴 PEM），并确认 frps 配置了 vhostHTTPSPort。此时生成的 frpc 代理为 type = "https"，由 https2http 插件在 frpc 端终结 TLS。

Q: https 模式打不开 / 浏览器提示证书错误？ A: 确认域名已解析到 frps 服务器；frpHttpsCertFile 证书的 CN/SAN 与访问域名一致（通配符证书需匹配子域）；frps 已开启 vhostHTTPSPort 且防火墙放行该端口。

Q: 局域网 HTTPS 提示"不安全"？ A: 自签名证书的预期行为，选择「继续访问」即可。

📄 License

MIT