@Casually

dsh-web-remote-frp

Name: dsh-web-remote-frp
Availability: InStock
Author: Casually

No description

Stars: 0
Language: JavaScript
Created: Aug 20, 2026
Updated: Aug 20, 2026

Auth

GitHub repo

Introduction

dsh-web-remote-frp

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

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

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

	dsh-web-remote	dsh-web-remote-frp（本插件）
公网通道	Cloudflare Quick Tunnel（cloudflared）	frp（frpc，自动探测 / 自动下载最新版）
公网地址	随机 `*.trycloudflare.com`，每次重启变化	固定：`http://服务器IP:端口` 或你的域名
需要	无需账号、无需服务器	一台有公网 IP 的服务器跑 frps
穿透模式	仅 HTTPS 隧道	`tcp`（远程端口直连）/ `http`（域名 + vhost）
其余功能	—	完全一致：局域网直连、token 鉴权、gzip、面板、QQ/微信机器人

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

功能亮点

功能	说明
🌐 frp 公网穿透	frpc 缺失时自动从 GitHub Releases 下载最新版；支持 tcp / http 两种代理模式
📡 局域网直连	HTTP + HTTPS 直连（HTTPS 自动生成自签名证书，零配置）
🔒 安全认证	每次启动生成随机令牌；HttpOnly Cookie；局域网可免 token
⚡ 性能加速	反向代理自动 gzip 压缩，大历史会话加载更快
📱 侧边栏图标	手机快捷按钮常驻侧栏，刷新不消失
🤖 微信机器人	iLink 协议直连微信，支持 AI 对话、会话控制、模型切换
💬 QQ 机器人	NapCat OneBot 11 反向 WebSocket（施工中）

🚀 快速开始

1. 准备 frps 服务器

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

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

# —— 仅 http（域名）模式需要下面两项 ——
# vhostHTTPPort = 80
# 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 外全部可选：

参数	默认值	说明
`frpServerAddr`	`''`	frps 服务器地址；留空则仅局域网可用
`frpServerPort`	`7000`	frps 的 bindPort
`frpAuthToken`	`''`	frps 的 auth.token
`frpProxyType`	`tcp`	`tcp`（远程端口）或 `http`（域名，frps 需开 vhostHTTPPort）
`frpRemotePort`	`3080`	tcp 模式下 frps 上暴露的公网端口
`frpCustomDomains`	`''`	http 模式的 customDomains（逗号分隔字符串或数组）
`frpSubdomain`	`''`	http 模式的 subdomain（frps 需配置 subdomainHost）
`frpSubdomainHost`	`''`	frps 的 subdomainHost（仅用于拼公网链接）
`frpVhostHTTPPort`	`80`	frps 的 vhostHTTPPort（仅用于拼公网链接）
`frpProxyName`	`''`	自定义代理名；留空随机生成（多机共用一台 frps 不冲突）
`frpcPath`	`''`	指定 frpc 路径；留空自动探测 PATH / 自动下载
`frpDownloadUrl`	`''`	自定义 frp 压缩包下载地址（设置后跳过 GitHub，直连该地址，适合内网 / 自建镜像）
`targetPort`	`3080`	DSH 自身端口
`httpPortStart`	`3081`	局域网 HTTP 起始端口（自动跳过占用）
`httpsPortStart`	`3082`	局域网 HTTPS 起始端口
`qqPortStart`	`3001`	QQ OneBot 桥起始端口
`pfxPath`	`''`	指定 PFX 证书；留空自动生成自签名
`pfxPass`	`''`	PFX 密码
`toolsDir`	`''`	工具与证书缓存目录；留空使用 `$DSH_HOME/tools`
`autoStart`	`true`	插件加载即自动启动
`lanOpen`	`true`	局域网免 token（私网来源放行；公网隧道仍要 token）

http（域名）模式示例

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

📱 使用方法

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

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

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

🤖 微信 / QQ 机器人

与原版一致：

微信（iLink 协议） — 面板「机器人」标签页扫码绑定，支持：

/链接 — 获取公网链接（未启动自动开启）
/停止远程 — 关闭远程服务
/会话列表 /选择 N /当前会话 /历史内容 — 会话管理
/当前模型 /切换模型 /选强度 N — 模型切换
直接发送内容 → 转发到选中会话并回传结果

QQ（NapCat OneBot 11 反向 WS） — 施工中，连接后可发「给我链接」取公网地址。

❓ 常见问题

Q: 面板提示"未配置 frpServerAddr"？ A: frp 不像 Cloudflare Quick Tunnel 有公共隧道，必须有自己的 frps 服务器。配置 frpServerAddr 后重启；配置前局域网直连仍然可用。

Q: frpc 自动下载失败？ A: 首次启动需要下载 frp 发行版（约 13MB）：默认直连 GitHub Releases，失败自动回退镜像（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: 局域网 HTTPS 提示"不安全"？ A: 自签名证书的预期行为，选择「继续访问」即可。

📄 License

MIT