Verbindungsanleitung · Zugangsdaten bereithalten

So verbinden Sie sich mit Ihrem Mac mini

Prüfen Sie zunächst per SSH den Kommandozeilenzugriff und öffnen Sie anschließend den VNC-Desktop. Wenn Sie den Zugriff aus dem öffentlichen Internet einschränken möchten, leiten Sie VNC über einen SSH-Tunnel. Sie mieten einen dedizierten physischen Mac, keine virtuelle Maschine. Die gültige Adresse, der Port und das Konto finden Sie in den Zugangsdaten in der Konsole.

Noch kein Rechner? Wählen Sie zuerst Modell und Standort. Sie haben bereits bestellt? Melden Sie sich in der Konsole an, rufen Sie die Verbindungsdaten Ihrer Instanz auf und beginnen Sie mit Schritt 1.

Verbindungs-ChecklisteSSH → VNC → CI

Notieren Sie diese vier Angaben aus der Konsole, bevor Sie loslegen. Senden Sie Passwörter oder private Schlüssel nicht über ein Support-Ticket.

Hostadresse
Adresse aus den Verbindungsdaten der Instanz
SSH-Port
Port aus den Verbindungsdaten der Instanz
Benutzerkonto
Der für Sie eingerichtete Benutzername
Desktopverbindung
VNC-Adresse und Zugangsdaten
SSH-Zugang testenDesktop und Build einrichten
01 / Kommandozeile

Erst per SSH verbinden, dann auf Schlüssel umstellen

SSH ist eine verschlüsselte Verbindung zur Kommandozeile. Unter macOS und Linux verwenden Sie das Terminal, unter Windows PowerShell. Ersetzen Sie Adresse, Port und Benutzernamen im Beispiel durch die Angaben aus der Konsole.

Erste Anmeldung

  1. 01Instanz und Port prüfen. Prüfen Sie in der Konsole, ob der Rechner bereitgestellt wurde, und kopieren Sie anschließend SSH-Adresse, Port und Benutzernamen. Vergleichen Sie den Host-Fingerprint bei der ersten Verbindung mit den bereitgestellten Angaben.
  2. 02Öffentlichen Schlüssel vorbereiten. Erstellen Sie auf Ihrem eigenen Rechner ein Ed25519-Schlüsselpaar. Der private Schlüssel bleibt lokal. Fügen Sie nur den öffentlichen Schlüssel, der mit ssh-ed25519 beginnt, dem entfernten Konto in ~/.ssh/authorized_keyshinzu.
  3. 03Mit einem zweiten Terminal testen. Lassen Sie die erste Sitzung geöffnet und prüfen Sie in einem neuen Terminal, ob die Anmeldung mit dem öffentlichen Schlüssel funktioniert. Deaktivieren Sie die Passwortanmeldung für das Konto erst nach erfolgreichem Test und gemäß Ihren Sicherheitsvorgaben. Schalten Sie Passwörter nicht ab, bevor Sie die Schlüsselanmeldung getestet haben.
Lokales TerminalPlatzhalter durch die bereitgestellten Angaben ersetzen
ssh -p <SSH-Port> <Benutzername>@<Hostadresse>

ssh-keygen -t ed25519 -C "cloud-mac"
cat ~/.ssh/id_ed25519.pub

ssh -i ~/.ssh/id_ed25519 \
  -p <SSH-Port> <Benutzername>@<Hostadresse>

Wenn auf Ihrem Rechner bereits Schlüssel vorhanden sind, prüfen Sie zuerst die Dateinamen, damit Sie keinen privaten Schlüssel überschreiben. Kopieren Sie den öffentlichen Schlüssel vollständig in einer Zeile und setzen Sie die Berechtigungen für das entfernte ~/.ssh und die Datei authorized_keys auf 700 bzw. 600.

02 / Grafischer Desktop

VNC für die Xcode-Oberfläche öffnen

Mit VNC wird die Mac-Desktopanzeige auf Ihren Rechner übertragen und lässt sich aus der Ferne bedienen. Prüfen Sie zuerst die in der Konsole bereitgestellte Desktopadresse, den Port und die Authentifizierung. Diese Angaben müssen nicht mit denen für SSH übereinstimmen.

Verbindung von macOS

Bildschirmfreigabe verwenden

