dsh-remote-tunnel-easy
为 DeepSeek Harness 提供便捷的远程访问：通过 cloudflared 快速隧道，并在 Settings → Plugins 页面显示可扫描的二维码和设置。零运行时依赖，无数据库，无 Firebase。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Raiyan007-gb/dsh-remote-tunnel-easy#17e06a1e87c22dad2b838934bd3175c83d45ba79Remote Tunnel Easy 以 dsh-remote-tunnel-easy 发布，当前版本为 1.4.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Open your DeepSeek Harness session on your phone — by pointing the camera at it.
Scan the QR in Settings → Plugins and the harness opens in your phone's
browser, inside the session you are already working in. Same workspace, same
chat. No typing a URL. The dsh web terminal prints nothing.
⚠️ Renamed from
qrcode-hassle-free— previouslyRaiyan007-gb/dsh-qrcode-hassle-free(npmqrcode-hassle-free). Nowdsh-remote-tunnel-easy(Raiyan007-gb/dsh-remote-tunnel-easy, npmdsh-remote-tunnel-easy@1.4.2). If you installed the old name, migrate first — remove the old bundle, then add the new one.
A one-command DeepSeek Harness web bundle that brings QR-based remote
handoff to the Settings page. It starts a cloudflared quick tunnel, loops
your phone into the exact session the desktop is using, and draws the QR code
plus settings right next to your other plugins — no terminal noise, no
database, no Firebase, no app install.
cloudflared, and downloads it (SHA-256 verified) when missingcloudflared path, and session handoff from the page| Question | Answer |
|---|---|
| What is it? | A dsh bundle that shows a scannable QR code and access link in the Settings page, so a phone opens the harness inside the active session. |
| Who is it for? | Anyone running dsh web who wants their phone on the same session without typing tunnel URLs and tokens. |
| What do I get? | A loopback edge proxy, a cloudflared quick tunnel, same-session handoff, and a live QR + settings card in Settings → Plugins. |
| What does it run on? | Windows, macOS, and Linux — anything dsh runs on. |
| Is cloud required? | No account or signup. cloudflared is used, and auto-downloaded on first run when missing; the tunnel is public, and the token in the link is the gate. |
Run dsh web once so a profile exists — that is the only prerequisite.
cloudflared is no longer something you install by hand: on first tunnel start
the bundle probes your PATH, and when no cloudflared is found it downloads
the official pinned binary (SHA-256 verified), caches it under your user cache
directory, and reuses it from then on. Prefer your own install? Put it on
PATH, or set the cloudflared path field in the card to an absolute path —
an explicit path disables both probing and downloading.
The simplest path — install from the npm registry with the plugin name:
dsh plugin --profile web add dsh-remote-tunnel-easy@latest --config.minimumReleaseAge=0
The --config.minimumReleaseAge=0 flag bypasses pnpm's ~24-hour release-age
gate, so a freshly published version installs immediately. Without it, a plain
dsh plugin --profile web add dsh-remote-tunnel-easy still works but may hold off
until the freshness window lapses.
Or, if you prefer, install straight from the GitHub repository URL:
dsh plugin --profile web add https://github.com/Raiyan007-gb/dsh-remote-tunnel-easy
For a local checkout instead, clone it and add the folder:
git clone https://github.com/Raiyan007-gb/dsh-remote-tunnel-easy
dsh plugin --profile web add \./dsh-remote-tunnel-easy
These initialize the profile if needed, link the package, and register the
bundle. No build step — the package ships plain ESM with zero runtime
dependencies (the QR encoder and cloudflared resolver are vendored in-tree),
so add and remove stay fast and never run install scripts.
Security note: installing from a git URL asks for permission to run the package's install scripts. This package has none (plain ESM, no
postinstall), but pin a commit —#<sha>on the URL — to freeze what runs. To skip install permissions entirely,pnpm packa tarball anddsh plugin --profile web add ./dsh-remote-tunnel-easy-1.1.0.tgz.
Then restart dsh web — the QR and settings appear on Settings →
Plugins → DSH Remote on every start.
On every dsh web start the bundle:
Host and Origin
to the loopback authority. This is what makes the harness's /api
browser-trust fence accept tunneled traffic — the fence requires
Origin == Host, and a phone's Origin is the tunnel hostname, which
--http-host-header rewriting alone can never satisfy. Without the proxy
the app loads but every API call 403s.cloudflared — the configured cloudflared path override, else a
binary on PATH, else a pinned download (2026.8.2) SHA-256 verified and
cached under the user cache directory. It then spawns
cloudflared tunnel --no-autoupdate --url http://127.0.0.1:<proxy-port>
pointed at that proxy.https://<name>.trycloudflare.com URL.authenticatedUrl — the same mint the console line prints)./api call for the seed itself./remote-handoff route as a fallback entry path:
same seeding, then the normal token→cookie login (SHA-256 constant-time
compare). Prefix-matched, so /remote-handoff and /remote-handoff/ both work.remote-handoff settings namespace and a loopback-only bridge
(/api/dsh-remote-handoff-settings). The card in Settings → Plugins →
DSH Remote reads the tunnel status (QR matrix + access link) from that
bridge and draws them in the page, alongside the editable tunnelTarget /
cloudflaredPath / sessionHandoff settings. The Regenerate button
restarts the tunnel in place for a brand-new URL on the same session, and an
empty tunnel target auto-fills the harness's own loopback address. The
dsh web terminal prints nothing.cloudflared install — downloaded automatically when missing
(Windows x64/x86, macOS Intel/Apple Silicon, Linux x64/arm64); any other
platform needs a cloudflared on PATH or an explicit cloudflared path.dsh runsqrcode-hassle-freePreviously this plugin was named qrcode-hassle-free (Raiyan007-gb/dsh-qrcode-hassle-free on GitHub, qrcode-hassle-free on npm). It is now dsh-remote-tunnel-easy (Raiyan007-gb/dsh-remote-tunnel-easy, dsh-remote-tunnel-easy@1.4.2). The old npm package is unpublished.
If you installed the old name, remove it first, then add the new one and restart dsh web:
dsh plugin --profile web remove qrcode-hassle-free
dsh plugin --profile web add dsh-remote-tunnel-easy@latest --config.minimumReleaseAge=0
Restart dsh web — the QR and settings now appear under Settings → Plugins → DSH Remote as before.
dsh plugin --profile web remove dsh-remote-tunnel-easy
and restart dsh web.
MIT — use it, modify it, ship it. See LICENSE.
If you use dsh-remote-tunnel-easy in your research or project, please cite:
@software{dsh_remote_tunnel_easy,
title = {dsh-remote-tunnel-easy: Hassle-free remote tunnel for DeepSeek Harness},
author = {Raiyan},
url = {https://github.com/Raiyan007-gb/dsh-remote-tunnel-easy},
year = {2026},
version = {1.4.2}
}
Built for the DeepSeek Harness — scan, open, keep working.