Anleitung für den Remote-Zugriff

Drei Wege,
Ihren Cloud-Mac zu verbinden

Für eine grafische Oberfläche nutzen Sie VNC oder die macOS-Bildschirmfreigabe. Für Builds und Skripte ist SSH die richtige Wahl. Sie verbinden sich mit einem exklusiven physischen Apple-Silicon-Server, nicht mit einer virtuellen Maschine.

Sie haben bereits bestellt? Prüfen Sie IP-Adresse, Benutzername und Zugriffsport in den Instanzdetails der Konsole und folgen Sie dann den Schritten unten. Hostnamen und Ports in diesem Artikel dienen als Beispiele.

AV / ACCESS / 03 Ein Server, zwei Arbeitsweisen
GUI

Desktop anzeigen und interaktiv arbeiten

Lokaler VNC-Client oder macOS-Bildschirmfreigabe

SSH-Tunnel → grafischer Desktop des Servers
CLI

Builds ausführen, ohne den Bildschirm zu übertragen

Lokales Terminal oder CI-Runner

SSH → Befehlszeile und Build-Prozesse
Servertyp
Exklusiver physischer Server
Verbindungsdaten
Instanzdetails in der Konsole
Beispielports
SSH 22 / VNC 5900
Empfohlene Verbindung
Schlüsselanmeldung + Grafik-Tunnel

Die tatsächlichen Ports entnehmen Sie den Angaben zu Ihrer Instanz. VNC und Bildschirmfreigabe nutzen in der Regel denselben Grafikdienst und bieten keine zwei getrennten Desktops.

Das Protokoll passend zur Aufgabe wählen

Für Desktoparbeit und Automatisierung gibt es jeweils den richtigen Weg

Grafische Oberfläche / plattformübergreifend

VNC

Geeignet für Windows, Linux und iPad. Öffnen Sie Xcode remote, prüfen Sie Build-Einstellungen oder bestätigen Sie Systemdialoge, für die ein Klick erforderlich ist.

  • Geben Sie Hostadresse, Port und die vom Grafikdienst verlangten Anmeldedaten ein.
  • Verbinden Sie sich vorzugsweise über einen SSH-Tunnel. Eine gewöhnliche VNC-Verbindung ist nicht automatisch verschlüsselt.
  • Der Client muss die auf dem Server aktivierte Authentifizierung unterstützen. Bei inkompatiblen Verfahren passen Sie zunächst die Authentifizierungseinstellungen an.

Richtig für Sie, wenn Sie keinen Mac vor Ort haben, aber die vollständige macOS-Oberfläche benötigen.

Grafische Oberfläche / Mac-Client

macOS-Bildschirmfreigabe

Die erste Wahl, wenn Sie selbst einen Mac verwenden. Nutzen Sie den integrierten Bildschirmfreigabe-Client, ohne einen zusätzlichen Desktop-Viewer zu installieren.

  • Wählen Sie im Finder „Gehe zu → Mit Server verbinden“ und geben Sie die VNC-Adresse ein.
  • Verwenden Sie die Zugangsdaten des Servers, nicht das Anmeldepasswort Ihres lokalen Macs.
  • Bei einer Tunnelverbindung verwenden Sie die lokale Weiterleitungsadresse. Die Adresse des Remote-Hosts bleibt im SSH-Befehl.

Richtig für Sie, wenn Sie einen Mac verwenden und den Client möglichst einfach einrichten möchten.

Befehlszeile / Automatisierung

SSH

Ideal für xcodebuild, Protokolle, den Abgleich von Projekten und die Verwaltung von Runnern. Da keine Desktopansicht übertragen wird, eignet sich SSH besonders für lange Builds.

  • Prüfen Sie zuerst den Host-Fingerabdruck und melden Sie sich dann per Passwort oder Schlüssel an.
  • Eine unterbrochene interaktive SSH-Sitzung ist keine zuverlässige Methode zur Verwaltung von Hintergrundaufgaben.
  • Nutzen Sie für dauerhaft laufende Aufgaben einen Runner-Dienst oder einen verwalteten Hintergrundprozess und speichern Sie die Build-Protokolle.

