mervyn-teo/dsh-plugin-qr-connect
DeepSeek Harness dynamic plugin: QR-code sidebar button for connecting mobile devices to the web UI
QR-code remote access for the DSH Web UI: adds a QR button above the Settings button in the sidebar footer; click it to get two QR codes — local network (http://<lan-ip>:<port>/?auth=<secret>) and public internet (blue) — so a phone on the same network or the internet can open the web UI securely. The reverse proxy validates the secret, issues a session cookie (default 30 days), and forwards HTTP + WebSocket to the loopback UI. The secret rotates every 30s by default (configurable; 0 disables) and the QR refreshes to match. Settings card configures port, session length, and refresh interval. EN/zh UI.
Install
dsh plugin --profile web add github:mervyn-teo/dsh-plugin-qr-connectGitHub install per README: dsh plugin --profile web add github:mervyn-teo/dsh-plugin-qr-connect, then restart dsh web — host bundles load at boot. Persistent bundle plugin (host half + browser half). Defaults (port, sessionDays, refreshSeconds, publicHost) live in cordis.patch.yml and are editable from the settings card.
Compatibility
DeepSeek Harness web profile. Auth-gated reverse proxy child node process on 0.0.0.0:<port> forwarding to the loopback web UI including WebSocket upgrades.
Details
- Repo: mervyn-teo/dsh-plugin-qr-connect
- Category: Web UI Enhancements
- Stars: 3
- Version: GitHub source (no npm package)
- Last push: 2026-08-24
- First seen: 2026-08-14
Recent updates
QR button + dual codes; rotating-secret reverse proxy; session cookies; WebSocket forwarding; settings card.
FAQ
- Is it safe to expose?
- The proxy is auth-gated: a secret must validate before a session cookie (default 30 days) is issued, and the secret rotates every 30s by default.
- Does it forward WebSockets?
- Yes — live updates reach the phone through WebSocket upgrade forwarding.
- How do I configure it?
- Port, session length, and refresh interval via the Settings → Plugins → QR connect card, or cordis.patch.yml defaults.
Alternatives
hellosky983/dsh-qrcode · Blank-not-black/dsh-Remote · Linjiangxian0203/dsh-remote-tunnel