mirror of https://github.com/UNITRONIX/BetterDesk.git synced 2026-09-10 17:45:42 +00:00

Files

T

UNITRONIX 4c1a9d5e88 fix(security): patch vulnerable deps + add Go server rebuild flow

Bump golang.org/x/crypto to v0.52.0 and x/sys to v0.45.0 in betterdesk-server, x/sys to v0.45.0 in betterdesk-agent, and aiohttp to >=3.10.11 in the rest-webhook bridge. Validated clean via govulncheck.

Add an explicit Go server rebuild path to the in-app updater so security/library updates actually reach the running binary: updateService now marks the server binary stale when the source changed but a non-critical rebuild/deploy step failed, exposes getServerBinaryStatus() and rebuildServerBinary(), and surfaces a warning banner plus a Rebuild button in the settings update panel. New REST endpoints GET/POST /api/settings/updates/server-binary/{status,rebuild} guarded by server.config permission. i18n keys added across all locales.

This commit was made possible thanks to Insolve.

2026-05-31 06:37:02 +02:00

modbus

BetterDesk 3.0.0 Alpha

2026-03-24 00:26:25 +01:00

rest-webhook

fix(security): patch vulnerable deps + add Go server rebuild flow

2026-05-31 06:37:02 +02:00

snmp

BetterDesk 3.0.0 Alpha

2026-03-24 00:26:25 +01:00

README.md

BetterDesk 3.0.0 Alpha

2026-03-24 00:26:25 +01:00

README.md

BetterDesk CDAP — Reference Bridges

This directory contains ready-to-use bridge implementations that connect external systems to BetterDesk via the CDAP protocol. Each bridge uses the Python SDK (sdks/python/) and can be deployed as a standalone service alongside BetterDesk server.

Available Bridges

Bridge	Directory	Protocol	Use Case
Modbus	`modbus/`	Modbus TCP / RTU	PLCs, VFDs, power meters, industrial I/O
SNMP	`snmp/`	SNMP v2c / v3	Network switches, routers, UPS, printers
REST Webhook	`rest-webhook/`	HTTP REST	Home automation (HA, OpenHAB), cloud APIs

Architecture

External Device/API
       │
       ▼
┌──────────────┐
│  Bridge      │ ← polls/subscribes to external system
│  (Python)    │ ← pushes state updates to CDAP
│              │ ← receives commands from CDAP → writes to external system
└──────┬───────┘
       │ WebSocket (CDAP)
       ▼
┌──────────────┐
│ BetterDesk   │
│ CDAP Gateway │
│ (:21122)     │
└──────────────┘

Quick Start

# 1. Install Python SDK
cd sdks/python
pip install -e .

# 2. Install bridge dependencies
cd bridges/modbus
pip install -r requirements.txt

# 3. Copy and edit config
cp config.example.json config.json
# edit config.json with your server URL, API key, and device addresses

# 4. Run
python bridge_modbus.py --config config.json

Creating a Custom Bridge

Use the Python SDK directly:

from betterdesk_cdap import CDAPBridge, gauge, toggle

bridge = CDAPBridge(
    server="ws://your-server:21122/cdap",
    api_key="YOUR_KEY",
    device_name="My Custom Bridge",
    device_type="bridge",
)

bridge.add_widget(gauge("sensor1", "Temperature", unit="°C", max_val=50))

@bridge.on_command("relay1")
async def handle_relay(action, value, **kw):
    # Write to your external system here
    return value

bridge.run()

See the Python SDK README and Node.js SDK README for full API reference.

Configuration

All bridges use a shared configuration pattern:

{
  "cdap": {
    "server": "ws://192.168.0.110:21122/cdap",
    "api_key": "YOUR_API_KEY",
    "device_name": "Bridge Name",
    "device_type": "bridge",
    "heartbeat_sec": 15
  },
  "bridge_specific_options": { }
}

Deployment

Each bridge can run as:

systemd service (Linux) — see install/ in each bridge directory
Docker container — docker run with mounted config.json
Screen/tmux session — for testing

License

MIT