Richtig für Sie, wenn sich die Aufgabe per Befehl ausführen lässt oder in eine CI-Pipeline integriert werden soll.

Verbindungsdaten richtig eintragen

Vier lokale Systeme, dieselben Serverdaten

Die Tabelle verwendet SSH-Port 22 und VNC-Port 5900 als Beispiele. Ersetzen Sie abweichende Ports durch die tatsächlich angegebenen Werte. Ob das Passwort des Grafikdienstes und das SSH-Passwort identisch sind, hängt von den Zugangsdaten und der aktuellen Serverkonfiguration ab. Verwenden Sie sie nicht wahllos abwechselnd.

Client-Auswahl und Verbindungsdaten im Überblick
Lokales System Empfohlener Grafik-Client Grafikadresse und Port SSH-Zugriff
Windows TigerVNC Viewer; prüfen Sie zuerst, ob die aktuelle VNC-Authentifizierung des Servers unterstützt wird. Bei direkter Verbindung die Felder Host / Port im Client verwenden. Nach dem Einrichten des Tunnels wie unten beschrieben Host auf 127.0.0.1und Port auf 15900setzen. Windows Terminal mit dem OpenSSH-Client öffnen und folgenden Befehl ausführen: ssh -p 22 build@HOST_IP.
Linux Remmina im VNC-Modus oder TigerVNC Viewer mit kompatibler Authentifizierung. Über den Tunnel verbinden mit 127.0.0.1:15900; verwendet der Client separate Host- und Portfelder, tragen Sie die Werte einzeln ein. Geben Sie keine Anzeigenummer an. OpenSSH im Terminal. Melden Sie sich zuerst normal per SSH an und richten Sie anschließend die lokale Portweiterleitung ein.
macOS Die integrierte App „Bildschirmfreigabe“. Direkt verbinden mit vnc://HOST_IP:5900; über den Tunnel mit vnc://127.0.0.1:15900. Im Terminal ssh. Alternativ starten Sie die Bildschirmfreigabe-Adresse mit dem Befehl open .
iPad Ein VNC-Client, der macOS-Authentifizierung und SSH-Tunnel unterstützt. Richten Sie im Client SSH-Host und Authentifizierung ein und setzen Sie das grafische Ziel auf dem Server auf 127.0.0.1:5900; die genauen Feldnamen hängen vom Client ab. Verwenden Sie einen SSH-Client, der den Import von Schlüsseln unterstützt. Prüfen Sie zuerst die Schlüsselanmeldung und aktivieren Sie danach die integrierte Weiterleitung.
Gleich nach der ersten Anmeldung

Erst eine vertrauenswürdige Verbindung einrichten, dann die Arbeit übertragen

  1. 01

    Adresse und Fingerabdruck prüfen

    Rufen Sie IP-Adresse, SSH-Port und Benutzernamen des Servers in der Konsole ab. Prüfen Sie beim ersten Verbindungsaufbau den Host-Fingerabdruck. Wird er in der Konsole nicht angezeigt, fragen Sie über ein Support-Ticket nach. Nach einer Neuinstallation kann sich der Fingerabdruck ändern: Prüfen Sie die Änderung, bevor Sie den lokalen Eintrag aktualisieren. Umgehen Sie die Warnung nicht, indem Sie die Hostprüfung deaktivieren.

  2. 02

    Anfangspasswort ändern

    Melden Sie sich zunächst an und führen Sie passwd aus, um das Passwort des aktuellen Benutzers zu ändern. Prüfen Sie außerdem, welche Authentifizierung der Grafikdienst verwendet. Falls ein separates VNC-Passwort eingerichtet ist, ändern Sie auch dieses. Speichern Sie Passwörter nicht in Repositories, Build-Protokollen oder gemeinsam genutzten Skripten.

  3. 03

    Schlüsselanmeldung testen

    Fügen Sie den lokal erzeugten öffentlichen Schlüssel auf dem Server zu ~/.ssh/authorized_keyshinzu. Der private Schlüssel bleibt auf einem vertrauenswürdigen Client. Öffnen Sie ein neues Terminal und prüfen Sie, ob die Anmeldung funktioniert, bevor Sie die Passwortanmeldung weiter einschränken. Lassen Sie die bestehende Verbindung zunächst offen, damit Sie sich nicht versehentlich vom Server aussperren.

  4. 04

    Zugriff auf den Grafikdienst beschränken

    Aktivieren Sie den Grafikdienst nur, wenn Sie den Desktop benötigen. Prüfen Sie unter macOS „Systemeinstellungen → Allgemein → Teilen → Bildschirmfreigabe“ und beschränken Sie die zugelassenen Benutzer. Bevor Sie den Dienst deaktivieren oder anpassen, stellen Sie sicher, dass SSH funktioniert. Ein verschlüsselter Tunnel verhindert nicht automatisch, dass der Remote-Port öffentlich erreichbar ist.

