Lecteur Markdown

Remote Desktop Documentation De

Funktion: Remote Desktop #

Bildschirmfreigabe und Fernsteuerung zwischen Benutzern, Peer-to-Peer über WebRTC. Ein Benutzer lädt ein anderes angemeldetes Mitglied ein, das daraufhin seinen Bildschirm sieht und – mit Erlaubnis – die Steuerung übernehmen kann. Die Signalisierung läuft über den Server; der Videostream geht direkt zwischen den beiden Browsern.

Installation und Konfiguration

Per FTP: Das Verzeichnis remote_desktop/ nach /plugins/ hochladen, anschließend remote_desktop/sql/remote_desktop.sql importieren.

Per Package-Manager: remote_desktop aus der Liste der verfügbaren Plugins auswählen.

Pfade:

Haupt-Plugin: /plugins/remote_desktop/remote_desktop.php
Bibliothek: /plugins/remote_desktop/lib/remote_desktop.lib.inc.php
Signalisierungs-Handler: /plugins/remote_desktop/handlers/remote_desktop.mod.php
CSS / JS: /plugins/remote_desktop/css/, /plugins/remote_desktop/js/

Konfigurationsparameter:

| Variable | Standardwert | Beschreibung |

|---|---|---|

| $basedatadisplay | 'yes' | In der Verwaltungsoberfläche sichtbar |

| $basedisplevel | BASE_LEVEL_USER | Für angemeldete Benutzer verfügbar |

| $ftype | 5 | Anwendungsmodul |

| REMOTE_DESKTOP_LEVEL_USER | BASE_LEVEL_USER | Stufe zur Nutzung der Freigabe |

| REMOTE_DESKTOP_LEVEL_ADMIN | BASE_LEVEL_ADMIN | Administrator-Stufe |

| $rd_ice_servers | Google STUN | WebRTC-ICE-Server (siehe Hinweis unten) |

| $rd_poll_interval | 500 | Signalisierungs-Poll-Intervall (ms), während der Aushandlung |

| $rd_max_session_duration | 3600 | Maximale Sitzungsdauer (Sekunden) |

| $rd_signal_ttl | 300 | Lebensdauer der Signale vor der Bereinigung (Sekunden) |

> Produktion: Den Google-STUN-Server durch einen selbst gehosteten STUN/TURN-Server (coturn usw.) ersetzen. Google-Server erhalten die Kandidaten-IP-Adressen.

Verwendete SQL-Tabellen: remote_desktop_session, remote_desktop_signal

Verwendung

Die Hauptseite hat zwei Bereiche:

Benutzer — Liste verfügbarer angemeldeter Mitglieder (alle 15 s aktualisiert), die eingeladen werden können.
Sitzungen — laufende Freigabesitzungen.

Beim Empfang einer Einladung bearbeitet der Empfänger diese über eine ?respond=session_id-URL.

Zwei iframe-Anzeigemodi liefern die minimale WebRTC-Oberfläche (ohne Seiten-Chrome):

mode=sharer — teilt den eigenen Bildschirm.
mode=viewer — sieht den entfernten Bildschirm, mit optionalem Steuerungs-Overlay.

Die Symbolleiste bietet Vollbild, Steuerungsanfrage und Sitzungsende.

Hooks und Einstiegspunkte

text

?obj=remote_desktop.php                                — Hauptseite (Benutzer + Sitzungen)
?obj=remote_desktop.php&respond=session_id            — Auf eine Einladung antworten
?obj=remote_desktop.php&mode=sharer&session_id=ID     — iframe: Bildschirmfreigabe
?obj=remote_desktop.php&mode=viewer&session_id=ID     — iframe: Ansicht
?obj=remote_desktop.mod                               — WebRTC-Signalisierungs-Endpunkt

Abhängigkeiten

Beamreactor\Database\SQL
Beamreactor\Sanitizer\Parser
Beamreactor\Notifications\Toast
WebRTC (Browser) + STUN/TURN-Server

Sicherheit

Beschränkt auf angemeldete Benutzer. Die Freigabesitzung und die Übernahme der Steuerung erfordern die ausdrückliche Zustimmung des Empfängers. Sitzungen haben eine maximale Dauer ($rd_max_session_duration), und Signale verfallen ($rd_signal_ttl), um das Aushandlungsfenster zu begrenzen. In der Produktion einen selbst gehosteten STUN/TURN-Server verwenden, damit die IP-Adressen der Teilnehmer nicht an Dritte weitergegeben werden.