Erste Schritte
Alcedo RDP verbindet Ihren Linux-Desktop über Remotedesktop (RDP) mit Windows-PCs und -Servern sowie mit Azure Virtual Desktop, Windows 365 Cloud PCs und lokalen Feeds von Remote Desktop Services.
So funktioniert es
Jeder Remote-Computer, den Sie verwenden, wird als Verbindung gespeichert. Verbindungen erscheinen als Karten im Hauptfenster, lassen sich gruppieren und als Favoriten markieren und merken sich alle Einstellungen für diesen Computer – Auflösung, welche lokalen Geräte freigegeben werden, und Leistungsoptionen. Wenn Sie sich verbinden, öffnet sich der Remotedesktop in einem eigenen Fenster.
Verbindung hinzufügen
- Klicken Sie in der Symbolleiste auf Add Connection.
- Geben Sie auf dem Tab General einen Anzeigenamen und den Hostnamen oder die IP-Adresse des Computers ein. Der Standard-RDP-Port ist 3389.
- Optional können Sie Benutzername, Domäne und Passwort eingeben. Passwörter werden im Schlüsselbund Ihres Desktops gespeichert (GNOME Keyring oder KDE Wallet über den Secret Service), niemals im Klartext.
- Prüfen Sie die Tabs Display, Resources, Experience und Gateway (siehe Verbindungseinstellungen) und klicken Sie dann auf Save.
Verbinden
Doppelklicken Sie auf eine Verbindungskarte oder klicken Sie auf deren Schaltfläche ▶. Ist kein Passwort gespeichert, werden Sie zur Anmeldung aufgefordert; die eingegebenen Anmeldedaten werden im Schlüsselbund und in der Verbindung gespeichert, damit Sie nicht erneut gefragt werden. Wenn Sie zum ersten Mal einen Server erreichen, dessen Zertifikat nicht vertrauenswürdig ist, zeigt Alcedo die Zertifikatsdetails an; Sie können es ablehnen (Reject), einmalig akzeptieren (Accept once) oder ihm immer vertrauen (Always trust).
Import und Arbeitsbereiche
- Import connections…
- Im Menü ⋯. Liest .rdp-Dateien im Standardformat, wie Microsoft Remote Desktop sie speichert – einschließlich RemoteApp-, Gateway- und Lastenausgleichseinstellungen –, sowie JSON-Exporte aus Alcedo unter Linux oder macOS und legt für jede Datei eine Verbindung an. Eine Datei ohne Verbindung wird übersprungen, sodass eine versehentlich mitgewählte Textdatei nie zur Verbindung wird.
- Export connections…
- Im Menü ⋯. Wählen Sie die Verbindungen per Häkchen aus und speichern Sie sie dann als eine JSON-Datei – mit allen Einstellungen, wieder importierbar in Alcedo unter Linux oder macOS – oder als je eine .rdp-Datei pro Verbindung für jeden beliebigen Remotedesktop-Client. Passwörter werden nie exportiert; geben Sie sie nach einem Import erneut ein.
- Add workspace feed…
- Im Menü ⋯. Geben Sie die Feed-URL von RD Web Access aus Ihrer lokalen Bereitstellung der Remote Desktop Services (endet meist auf /RDWeb/Feed/webfeed.aspx) sowie Ihren Benutzernamen und Ihr Passwort ein; daraufhin werden alle veröffentlichten Desktops und RemoteApps als Verbindungen in die von Ihnen gewählte Gruppe importiert.
Organisieren
- Gruppen
- Legen Sie auf dem Tab General einer Verbindung einen Gruppennamen fest. Gruppen erscheinen in der Seitenleiste, sodass zusammengehörige Computer beieinander bleiben.
- Favorites
- Klicken Sie auf den Stern einer Karte, um sie an die Liste Favorites anzuheften.
- Rechtsklick auf eine Karte
- Öffnet ein Menü zum Verbinden (Connect), Bearbeiten (Edit), Duplizieren (Duplicate), Markieren als Favorit oder Löschen (Delete). Duplicate legt eine Kopie (“… copy”) mit denselben Einstellungen und demselben Passwort an, die Sie dann anpassen können.
- Recent
- Verbindungen, die Sie verwendet haben, die neueste zuerst – auch über die Uhr-Schaltfläche unten in der Seitenleiste erreichbar.
- Suche
- Das Suchfeld filtert die aktuelle Liste nach Name und Host.
In der Sitzung
Jede Verbindung öffnet sich in einem eigenen Fenster; Sie können mehrere Sitzungen nebeneinander geöffnet haben.
Die Sitzungs-Symbolleiste
Bewegen Sie den Mauszeiger ganz an den oberen Rand des Sitzungsfensters, dann wird eine Symbolleiste eingeblendet. Sie verschwindet wieder, sobald der Zeiger sie verlässt.
- Ctrl+Alt+Del
- Sendet die Secure Attention Sequence an den Remote-Computer – zum Sperren von Windows, zum Ändern Ihres Passworts oder zum Öffnen des Task-Managers. Ctrl+Alt+End auf der Tastatur bewirkt dasselbe.
- ⊞ Win
- Sendet die Windows-Taste an den Remote-Computer – öffnet das Startmenü oder löst Windows-Tastenkombinationen aus, die sonst Ihr eigener Desktop abfangen würde.
- Fullscreen / Exit Fullscreen
- Schaltet den Vollbildmodus für diese Sitzung ein oder aus – alternativ F11 (oder Ctrl+Alt+Enter) drücken. Mit Match window size wird der Remotedesktop an Ihren Monitor angepasst.
- Disconnect
- Beendet die Sitzung und zeigt den Bildschirm nach der Trennung an. Ihre Programme laufen auf dem Remote-Computer weiter; Sie werden lediglich davon getrennt.
Größenänderung und Skalierung
Mit Match window size (Standard) fordert eine Größenänderung des Fensters den Remote-Computer auf, seine Desktopgröße entsprechend anzupassen, sodass das Bild pixelgenau bleibt. Bei einer Custom-Größe wird das Bild in Originalgröße mit schwarzen Balken angezeigt. Die Skalierung der Remote-Oberfläche (100 %, 150 % …) folgt Ihrer lokalen Anzeigeskalierung.
Zwischenablage
Text und Bilder werden in beide Richtungen synchronisiert, solange Clipboard für die Verbindung aktiviert ist. Kopieren und Einfügen von Dateien wird nicht unterstützt.
RemoteApp-Sitzungen
Bei RemoteApp-Verbindungen zeigt das Sitzungsfenster nur einen Statusbereich; jedes Fenster, das das Remote-Programm öffnet, erscheint als eigenes Fenster auf Ihrem Desktop und lässt sich wie ein lokales verschieben, in der Größe ändern und schließen. End session schließt das Programm und trennt die Verbindung.
Wenn die Verbindung abbricht
Fällt das Netzwerk aus, versucht Alcedo eine Zeit lang, die Verbindung automatisch wiederherzustellen, und zeigt Reconnecting über der eingefrorenen Sitzung an. Gelingt die Wiederverbindung, sind Ihre Programme und Fenster genau so wie zuvor.
Gelingt die Wiederverbindung nicht oder hat der Server Sie absichtlich getrennt – Sie wurden abgemeldet, ein anderes Gerät hat die Sitzung übernommen oder die Verbindung ist fehlgeschlagen –, zeigt das Fenster Disconnected oder Connection failed mit dem Grund an und bietet Reconnect und Close an.
Cloud & Arbeitsbereiche
Azure Virtual Desktop, Windows 365 Cloud PCs und lokale Feeds von Remote Desktop Services erscheinen neben Ihren eigenen Verbindungen.
Mit einem Geschäfts-, Schul- oder Unikonto anmelden
- Öffnen Sie in der Seitenleiste Azure & Cloud PCs und klicken Sie auf Sign In (auch in Settings verfügbar).
- Ihr Browser öffnet die Microsoft-Anmeldeseite. Melden Sie sich mit Ihrem Konto bei Microsoft Entra ID an; Alcedo bittet um die Berechtigung, Ihre Cloud PCs und Ressourcen in Virtual Desktop zu lesen.
- Zurück in Alcedo werden Ihre Arbeitsbereiche und Cloud PCs aufgelistet. Klicken Sie jederzeit auf Refresh, um die aktuelle Liste abzurufen.
Tipp Wenn Sie zum ersten Mal eine Ressource in Virtual Desktop öffnen, verlangt Microsoft eine zweite Anmeldung per Gerätecode. Alcedo kopiert den Code in die Zwischenablage und öffnet die Bestätigungsseite – fügen Sie den Code dort ein, dann schließt sich der Dialog von selbst.
Arbeitsbereiche und Cloud PCs
- Windows 365 Cloud PCs
- Die Ihnen zugewiesenen Cloud PCs mit ihrem Status. Klicken Sie auf Connect, um eine Sitzung zu starten. Cloud PCs werden über Ihren Feed für Virtual Desktop gestartet; ein Cloud PC, der nicht im Feed veröffentlicht ist, lässt sich hier daher nicht öffnen.
- Arbeitsbereiche in Azure Virtual Desktop
- Jeder Arbeitsbereich listet seine Desktops und RemoteApp-Programme auf. RemoteApps öffnen sich als einzelne Fenster auf Ihrem Desktop statt als vollständiger Desktop.
- Session Settings (⚙ auf einer Karte)
- Cloud-Ressourcen lassen sich nicht wie normale Verbindungen bearbeiten, aber jede Karte hat Session Settings, um die freigegebenen Geräte auszuwählen – Zwischenablage, Audio, Mikrofon, Drucker, TSPrint, TSScan, TSWebCam – sowie freigegebene Ordner, die Grafik-Codecs und ob die Sitzung im Vollbildmodus startet. Optionen, die Sie unverändert lassen, folgen Settings › Cloud › Session defaults.
- In Entra eingebundene Sitzungshosts
- Manche Hosts verlangen, dass Sie sich an der Sitzung selbst anmelden. Alcedo zeigt die Microsoft-Anmeldeseite in einem Dialog an und setzt den Verbindungsaufbau automatisch fort, sobald Sie angemeldet sind.
Lokale Remote Desktop Services
Verwenden Sie ⋯ › Add workspace feed… mit der Feed-URL von RD Web Access aus Ihrer eigenen Bereitstellung der Remote Desktop Services sowie Ihrem Domänen-Benutzernamen und Passwort. Die veröffentlichten Desktops und Apps werden als normale Verbindungen importiert, die Sie wie jede andere bearbeiten, gruppieren und als Favoriten markieren können.
Drucken, Scannen & Webcam
Die Terminalworks-Add-ons bringen lokale Drucker, Scanner und Kameras in die Remote-Sitzung. Schalten Sie jedes pro Verbindung ein (Tab Resources oder Session Settings auf einer Cloud-Karte). Für jedes muss die zugehörige Serverkomponente auf dem Remote-Computer installiert sein.
TSPrint – Drucken
Erfordert TSPrint Server auf dem Remote-Computer. Wenn Sie in der Sitzung auf dem TSPrint-Drucker drucken, öffnet sich auf Ihrem Desktop der Print-Dialog von Alcedo mit einer Seitenvorschau; gedruckt wird über CUPS auf jedem Drucker, der auf diesem Computer eingerichtet ist.
- Print-Dialog
- Wählen Sie den Drucker sowie Copies, Collate, Paper Size, Two-Sided, Color Mode, Resolution und Paper Tray und klicken Sie dann auf Print. Enter druckt, Esc bricht ab.
- Aktionen auf dem Server
- Die Schaltflächen Save As, Open und Email im TSPrint-Dialog auf dem Remote-Computer übergeben das Dokument an diesen Computer, um es zu speichern, zu öffnen oder an eine E-Mail anzuhängen.
TSScan – Scannen
Erfordert TSScan Server auf dem Remote-Computer. Scanner werden über SANE gefunden; alles, was in der Scan-App Ihres Desktops funktioniert, funktioniert also auch hier. Wenn eine Remote-Anwendung einen Scan anfordert, öffnet sich der Scan-Dialog von Alcedo.
- Scan-Dialog
- Wählen Sie Source (Flachbett oder Vorlageneinzug), Duplex (nur Vorlageneinzug), Color Mode, Resolution und Size. Preview zeigt einen schnellen Vorschau-Scan; Scan sendet die Seiten an die Remote-Anwendung, die das endgültige Dokument zusammenstellt.
TSWebCam – Kamera
Erfordert TSWebCam Server auf dem Remote-Computer. Das Bild Ihrer Kamera (jedes Video4Linux-Gerät) wird als H.264 codiert und erscheint in der Remote-Sitzung als Webcam für Videoanrufe und Aufnahmeanwendungen.
Hinweis Scanner und Kameras benötigen Gerätezugriff: Stellen Sie sicher, dass Ihr Benutzer das Gerät öffnen darf (in der Regel durch Mitgliedschaft in den Gruppen scanner und video oder durch die udev-Regeln, die Ihre Distribution mit SANE installiert).
Fehlerbehebung
"Connection failed"
Der Bildschirm nach der Trennung zeigt den Grund an, den der Remote-Computer oder die Netzwerkschicht gemeldet hat. Häufige Ursachen:
- Falsche Adresse oder falscher Port
- Prüfen Sie den Hostnamen bzw. die IP-Adresse und ob Port 3389 (oder Ihr eigener Port) erreichbar ist – möglicherweise blockiert ihn eine Firewall oder ein VPN.
- Remotezugriff ist deaktiviert
- Auf dem Windows-PC muss Einstellungen › System › Remotedesktop aktiviert sein, und Ihr Konto muss sich verbinden dürfen.
- Anmeldung fehlgeschlagen
- Geben Sie das Passwort erneut ein und versuchen Sie es zusätzlich mit der Domäne. Verwenden Sie für ein lokales Konto auf dem PC den Computernamen als Domäne oder ein vorangestelltes ".\".
- Keine Remotedesktoplizenzen
- Windows Server benötigt nach Ablauf des 120-tägigen Toleranzzeitraums eine Remotedesktoplizenzierung (RDS-CALs). Erreicht der Server keinen Lizenzserver oder hat er keine Lizenzen mehr, verweigert er die Sitzung; das kann nur der Serveradministrator beheben. PCs mit Windows 10/11 Pro benötigen nie Lizenzen.
"We couldn't establish a secure connection" (TLS)
Der Remote-PC hat die Verbindung angenommen, aber der TLS-Handshake ist fehlgeschlagen (Fehlercode 0x0008). Häufigste Ursache beim Linux-Client ist ein Server oder eine vorgeschaltete Firewall mit TLS-Inspektion, die einen Handshake mit ausschließlich modernen Signaturen ablehnt – das OpenSSL des Clients bietet die alte SHA-1-Signatur, die Windows weiterhin anbietet, nicht mehr an.
Klicken Sie auf dem Fehlerbildschirm auf Retry with legacy TLS, um sich einmalig mit wieder aktivierter Signatur neu zu verbinden. Um das für diese Verbindung dauerhaft einzustellen, schalten Sie auf ihrem Tab Gateway die Option Legacy TLS compatibility ein. Das senkt die Sicherheit geringfügig; verwenden Sie es daher nur dort, wo eine Verbindung es braucht. Die eigentliche Lösung ist ein Zertifikats- oder TLS-Update auf dem Server.
Zertifikatswarnung
Bei der ersten Verbindung zu einem Server mit selbstsigniertem oder anderweitig nicht vertrauenswürdigem Zertifikat zeigt Alcedo dessen Details an. Accept once vertraut ihm nur für diese Sitzung; Always trust merkt es sich dauerhaft. Wenn sich das Zertifikat eines bekannten Servers plötzlich ändert, seien Sie vorsichtig – klären Sie das mit Ihrem Administrator, bevor Sie es akzeptieren.
Ein anderes Gerät hat sich mit dieser Sitzung verbunden
Windows erlaubt eine aktive Verbindung pro Benutzersitzung. Wenn Sie (oder ein Kollege mit demselben Konto) sich von einem anderen Computer aus verbinden, übernimmt dieser andere Computer die Sitzung, und die Verbindung auf diesem Computer wird getrennt. Verbinden Sie sich erneut von dem Computer aus, den Sie verwenden möchten, dann wechselt die Sitzung wieder dorthin.
Passwörter werden nicht gespeichert
Alcedo speichert Passwörter im Schlüsselbund des Desktops. Ist kein Secret Service verfügbar – etwa bei einem minimalen Fenstermanager ohne GNOME Keyring oder KDE Wallet oder bei einem gesperrten Schlüsselbund –, schlägt das Speichern ohne Meldung fehl und Sie werden jedes Mal nach dem Passwort gefragt. Starten oder entsperren Sie Ihren Schlüsselbund oder installieren Sie gnome-keyring.
Anmeldung an lokalen Servern schlägt immer fehl
Die NTLM-Anmeldung (PCs in Arbeitsgruppen, Feeds von RD Web) benötigt den OpenSSL-Legacy-Provider für MD4/RC4. Das AppImage enthält ihn bereits; wenn Sie Alcedo selbst gebaut haben und das Terminal "OpenSSL legacy provider unavailable" anzeigt, installieren Sie das Paket Ihrer Distribution mit dem OpenSSL-Legacy-Provider.
Hinweise zum Displayserver
Das AppImage läuft standardmäßig unter X11 (XWayland auf Wayland-Desktops), weil das für ein mitgeliefertes Qt die zuverlässigste Wahl ist. Um natives Wayland auszuprobieren, starten Sie es mit QT_QPA_PLATFORM=wayland.
Probleme beim Drucken (TSPrint)
TSPrint Server sendet jeden Druckauftrag an Alcedo; Alcedo zeigt den Print-Dialog an und übergibt das Dokument an CUPS. Wenn ein Auftrag nie ankommt, der Dialog das falsche Papier oder Fach anzeigt oder nichts aus dem Drucker kommt, zeigt das clientseitige Protokoll jeden einzelnen Schritt.
- Protokolldatei
- /tmp/tsprint_debug.log – der Handshake mit dem Server, jeder Auftrag (Dokumentname, Größe sowie das Papier, die Ausrichtung, die Kopien und der Duplexdruck, die der Server angefordert hat), der im Dialog gewählte Drucker, Papier und Fach, was an CUPS übergeben wurde, und etwaige Fehler.
Probleme beim Scannen (TSScan)
Alcedo listet die Scanner auf, die SANE kennt (das, was scanimage -L anzeigt), und sendet die Liste an TSScan Server, wenn die Remote-Anwendung danach fragt. Wenn auf der Remote-Seite keine Scanner erscheinen oder sich die Anwendung beim Laden der Geräte schließt, zeigt uns das clientseitige Protokoll, was gefunden und was genau gesendet wurde.
- Protokolldatei
- /tmp/tsscan_debug.log – jeder TSScan-Schritt mit Zeitstempel: die Scannersuche (Name jedes Scanners und dessen Länge sowie die Dauer der Suche), die Befehle des Servers, die Antworten und der Scan selbst.
Probleme mit der Webcam (TSWebCam)
Alcedo listet die Kameras auf, von denen es aufnehmen kann (V4L2-Geräte mit einem Rohformat), und streamt H.264 an TSWebCam Server, der sie in der Sitzung als virtuelle Kamera anzeigt. Wenn keine Kamera aufgelistet wird oder das Bild nie startet, zeigt das clientseitige Protokoll die gefundenen Kameras und die Aufnahme-Pipeline.
- Protokolldatei
- /tmp/tswebcam_debug.log – die gefundenen Kameras mit ihren Formaten und Auflösungen, was angekündigt wurde, der Handshake, Start und Stopp der Aufnahme mit Auflösung, Bildrate und Encoder, Bildzähler und der Watchdog, der auslöst, wenn die Kamera nichts liefert.
Protokolle sammeln
Bei jedem Start schreibt Alcedo für die Sitzung selbst alcedo-app.log und alcedo-freerdp.log nach /tmp (oder $TMPDIR); diese Dateien werden bei jedem Start neu angelegt.
Die Add-on-Protokolle – tsprint_debug.log, tsscan_debug.log und tswebcam_debug.log – werden nur auf Wunsch geschrieben: Schalten Sie Developer mode unter Settings › General ein (oder starten Sie Alcedo mit --dev), aktivieren Sie das Add-on auf dem Tab Logging der Verbindung (Edit-Dialog oder Session Settings auf einer Cloud-Karte), verbinden Sie sich dann und reproduzieren Sie das Problem. Die Protokolle werden über mehrere Starts hinweg fortgeschrieben, mit einer Kopfzeile pro Lauf, und gekürzt, sobald sie 2 MB überschreiten. Hängen Sie die Dateien an eine E-Mail über Report an Issue an – zusammen mit dem Eintrag aus der Windows-Ereignisanzeige, falls die Remote-Anwendung abgestürzt ist.
Immer noch Probleme?
Besuchen Sie die Support-Website von Terminalworks oder schreiben Sie über Report an Issue eine E-Mail an [email protected]. Geben Sie bitte die Meldung auf dem Bildschirm nach der Trennung, die Windows-Version des Remote-Computers und Ihre Linux-Distribution an – die App-Version trägt die E-Mail-Vorlage für Sie ein. Die Protokolldateien in /tmp (siehe Protokolle sammeln oben) helfen bei allem, was auf dem Bildschirm nicht zu sehen ist.
Terminalworks-Support
Report an Issue