Schlüssel lokal erzeugen, auf dem Server nur den öffentlichen Schlüssel speichern

Führen Sie die folgenden Befehle lokal aus. build und HOST_IP müssen Sie durch die bereitgestellten Werte ersetzen. Legen Sie beim Erzeugen des Schlüssels eine Passphrase für den privaten Schlüssel fest.

ssh-keygen -t ed25519 -f ~/.ssh/armvnc_build
cat ~/.ssh/armvnc_build.pub
ssh -p 22 build@HOST_IP

Melden Sie sich am Server an, erstellen Sie das Verzeichnis und die Datei für den öffentlichen Schlüssel und setzen Sie die Berechtigungen. Fügen Sie den vollständigen öffentlichen Schlüssel aus der vorherigen Ausgabe in eine eigene Zeile ein. Fügen Sie nicht den privaten Schlüssel ein.

mkdir -p ~/.ssh
chmod 700 ~/.ssh
nano ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys

Kehren Sie zum lokalen Rechner zurück und testen Sie die Anmeldung:ssh -i ~/.ssh/armvnc_build -p 22 build@HOST_IP

Grafischen Desktop über einen SSH-Tunnel öffnen

Verwenden Sie lokal Port 15900 und als Zielport auf dem Server 5900. Die Weiterleitung ist an die lokale Loopback-Adresse gebunden und für andere Geräte im selben Netzwerk nicht zugänglich.

ssh -i ~/.ssh/armvnc_build -p 22 \
  -N -T \
  -o ExitOnForwardFailure=yes \
  -o ServerAliveInterval=30 \
  -o ServerAliveCountMax=3 \
  -L 127.0.0.1:15900:127.0.0.1:5900 \
  build@HOST_IP

Solange der Befehl läuft und keine Fehler ausgibt, verbinden Sie den Grafik-Client mit Port 15900 auf Ihrem lokalen Rechner. Unter macOS können Sie in einem zweiten Terminal Folgendes ausführen:

open 'vnc://127.0.0.1:15900'

Der Tunnel umgeht die VNC-Authentifizierung nicht. Beenden Sie nach der Nutzung den Grafik-Client und drücken Sie dann im Tunnel-Terminal Ctrl + C , um die Weiterleitung zu schließen.

Erst die Anzeige anpassen, dann das Netzwerk prüfen

Bildqualität auf die Aufgabe abstimmen, nicht ständig jedes Pixel übertragen

Die folgenden Werte sind Ausgangspunkte zur Fehlersuche und keine Zusage zu Bandbreite oder Latenz. Ob sich Farbtiefe und Komprimierung anpassen lassen, hängt vom jeweiligen Protokoll ab. Ändern Sie immer nur eine Einstellung und vergleichen Sie dieselbe Aktion, etwa das Verschieben eines Xcode-Fensters, das Scrollen in einem Protokoll oder die Eingabe eines Textes.

Für die tägliche Programmierung und Build-Prüfung

Ausgangsauflösung
1440 × 900
Ausgangsfarbtiefe
24 Bit
Ausgangskomprimierung
Automatisch oder mittel

Achten Sie vor allem auf gut lesbaren Text. Ist das Client-Fenster zu klein, aktivieren Sie zuerst die proportionale Skalierung. Erhöhen Sie nicht gleichzeitig die Auflösung des Remote-Desktops und den lokalen Zoom.