Öffnen Sie „Bildschirmfreigabe“ und geben Sie die bereitgestellte VNC-Adresse samt Port ein. Wenn Sie den SSH-Tunnel weiter unten eingerichtet haben, verbinden Sie sich stattdessen mit der lokalen Adresse und dem lokalen Port. Verwenden Sie zur Anmeldung die bereitgestellten Zugangsdaten, nicht Ihren SSH-Privatschlüssel.

Ideal für die direkte Arbeit mit Xcode, Simulator und Systemeinstellungen.

Verbindung von Windows oder Linux

Verbindungsdaten im VNC-Client eingeben

Geben Sie im Client Host, Port und die bereitgestellten Zugangsdaten getrennt ein. Wenn der Client eine einzelne Adresse erwartet, verwenden Sie das Format „Host:Port“ gemäß dessen Anleitung. Nutzen Sie vorzugsweise einen SSH-Tunnel und stellen Sie als Ziel die lokale Loopback-Adresse ein.

Wählen Sie im Client das VNC-Protokoll. Verwenden Sie nicht den SSH-Port für den Desktop.

Bei ruckelnder Anzeige diese zwei Einstellungen anpassen

Reduzieren Sie die Bildqualität von „Hoch“ auf „Mittel“ und senken Sie die angeforderte Bildrate. Testen Sie die Verbindung zunächst mit einem Bildschirm und einer passenden Desktopauflösung. Wenn Tastatureingaben flüssiger ankommen als das Bild, prüfen Sie zuerst die Netzwerkroute zum Standort, statt gleich die Entwicklungsumgebung neu zu installieren.

03 / Sichere Verbindung

VNC über einen SSH-Tunnel weiterleiten

Ein SSH-Tunnel leitet einen lokalen Port auf Ihrem Rechner sicher an den entfernten Desktop-Port weiter. Der Client verbindet sich nur mit Ihrem eigenen Rechner – Sie müssen VNC nicht für den bequemen Zugriff zusätzlich im öffentlichen Internet freigeben. Prüfen Sie vorab, ob die bereitgestellten Verbindungsdaten diese Methode zulassen.

In drei Schritten weiterleiten

  1. 01Ports prüfen. Prüfen Sie den SSH-Port und den entfernten VNC-Port getrennt. Der Beispielport 5901 ist ein freier Port, den Sie lokal auswählen. Er bedeutet nicht, dass der Server diesen Port fest verwendet.
  2. 02Tunnel geöffnet lassen. Führen Sie den Weiterleitungsbefehl im lokalen Terminal aus und lassen Sie das Terminal geöffnet.-N bedeutet, dass nur die Weiterleitung eingerichtet und kein entfernter Befehl gestartet wird.
  3. 03Lokal verbinden. Verbinden Sie sich in der Bildschirmfreigabe oder im VNC-Client mit 127.0.0.1:5901. Beenden Sie nach der Nutzung zuerst den Client und schließen Sie anschließend das Terminal mit dem Tunnel.
Lokales TerminalFür den entfernten Port gelten die bereitgestellten Angaben
ssh -N \
  -L 127.0.0.1:5901:127.0.0.1:<Remote-VNC-Port> \
  -p <SSH-Port> \
  <Benutzername>@<Hostadresse>

Wenn der lokale Port 5901 bereits belegt ist, ändern Sie nur den ersten Port in -L und verwenden Sie denselben neuen Port im VNC-Client. Ändern Sie nicht den entfernten Port, um einen lokalen Portkonflikt zu beheben.

04 / Automatisierte Builds

Diesen Mac als Self-Hosted Runner registrieren

Ein Self-Hosted Runner führt CI-Aufgaben auf Ihrem eigenen Rechner aus. Melden Sie sich zuerst per SSH an und prüfen Sie, ob die Xcode-Kommandozeilenwerkzeuge verfügbar sind. Erstellen Sie dann in den Projekteinstellungen Ihres CI-Dienstes ein Registrierungstoken. Hinterlegen Sie einmalige Token weder im Repository noch in Build-Logs.

GitHub Actions

Rechner für Repository oder Organisation registrieren

