Pour utiliser l’interface graphique, choisissez VNC ou le partage d’écran macOS. Pour les builds et les scripts, utilisez SSH. Vous vous connectez à un nœud physique Apple Silicon dédié, et non à une machine virtuelle.
Vous avez déjà une commande ? Dans les détails de l’instance, sur le portail, vérifiez l’adresse IP, le nom d’utilisateur et le port d’accès, puis suivez les étapes ci-dessous. Les adresses et ports indiqués dans ce guide sont des exemples.
AV / ACCESS / 03Un nœud, deux façons de travailler
GUI
Affichez le bureau et interagissez avec lui
Client VNC local ou partage d’écran macOS
Tunnel SSH → bureau graphique du nœud
CLI
Exécutez des builds sans transmettre l’écran
Terminal local ou runner CI
SSH → ligne de commande et processus de build
Type de machine
Machine physique dédiée
Informations de connexion
Détails de l’instance sur le portail
Exemples de ports
SSH 22 / VNC 5900
Méthode recommandée
Connexion par clé + tunnel graphique
Les ports dépendent des informations fournies pour l’instance. VNC et le partage d’écran utilisent généralement le même service graphique : ils ne correspondent pas à deux bureaux distincts.
Choisir le protocole selon la tâche
Bureau à distance ou automatisation : choisissez la bonne méthode
Interface graphique / multiplateforme
VNC
Adapté à Windows, Linux et iPad. Ouvrez Xcode à distance, vérifiez les réglages de build ou gérez les boîtes de dialogue système qui nécessitent une confirmation.
Saisissez l’adresse de l’hôte, le port et les informations d’authentification requises par le service graphique.
Privilégiez une connexion via un tunnel SSH. Une connexion VNC classique n’est pas nécessairement chiffrée.
Le client doit prendre en charge le mode d’authentification activé sur le nœud. En cas d’incompatibilité, essayez un autre réglage d’authentification.
À choisir si vous n’utilisez pas un Mac localement, mais avez besoin de l’interface graphique complète de macOS.
Interface graphique / client Mac
Partage d’écran macOS
Le choix idéal si vous utilisez un Mac localement. Le client de partage d’écran intégré à macOS est prêt à l’emploi : aucun visualiseur de bureau supplémentaire à installer.
Dans le Finder, choisissez « Aller → Se connecter au serveur », puis saisissez l’adresse VNC.
Utilisez les identifiants fournis pour le nœud, et non le mot de passe de votre Mac local.
Avec un tunnel, connectez-vous à l’adresse transférée en local. L’adresse de l’hôte distant reste dans la commande SSH.
À choisir si vous utilisez aussi un Mac et souhaitez limiter les réglages du client.
Ligne de commande / automatisation
SSH
Idéal pour exécuter xcodebuild, consulter les journaux, synchroniser des projets et gérer des runners. Sans transmission continue de l’écran, SSH convient mieux aux builds de longue durée.
Vérifiez d’abord l’empreinte de l’hôte, puis authentifiez-vous par mot de passe ou par clé.
Une session SSH interactive ne constitue pas une méthode fiable pour gérer des tâches en arrière-plan.
Pour les tâches persistantes, utilisez un service runner ou un processus géré en arrière-plan, et conservez les journaux de build.
À choisir si la tâche peut être exécutée par commande ou doit s’intégrer à un pipeline CI.
Renseigner les paramètres de connexion
Quatre systèmes, les mêmes informations de nœud
Le tableau ci-dessous prend pour exemple le port SSH 22 et le port de service VNC 5900. Si les ports réels diffèrent, remplacez les numéros correspondants. Le mot de passe du service graphique est identique ou non à celui de l’utilisateur SSH selon les informations fournies et la configuration actuelle du nœud : ne les intervertissez pas.
Comparatif des clients et des paramètres de connexion
Système local
Client graphique recommandé
Adresse et port graphiques
Accès SSH
Windows
TigerVNC Viewer, après avoir vérifié sa compatibilité avec le mode d’authentification VNC actuellement activé sur le nœud.
En connexion directe, renseignez les champs Host / Port du client. Après avoir établi le tunnel comme indiqué ci-dessous, indiquez 127.0.0.1 dans Host et 15900 dans Port.
Dans Windows Terminal, utilisez le client OpenSSH et exécutez ssh -p 22 build@HOST_IP.
Linux
Le mode VNC de Remmina ou TigerVNC Viewer, compatible avec le mode d’authentification utilisé.
Via le tunnel, connectez-vous à 127.0.0.1:15900. Si le client comporte un champ de port distinct, renseignez-le séparément sans ajouter d’indicateur d’écran.
OpenSSH dans le terminal. Connectez-vous d’abord en SSH, puis créez une redirection de port local.
macOS
L’application « Partage d’écran » intégrée.
En connexion directe, utilisez l’adresse vnc://HOST_IP:5900 ; via le tunnel, utilisez vnc://127.0.0.1:15900.
Dans le terminal, utilisez ssh. Vous pouvez également lancer l’adresse de partage d’écran avec la commande open .
iPad
Un client VNC compatible avec l’authentification macOS et les tunnels SSH.
Configurez l’hôte SSH et l’authentification dans le client, puis définissez comme cible graphique l’adresse du nœud 127.0.0.1:5900. Les noms des champs varient selon le client.
Utilisez un client SSH qui permet d’importer des clés. Vérifiez d’abord la connexion par clé, puis activez la redirection intégrée au client.
À faire dès la première connexion
Sécurisez la connexion avant d’y transférer vos tâches
01
Vérifier l’adresse et l’empreinte
Récupérez l’adresse IP du nœud, le port SSH et le nom d’utilisateur sur le portail. Lors de la première connexion, vérifiez l’empreinte de l’hôte. Si elle n’apparaît pas sur le portail, demandez confirmation via un ticket. Une réinstallation peut modifier l’empreinte : vérifiez-la avant de mettre à jour votre référence locale. Ne contournez pas l’avertissement en désactivant la vérification de l’hôte.
02
Modifier le mot de passe initial
Après la première connexion, exécutez passwd pour modifier le mot de passe de l’utilisateur actuel et vérifier le mode d’authentification du service graphique. Si vous utilisez un mot de passe VNC distinct, modifiez-le également. Ne stockez aucun mot de passe dans un dépôt, un journal de build ou un script partagé.
03
Vérifier la connexion par clé
Ajoutez la clé publique créée en local au fichier du nœud ~/.ssh/authorized_keys et gardez la clé privée uniquement sur un client de confiance. Ouvrez un nouveau terminal et vérifiez que la connexion fonctionne avant d’envisager de limiter l’authentification par mot de passe. Gardez la connexion actuelle ouverte pour éviter de vous bloquer hors du nœud après une modification.
04
Limiter l’exposition du service graphique
N’activez le service graphique que lorsque vous avez besoin du bureau. Dans macOS, vérifiez « Réglages Système → Général → Partage → Partage d’écran » et limitez les utilisateurs autorisés. Avant de désactiver ou de modifier le service, vérifiez que SSH fonctionne. Le chiffrement du tunnel n’empêche pas automatiquement le port distant d’être accessible depuis Internet.
Créez la clé en local ; seul son élément public est stocké sur le nœud
Exécutez les commandes suivantes en local. build et HOST_IP doivent être remplacés par les valeurs fournies. Lors de la création de la clé, protégez la clé privée avec une phrase secrète.
Une fois connecté au nœud, créez le répertoire, modifiez le fichier de clés publiques et définissez ses permissions. Collez la clé publique complète affichée par la commande précédente, seule sur une ligne. Ne collez pas la clé privée.
De retour en local, vérifiez la connexion :ssh -i ~/.ssh/armvnc_build -p 22 build@HOST_IP
Ouvrir le bureau graphique via un tunnel SSH
Utilisez le port local 15900 et la cible distante sur le port 5900. La redirection est liée à l’adresse de bouclage locale et n’est pas accessible aux autres appareils du réseau.
Laissez la commande s’exécuter. Si aucune erreur ne s’affiche, connectez votre client graphique au port local 15900. Sous macOS, ouvrez un autre terminal et exécutez :
open 'vnc://127.0.0.1:15900'
Le tunnel ne contourne pas l’authentification VNC. Après utilisation, quittez le client graphique, puis appuyez sur Ctrl + C dans le terminal du tunnel pour fermer la redirection.
Réduire d’abord l’affichage, puis vérifier le réseau
Ajustez la qualité selon la tâche : inutile de transmettre chaque pixel en permanence
Ces réglages de départ servent au dépannage et ne garantissent ni bande passante ni latence. La possibilité de régler la profondeur des couleurs et la compression dépend du protocole utilisé par le client. Ne modifiez qu’un paramètre à la fois et comparez toujours la même action : déplacer une fenêtre Xcode, faire défiler un journal ou saisir du texte.
Pour coder au quotidien et vérifier les builds
Résolution de départ
1440 × 900
Profondeur de couleur de départ
24 bits
Compression de départ
Automatique ou moyenne
Privilégiez la netteté du texte. Si la fenêtre du client est trop petite, activez d’abord la mise à l’échelle proportionnelle. N’augmentez pas en même temps la résolution distante et le facteur de zoom local.
Idéal pour : les réglages Xcode, la consultation des journaux et une utilisation occasionnelle de l’interface graphique.
Pour les connexions longue distance ou les réseaux limités
Résolution de départ
1280 × 800
Profondeur de couleur de départ
16 bits (si disponible)
Compression de départ
Élevée
Commencez par désactiver les animations du bureau et les aperçus inutiles. Une compression élevée peut réduire le niveau de détail : elle diminue le volume de données transmis, mais pas le temps d’aller-retour du réseau.
Idéal pour : les nœuds éloignés, les réseaux mobiles et les interventions ponctuelles en cas de pertes de paquets.
Pour les archives de longue durée et l’automatisation
Connexion principale
SSH
Session graphique
À la demande
Gestion des tâches
Service runner
Lorsque vous n’avez pas besoin de voir l’écran, enregistrez directement les journaux et les artefacts de build. La déconnexion du client graphique ne ferme pas la session macOS et ne doit pas servir à arrêter une tâche.
Idéal pour : les processus CI permanents, les scripts sans surveillance et les builds répétitifs.
Choisissez aussi le nœud en fonction de son usage : pour un bureau interactif, le chemin réseau entre vous et le nœud compte davantage ; pour les builds seuls, tenez aussi compte du téléchargement du dépôt et des dépendances, ainsi que du transfert des artefacts. La fluidité d’un seul déplacement de souris ne permet pas de juger les performances de compilation.
Cerner le problème à partir des symptômes
Distinguer réseau, authentification et session graphique
Testez d’abord SSH, puis la connexion graphique. Si SSH fonctionne mais que VNC échoue, vérifiez le service graphique et la cible du tunnel. Si aucun des deux ne fonctionne, contrôlez d’abord l’état de l’instance, l’adresse, le réseau local et les ports. Ne commencez pas par réinstaller le système.
La connexion se coupe sans cesse : faut-il relancer les tâches après s’être reconnecté ?
Commencez par distinguer la coupure de la connexion de l’arrêt de la tâche. Après avoir rétabli SSH ou la connexion graphique, vérifiez le processus en cours et ses journaux. Ne relancez pas immédiatement un nouvel archivage : des tâches simultanées pourraient se disputer les ressources ou publier plusieurs fois les mêmes artefacts.
Les options de maintien de la connexion SSH décrites plus haut peuvent aider à repérer une liaison interrompue, mais elles ne corrigent pas les pertes de paquets persistantes. Testez une connexion filaire locale ou un autre réseau de confiance, puis comparez les résultats sur le même nœud. Confiez les tâches longues à un service runner ou à un processus géré en arrière-plan, plutôt que de laisser un terminal ouvert en permanence.
pgrep -fl xcodebuild
tail -n 80 ~/build.log
La deuxième commande ne s’applique que si vous avez enregistré les journaux à cet emplacement. Si ce fichier n’existe pas, recherchez le chemin des journaux défini dans votre script de build.
L’écran est noir après le verrouillage : faut-il redémarrer le nœud ?
Fermez d’abord le client graphique, puis reconnectez-vous et vérifiez que le mode « affichage seul » n’est pas activé. Vérifiez si le client affiche encore l’écran d’authentification : un écran noir après authentification n’est pas le même problème qu’une connexion impossible.
Si SSH fonctionne, gardez la session ouverte et vérifiez les réglages du partage d’écran, les utilisateurs autorisés et la session actuelle. Évitez de forcer à répétition l’arrêt des processus graphiques du système et ne redémarrez pas le nœud tant qu’un build est en cours. Si le problème persiste, ouvrez un ticket sur le portail en précisant si l’écran noir est apparu avant ou après le verrouillage, ainsi que le nom et la version du client.
Le bureau s’affiche, mais le presse-papiers ne se synchronise pas
Vérifiez que le client autorise le partage du presse-papiers et désactivez le mode « affichage seul ». Commencez par tester la copie dans les deux sens avec un court texte brut. Les images, les fichiers et le texte enrichi ne passent pas nécessairement par le même canal du presse-papiers.
Vérifiez si le client exige l’envoi manuel du contenu du presse-papiers et, si nécessaire, déconnectez-vous puis rétablissez la session. Pour transférer des fichiers de projet, utilisez SCP ou SFTP. Ne testez pas le partage en plaçant des mots de passe, des clés privées ou des données de signature complètes dans le presse-papiers partagé.
Délai d’attente SSH dépassé ou échec de l’authentification
Un délai d’attente dépassé survient généralement avant l’authentification. Vérifiez l’adresse IP et le port, puis assurez-vous que le réseau local ne bloque pas ce port. Activez ensuite les journaux détaillés pour voir à quelle étape la connexion s’arrête. Si le message Permission denied apparaît, vérifiez surtout le nom d’utilisateur, le contenu de la clé publique, les permissions des fichiers et la clé privée sélectionnée dans le client.
ssh -v -i ~/.ssh/armvnc_build -p 22 build@HOST_IP
Avant d’envoyer des journaux, supprimez les informations non nécessaires, comme le nom d’utilisateur, l’adresse IP et les chemins locaux sensibles. N’envoyez jamais de clé privée ni de mot de passe. Si l’empreinte de l’hôte a changé, vérifiez d’abord si une réinstallation ou une modification de l’instance a eu lieu ; ne supprimez pas directement l’enregistrement de vérification.
La taille de l’écran est incorrecte ou les touches ne produisent pas les mêmes symboles qu’en local
Si l’image est recadrée, vérifiez d’abord les options d’ajustement à la fenêtre ou de mise à l’échelle du client, puis les réglages « Réglages Système → Moniteurs » du nœud. Modifier uniquement la taille de la fenêtre du client ne change pas nécessairement la résolution du bureau distant.
Si les touches ne correspondent pas, vérifiez la disposition locale, le mappage du clavier dans le client et la méthode de saisie distante. Testez d’abord les lettres, les chiffres et les symboles dans un éditeur de texte ordinaire, avant de saisir un mot de passe ou une commande. Sous Windows, Ctrl / Alt et, sous macOS, Command / Option peuvent nécessiter un mappage distinct.
Une fois connecté, lancez votre premier build
Préparez l’environnement à l’aide du guide de démarrage. Pour toute question sur l’activation, la connexion ou la facturation, consultez le centre d’aide. Vous n’avez pas encore loué de machine ? Choisissez un modèle et un nœud sur la page de commande.
Paiement par USDT-TRC20 ou Visa / Mastercard / Amex (via Stripe) uniquement. Facturation en USD. Les moyens disponibles sont ceux proposés au moment du paiement.