Geeignet für: Xcode-Einstellungen, Protokollprüfung und gelegentliche Arbeit in der grafischen Oberfläche.

Für Verbindungen über große Entfernungen oder eingeschränkte Netzwerke

Ausgangsauflösung
1280 × 800
Ausgangsfarbtiefe
16 Bit (falls unterstützt)
Ausgangskomprimierung
Hoch

Deaktivieren Sie zuerst Desktop-Animationen und unnötige Vorschauen. Starke Komprimierung kann Details beeinträchtigen. Sie verringert das übertragene Datenvolumen, aber nicht die Round-Trip-Zeit des Netzwerks.

Geeignet für: weit entfernte Server, Mobilfunknetze und gelegentliche Paketverluste.

Für lange Archive und Automatisierung

Hauptverbindung
SSH
Desktop-Sitzung
Bei Bedarf starten
Aufgabenverwaltung
Runner-Dienst

Wenn Sie den Bildschirm nicht benötigen, speichern Sie einfach Build-Protokolle und Artefakte. Wenn Sie den Grafik-Client trennen, wird macOS dadurch nicht abgemeldet. Beenden Sie Aufgaben nicht auf diese Weise.

Geeignet für: dauerhaft laufende CI, unbeaufsichtigte Skripte und wiederkehrende Builds.

Auch bei der Serverauswahl kommt es auf den Einsatzzweck an: Für interaktive Desktoparbeit zählt vor allem die Netzwerkverbindung zwischen Ihnen und dem Server. Bei reinen Builds sind zusätzlich der Abruf von Repositories, Downloads von Abhängigkeiten und das Hochladen von Artefakten wichtig. Aus der Reaktion auf eine einzelne Mausbewegung lässt sich nicht auf die Build-Leistung schließen.

Fehler anhand des Symptoms eingrenzen

Netzwerk, Authentifizierung und Desktop-Sitzung getrennt prüfen

Testen Sie zuerst SSH und dann die Grafikverbindung. Funktioniert SSH, aber VNC nicht, prüfen Sie vor allem den Grafikdienst und das Tunnelziel. Funktionieren beide nicht, kontrollieren Sie zuerst den Instanzstatus, die Adresse, das lokale Netzwerk und die Ports. Installieren Sie das System nicht gleich neu.

Die Verbindung bricht wiederholt ab. Muss ich nach dem erneuten Verbinden die Aufgabe neu starten?

Unterscheiden Sie zunächst zwischen einer unterbrochenen Verbindung und einer beendeten Aufgabe. Verbinden Sie sich erneut per SSH oder über den Grafik-Client und prüfen Sie den laufenden Prozess sowie die Protokolle. Starten Sie nicht sofort ein weiteres Archive, damit konkurrierende Aufgaben keine Ressourcen beanspruchen und Artefakte nicht doppelt veröffentlicht werden.

Die oben genannten SSH-Keepalive-Optionen helfen, eine unterbrochene Verbindung zu erkennen, beheben aber keinen anhaltenden Paketverlust. Testen Sie ein lokales Kabelnetz oder ein anderes vertrauenswürdiges Netzwerk und vergleichen Sie die Verbindung zum selben Server. Übergeben Sie lange Aufgaben einem Runner-Dienst oder einem verwalteten Hintergrundprozess, statt sich auf ein dauerhaft geöffnetes Terminal zu verlassen.

pgrep -fl xcodebuild
tail -n 80 ~/build.log

Der zweite Befehl funktioniert nur, wenn Sie das Protokoll unter diesem Pfad gespeichert haben. Ist die Datei nicht vorhanden, prüfen Sie den in Ihrem Build-Skript festgelegten Protokollpfad.

Nach dem Sperren des Bildschirms ist alles schwarz. Soll ich den Server neu starten?

Trennen Sie zuerst den Grafik-Client und verbinden Sie sich erneut. Vergewissern Sie sich, dass der Modus „Nur anzeigen“ nicht aktiviert ist. Prüfen Sie, ob der Client den Authentifizierungsdialog noch anzeigt. Ein schwarzer Bildschirm nach erfolgreicher Authentifizierung ist etwas anderes als eine Verbindung, die gar nicht zustande kommt.