Wählen Sie in den Runner-Einstellungen des Projekts macOS als Betriebssystem und registrieren Sie den Runner auf dem Mac in der Cloud mit den aktuellen Installations- und Konfigurationsbefehlen auf der Seite. Verwenden Sie aussagekräftige Labels für Modell, Standort und Einsatzzweck, zum Beispiel macos, m4undios-build. Das runs-on Label im Workflow muss mit einem tatsächlich vergebenen Label übereinstimmen.

Führen Sie nach der Registrierung zuerst einen kleinen Testjob aus, der nur xcodebuild -version ausführt. Erst danach sollten Sie reguläre Builds starten.

GitLab Runner

Runner in den Projekteinstellungen registrieren

Rufen Sie die Registrierungsanleitung für das aktuelle Projekt auf, installieren Sie auf dem Mac in der Cloud eine passende Runner-Version und wählen Sie die für Ihr Projekt geeignete Shell-Ausführung. Vergeben Sie klare Labels für Standort und Build. Prüfen Sie, ob geschützte Jobs von diesem Runner ausgeführt werden dürfen, und starten Sie anschließend eine Testpipeline.

Prüfen Sie zuerst, ob der Job auf Xcode, Signiermaterial und Projektabhängigkeiten zugreifen kann, bevor Sie die Parallelität erhöhen.

Vor dem Autostart erst einen Neustart testen

Richten Sie den Prozess über die offizielle Dienstinstallation des verwendeten Runners als macOS-Hintergrunddienst ein und legen Sie fest, unter welchem Konto er läuft. Prüfen Sie nach einem Neustart den Dienststatus und führen Sie einen Testjob aus. Ein Build im interaktiven Terminal garantiert nicht, dass der Hintergrunddienst auf dieselben Umgebungsvariablen oder den Schlüsselbund zugreifen kann. Widerrufen Sie vor Ende der Mietdauer das Registrierungstoken und sichern Sie alle Ergebnisse, die Sie behalten möchten.

05 / Standort wählen

Beim Remote Desktop zählt vor allem die Entfernung

Verfügbar sind vier Standorte: Singapur, Japan (Tokio), Südkorea (Seoul) und Hongkong. Wählen Sie den Standort in der Nähe der Personen, die hauptsächlich mit dem Rechner arbeiten, und testen Sie SSH-Reaktionszeit sowie Desktopbedienung über das tatsächliche Büronetz. Internationale Verbindungen, Paketverluste und das lokale Netzwerk beeinflussen die Ergebnisse ebenfalls – der Standortname allein sagt nichts über die Latenz aus.

Orientierungshilfe zur Standortwahl
StandortGeeignete TeamstandorteBei der Verbindung prüfen
SingapurEntwicklungs- und Build-Teams in SüdostasienTatsächliche Round-Trip-Latenz vom Büronetz zum Standort
Japan (Tokio)Entwicklungsteams in Japan und der UmgebungStabilität der Desktopbedienung und der Übertragung von Build-Artefakten
Südkorea (Seoul)Entwicklungsteams in Südkorea und NordostasienPaketverluste zu Spitzenzeiten
HongkongKollaborierende Teams in Südchina und SüdostasienIndividueller Zugriffsweg der Teammitglieder

Beide Modellvarianten sind an allen vier Standorten verfügbar. Den aktuellen Lagerstatus bei der Bestellung sehen Sie in der Konsole. Ist Ihr Team über mehrere Standorte verteilt, wählen Sie den Standort danach, wo die Personen sitzen, die den Desktop täglich nutzen. Berücksichtigen Sie für CI-Aufgaben zusätzlich den Übertragungsweg für Quellcode und Build-Artefakte.

06 / Zusammenarbeit mit mehreren Rechnern

Thunderbolt 5 für mehrere Macs nur bei Bedarf hinzunehmen

Thunderbolt 5 eignet sich für Builds, bei denen mehrere Rechner am selben Standort zusammenarbeiten, oder für Workflows mit häufigem Austausch großer Dateien. Die Zusatzoption wird pro Rechner berechnet:$1/Tag. Ob sie sich lohnt, hängt von den Anforderungen an Datenübertragung und Parallelität ab. Für VNC oder CI auf einem einzelnen Rechner ist sie nicht erforderlich.

Geeignet, wenn

Aufgaben auf mehrere Rechner verteilt werden können

