iimaguest/phone-tunnel-pool
Adds a self-healing Cloudflare quick-tunnel pool to the dsh web GUI so a phone can reach it by QR scan and survive tunnel rotation.
A floating phone widget in the GUI mints a Cloudflare quick-tunnel pair on a 12-hour generational schedule and shows a scannable QR code; older generations stay alive while anything is still attached, so an open tab is not dropped mid-session. Every origin the browser touches registers a service worker that redirects dead or rotated hostnames to a live sibling or the newest primary, which is what lets the same tab survive a generation change. The proxy only injects credentials into pages it has already authenticated, and the watchdog pre-authenticates the redirect target so migrations land already logged in instead of hitting an authentication prompt. Generations retire when idle (no tabs, websockets or recent traffic) or at a hard age cap, and dead tunnels are replaced with new hostnames under exponential backoff so Cloudflare's quick-tunnel mint quota (429) is respected, with a two-probe dead grace for DNS propagation. The daemon runs detached and adopts across dsh web restarts, so the URL, password and QR stay valid until Disable is clicked; the README notes an OS reboot still costs one fresh scan unless a named tunnel is used.
Install
dsh plugin --profile web add github:iimaguest/phone-tunnel-poolThe install block from the README (the same page documents the one-command uninstall, which removes the dependency and the dsh.profile.bundles layer). The README is explicit that install and remove reconcile dsh.profile.bundles automatically and that the profile package.json should never be edited by hand.
Compatibility
cloudflared must be on PATH (brew install cloudflared, or point DSH_CLOUDFLARED at an existing binary). The README's table also lists a phone with a camera for the QR scan. The pool targets http://127.0.0.1:3080, the dsh web GUI.
Details
- Repo: iimaguest/phone-tunnel-pool
- Category: Infrastructure & Deployment
- Stars: 7
- Version: Apache-2.0; no npm package — install from GitHub
Alternatives
iimaguest/dsh-sandbox-escalation-guard · pipipigu/dsh-ssh-control · NamesMT/dsh-home-hosted