Wenn SSH funktioniert, lassen Sie die Sitzung offen und prüfen Sie die Einstellungen der Bildschirmfreigabe, die zugelassenen Benutzer und die aktuelle Sitzung. Beenden Sie Systemprozesse für die grafische Oberfläche nicht wiederholt zwangsweise und starten Sie den Server nicht neu, solange ein Build läuft. Lässt sich das Problem nicht beheben, erstellen Sie über die Konsole ein Support-Ticket. Geben Sie an, ob der schwarze Bildschirm vor oder nach dem Sperren auftrat, und nennen Sie Client und Version.

Der Desktop ist sichtbar, aber die Zwischenablage wird nicht synchronisiert

Prüfen Sie, ob der Client die Zwischenablagefreigabe erlaubt und „Nur anzeigen“ deaktiviert ist. Testen Sie das Kopieren in beide Richtungen zunächst mit einem kurzen Text. Bilder, Dateien und Rich Text lassen sich möglicherweise nicht über denselben Zwischenablagekanal übertragen.

Prüfen Sie, ob der Client das manuelle Senden der Zwischenablage erfordert. Trennen Sie die Sitzung gegebenenfalls und verbinden Sie sich erneut. Übertragen Sie Projektdateien per SCP oder SFTP. Testen Sie die Funktion nicht mit Passwörtern, privaten Schlüsseln oder vollständigen Signaturdaten in der geteilten Zwischenablage.

SSH-Zeitüberschreitung oder fehlgeschlagene Authentifizierung

Eine Zeitüberschreitung tritt normalerweise vor der Authentifizierung auf. Prüfen Sie IP-Adresse und Port, kontrollieren Sie, ob Ihr lokales Netzwerk diesen Port blockiert, und sehen Sie sich mit ausführlicher Protokollierung an, an welcher Stelle die Verbindung hängen bleibt. Bei Permission denied prüfen Sie insbesondere Benutzername, Inhalt des öffentlichen Schlüssels, Dateiberechtigungen und den im Client ausgewählten privaten Schlüssel.

ssh -v -i ~/.ssh/armvnc_build -p 22 build@HOST_IP

Entfernen Sie aus Protokollen vor dem Einsenden unnötige sensible Angaben wie Benutzernamen, IP-Adressen und lokale Pfade. Senden Sie niemals private Schlüssel oder Passwörter. Hat sich der Host-Fingerabdruck geändert, prüfen Sie zuerst, ob der Server neu installiert oder die Instanz geändert wurde. Löschen Sie den gespeicherten Prüfeintrag nicht einfach.

Falsche Bildschirmgröße oder abweichende Tastaturbelegung

Wird das Bild abgeschnitten, prüfen Sie zuerst die Fensteranpassung oder Skalierung des Clients und anschließend unter „Systemeinstellungen → Monitore“ die Einstellungen des Servers. Nur das Fenster des Clients zu vergrößern, ändert nicht unbedingt die Auflösung des Remote-Desktops.

Bei falschen Zeichen prüfen Sie das lokale Tastaturlayout, die Tastenbelegung im Client und die Eingabemethode auf dem Remote-System. Testen Sie Buchstaben, Zahlen und Sonderzeichen zunächst in einem einfachen Texteditor, bevor Sie ein Passwort oder einen Befehl eingeben. Unter Windows entsprechen Strg und Alt möglicherweise nicht den Tasten Befehl und Wahltaste unter macOS; gegebenenfalls müssen Sie sie separat zuordnen.

Nach erfolgreicher Verbindung den ersten Build starten

Richten Sie Ihre Umgebung anhand der Anleitung ein. Bei Fragen zur Bereitstellung, Verbindung oder Abrechnung hilft Ihnen das Help Center weiter. Wenn Sie noch keinen Server gemietet haben, wählen Sie auf der Bestellseite zunächst Modell und Standort aus.

Wir unterstützen nur USDT-TRC20 sowie Visa / Mastercard / Amex (über Stripe). Abrechnung in USD. Welche Zahlungsoptionen verfügbar sind, erfahren Sie beim Checkout.