Sie können zum Beispiel mehrere App-Targets, Test-Shards oder Builds verschiedener Versionen auf separate Runner verteilen. Vergeben Sie für jeden Rechner eigene Labels, damit Jobs nicht versehentlich auf einem Knoten ohne die benötigten Tools ausgeführt werden.

Messen Sie zunächst die Dauer auf einem einzelnen Rechner und schätzen Sie dann den möglichen Parallelisierungsgewinn ab.

Vorher prüfen

Deckt der Übertragungsgewinn den Konfigurationsaufwand?

Wenn Builds hauptsächlich auf Signierung, Abhängigkeitsdownloads oder externe Schnittstellen warten, ist die gekoppelte Verbindung möglicherweise nicht der Engpass. Erfassen Sie Dateigrößen, Übertragungshäufigkeit und Rechnerzahl und prüfen Sie anschließend die Zusatzoption in der Bestellkonfiguration.

Die Zusammenarbeit zwischen verschiedenen Standorten lässt sich nicht allein über eine lokale Kopplung realisieren.

07 / Fehlerbehebung

Keine Verbindung? So grenzen Sie die Ursache ein

Prüfen Sie zuerst in der Konsole den Status der Instanz, die Adresse und die Ports. Grenzen Sie dann ein, ob das Problem SSH, VNC oder Ihr lokales Netzwerk betrifft. Setzen Sie die Umgebung nicht wiederholt zurück, bevor Sie Ihre Build-Artefakte gesichert haben.

VNC ist verbunden, aber der Bildschirm bleibt schwarz

Prüfen Sie zuerst, ob die SSH-Anmeldung weiterhin funktioniert, und trennen Sie dann die Desktopverbindung, bevor Sie sie erneut herstellen. Kontrollieren Sie die VNC-Zugangsdaten, den laufenden Tunnel und ob der Client den lokalen Weiterleitungsport oder den bereitgestellten Direktport verwendet. Funktioniert SSH, bleiben aber mehrere Clients dauerhaft schwarz, erstellen Sie über die Konsole ein Support-Ticket mit Instanznummer, Zeitpunkt und Screenshot.

Bild zu klein, abgeschnitten oder mit falscher Auflösung

Deaktivieren Sie zuerst die feste Skalierung im Client und prüfen Sie anschließend die macOS-Anzeigeeinstellungen. Testen Sie den Remote Desktop zunächst mit einem Bildschirm und einer gängigen Auflösung. Stellen Sie die Verbindung nach Änderungen erneut her, um Probleme mit den Server-Anzeigeeinstellungen von der Clientskalierung zu unterscheiden.

Tastaturzeichen oder Tastenkürzel sind falsch zugeordnet

Prüfen Sie, ob auf Ihrem lokalen und dem entfernten Rechner dasselbe Tastaturlayout eingestellt ist – insbesondere für Satzzeichen sowie die Tasten Option und Command. Kontrollieren Sie im Client die Zuordnung der Sondertasten. Testen Sie zunächst einige Zeichen in einem Texteditor, bevor Sie Befehle eingeben oder die Signierkonfiguration ändern.

Sitzung getrennt – so setzen Sie die Arbeit fort

Stellen Sie zuerst die SSH-Verbindung wieder her. Wenn Sie einen Tunnel verwenden, starten Sie die Weiterleitung erneut und verbinden Sie sich anschließend mit dem lokalen VNC-Port. Lassen Sie Build-Aufgaben möglichst von einem Hintergrund-Runner ausführen, statt auf eine dauerhaft offene Desktop-Sitzung angewiesen zu sein. Können SSH und VNC nicht wiederhergestellt werden, erstellen Sie über die Konsole ein Support-Ticket und fügen Sie Bestellnummer, Standort-ID und einen Screenshot der Fehlermeldung bei.

Los geht’s

Erst einen Tag mieten und Verbindung sowie Build testen

Beginnen Sie mit einem kleinen SSH-Job und prüfen Sie, ob Desktop und CI Ihren Anforderungen entsprechen. Entscheiden Sie danach, ob Sie die Mietdauer verlängern oder weitere Rechner hinzunehmen. Sie benötigen Hilfe mit einer bestehenden Instanz? Melden Sie sich in der Konsole an und erstellen Sie ein Support-Ticket.