feat: self-hosted remote support over VNC

Browser-based remote control (noVNC) with invite links, per-user access
control, garagedoor SSO and a persisted client list.

The hub proxies RFB rather than pointing the browser at a VNC server. That
is what lets it authenticate upstream with a stored password the browser
never sees, and enforce view-only by dropping input messages on the
client->server stream instead of hiding buttons.

Machines are reachable two ways: direct TCP for LAN hosts, or an outbound
agent tunnel for anything behind NAT. Node 22's global WebSocket keeps the
agent dependency-free, and node:sqlite keeps the image free of native
builds.

Ships with an end-to-end suite that boots the real server against a fake
VNC server and a fake auth service (72 assertions), plus Gitea Actions
CI/CD to Portainer.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-11 23:37:35 -07:00
co-authored by Claude Opus 5
commit 999717f77b
34 changed files with 7057 additions and 0 deletions
+21
View File
@@ -0,0 +1,21 @@
{
"name": "remote-control-support-webapp",
"version": "0.1.0",
"description": "Self-hosted remote support over VNC — browser viewer, invite links, access control",
"main": "server/index.js",
"scripts": {
"start": "node server/index.js",
"dev": "node --watch server/index.js",
"agent": "node agent/agent.js",
"test": "node test/e2e.js"
},
"license": "MIT",
"engines": {
"node": ">=22.5"
},
"dependencies": {
"@novnc/novnc": "^1.6.0",
"express": "^4.19.2",
"ws": "^8.18.0"
}
}