mirror of https://github.com/UNITRONIX/BetterDesk.git synced 2026-09-11 13:49:03 +00:00

Files

T

UNITRONIX be9b0ce7dc feat(mesh): default-on migration, panel closure, KVM multiplex, WoL bridge

Ship mesh layer as default-on with updater/installer MESH_ENABLED=Y injection,
Settings groups/recordings UI, device power and filter UX, relay multiplexing,
WoL wake fallback, mesh RBAC permissions, and REST automation docs.

2026-06-21 23:38:07 +02:00

2.0 KiB

Raw Blame History

MeshCentral REST automation (BetterDesk)

BetterDesk operators and scripts should use the native REST API instead of meshctrl against a MeshCentral server.

Device operations

Action	Endpoint	Body
Run command	`POST /api/peers/{id}/exec`	`{"command":"whoami","shell":true}`
Mesh-only exec	`POST /api/mesh/devices/{id}/exec`	same
Power wake/sleep/off/reset	`POST /api/mesh/devices/{id}/power`	`{"action":"wake","mac":"optional"}`
Guest desktop link	`POST /api/mesh/devices/{id}/share`	`{"ttl_minutes":60,"view_only":true}`
TCP port relay tunnel	`POST /api/mesh/devices/{id}/tcp`	`{"host":"127.0.0.1","port":3389}`
UDP port relay tunnel	`POST /api/mesh/devices/{id}/udp`	`{"host":"127.0.0.1","port":53}`
Assign mesh group	`POST /api/mesh/devices/{id}/group`	`{"group_id":"default"}`

Inventory and settings

Action	Endpoint
Mesh status	`GET /api/mesh/status`
Server ID	`GET /api/mesh/server-id`
Mesh groups	`GET/POST /api/mesh/groups`
Download `.msh`	`GET /api/mesh/download.msh?name=BetterDesk%20Mesh`
Session recordings	`GET /api/session/recordings`
Download mesh recording	`GET /api/mesh/recordings/{filename}`

Authentication

Use panel session cookies, API keys, or JWT as for other BetterDesk REST endpoints. Mesh .ashx WebSockets (/agent.ashx, /meshrelay.ashx, /control.ashx) are proxied from the panel HTTPS listener.

Wake on LAN

When a mesh_agent is offline, POST /api/mesh/devices/{id}/power with {"action":"wake"} attempts Wake-on-LAN using:

Optional mac in the request body
MAC parsed from mesh agent telemetry (mesh_last_msg_*)
MAC from the linked RustDesk/CDAP peer (linked_peer_id)

Recording

Server-side mesh KVM capture: open web remote with mesh transport and toggle Record (sets record=1 on the desktop tunnel), or pass ?record=1 when opening remote. Files are stored under {data_dir}/mesh-recordings/*.mcrec.

2.0 KiB Raw Blame History