Fichiers et réseau Cloud

Cette page explique comment transférer des fichiers et des secrets vers une machine, comment ouvrir ses ports et son bureau, comment fonctionne son réseau privé et comment publier une URL.

Envoyer et télécharger des fichiers

cmux vm push envoie un fichier ou un dossier vers une machine. Le transfert est vérifié avec SHA-256. Par défaut, il ignore .git, node_modules, .venv, __pycache__ et .DS_Store. Utilisez --no-default-excludes pour les inclure, --exclude pour ignorer d'autres chemins et --watch pour renvoyer les modifications à chaque enregistrement.

cmux vm push brave-otter ./app ~/app
cmux vm push brave-otter . ~/repo --no-default-excludes
cmux vm push brave-otter . ~/repo --exclude dist --watch
cmux vm pull brave-otter ~/repo/report.html ./report.html

Un envoi peut atteindre 256 MB. Pour un dépôt volumineux, clonez-le dans la machine.

cmux vm pull télécharge un fichier depuis une machine.

Fichiers secrets

cmux vm push --secret envoie un petit fichier, jusqu'à 256 KB, via la liaison chiffrée de cmux. Le fichier est écrit avec le mode 0600 par défaut. Utilisez-le pour les clés et les identifiants au lieu d'un envoi normal.

cmux vm push --secret brave-otter ~/.npmrc ~/.npmrc

Variables d'environnement

cmux vm env enregistre les variables dans ~/.config/cmux/env sur le disque de la machine. Chaque nouveau shell les charge. Les valeurs transitent par la liaison chiffrée et ne sont pas affichées. cmux vm env ls masque les valeurs, sauf si vous ajoutez --show.

cmux vm env set brave-otter --from-file .env
op read op://dev/stripe/key | cmux vm env set brave-otter -
cmux vm env ls brave-otter
cmux vm env rm brave-otter STRIPE_KEY

Les arguments KEY=VALUE peuvent rester dans l'historique de votre shell local. Utilisez --from-file ou l'entrée standard pour les secrets.

Ports et navigateur intégré

Démarrez un serveur de développement sur une machine et faites ⌘-clic sur l'URL localhost dans le terminal Cloud. cmux l'ouvre dans un volet de navigateur à l'adresse privée de la machine. Les serveurs qui écoutent uniquement sur localhost fonctionnent aussi. Aucun VPN ni redirection de ports n'est nécessaire.

cmux vm ports liste les ports ouverts sur une machine. La barre latérale Cloud les affiche sous Ports. cmux vm open machine:port/number en ouvre un.

cmux vm ports brave-otter
cmux vm open brave-otter:port/3000

Bureau

Chaque machine dispose d'un bureau Linux. Ouvrez-le depuis le menu de la machine avec Open Desktop, ou exécutez cmux vm desktop. Il s'ouvre dans un volet de navigateur via VNC. Les apps graphiques, Chrome et l'automatisation du navigateur s'exécutent sur cet écran.

cmux vm desktop brave-otter

Réseau privé

Vos machines n'ont aucun port entrant public. cmux attribue à chaque compte un réseau privé, et chaque Mac se connecte avec sa propre clé WireGuard, qui ne quitte jamais le Mac. La connexion démarre dans l'app cmux et ne demande aucune approbation.

Vos machines peuvent communiquer entre elles sur le même réseau privé.

La page Cloud Mac access sur cmux.com liste les Mac qui peuvent accéder à vos machines. Vous pouvez y renommer ou révoquer un Mac. Révoquer un Mac le déconnecte et lui retire l'accès à toutes les machines.

VPN système (facultatif)

cmux vpn up ajoute une route système pour que d'autres apps de votre Mac, comme un autre navigateur ou un client de base de données, puissent atteindre vos machines. cmux lui-même n'en a pas besoin. La première fois, approuvez l'extension réseau de cmux dans Réglages Système › Général › Ouverture et extensions. cmux vpn down la désactive.

cmux vpn up
cmux vpn status
cmux vpn down

URL publiques

cmux cloud domains publish attribue une URL HTTPS à un port d'une machine. Le nom d'hôte généré se termine par .cmux.sh.

cmux cloud domains publish brave-otter 3000
cmux cloud domains publish brave-otter 3000 --access team
cmux cloud domains publish brave-otter 8080 --access public --yes
cmux cloud domains list
cmux cloud domains grant <hostname> teammate@example.com
cmux cloud domains rm <hostname>

Chaque URL a un mode d'accès. Par défaut, c'est le propriétaire de la machine : vous, ou votre équipe si la machine appartient à une équipe.

• personal : vous seul pouvez l'ouvrir.
• team : les membres actuels de l'équipe propriétaire de la machine peuvent l'ouvrir.
• public : toute personne disposant de l'URL peut l'ouvrir. cmux vous demande de confirmer.

Pour les URL personal et team, les visiteurs se connectent d'abord sur une page cmux. La machine ne voit jamais les cookies cmux. Vous pouvez aussi donner à une adresse e-mail l'accès à une URL précise avec cmux cloud domains grant.

Traitez une URL publique comme un mot de passe. Toute personne qui la possède peut utiliser le service.

Domaines personnalisés

cmux cloud domains verify affiche les enregistrements DNS à ajouter : un enregistrement TXT pour prouver la propriété, les enregistrements de routage et la délégation de certificat. Ajoutez-les, puis relancez verify. Une fois la vérification faite, vous pouvez publier sur le domaine ou sur un sous-domaine d'un niveau inférieur.

cmux cloud domains verify preview.example.com
cmux cloud domains publish brave-otter 3000 --domain app.preview.example.com