Cloud-Dateien und Netzwerk

Diese Seite erklärt, wie du Dateien und Secrets auf eine Maschine überträgst, wie du ihre Ports und ihren Desktop öffnest, wie ihr privates Netzwerk funktioniert und wie du eine URL veröffentlichst.

Dateien hoch- und herunterladen

cmux vm push lädt eine Datei oder einen Ordner auf eine Maschine hoch. Die Übertragung wird mit SHA-256 geprüft. Standardmäßig werden .git, node_modules, .venv, __pycache__ und .DS_Store übersprungen. Mit --no-default-excludes schließt du sie ein, mit --exclude überspringst du weitere Pfade, und mit --watch werden Änderungen beim Speichern erneut hochgeladen.

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

Ein Upload darf bis zu 256 MB groß sein. Klone ein großes Repository innerhalb der Maschine.

cmux vm pull lädt eine Datei von einer Maschine herunter.

Geheime Dateien

cmux vm push --secret lädt eine kleine Datei mit bis zu 256 KB über die verschlüsselte cmux-Verbindung hoch. Die Datei wird standardmäßig mit dem Modus 0600 geschrieben. Nutze dies für Schlüssel und Anmeldedaten statt eines normalen Uploads.

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

Umgebungsvariablen

cmux vm env speichert Variablen in ~/.config/cmux/env auf der Festplatte der Maschine. Jede neue Shell lädt sie. Werte werden über die verschlüsselte Verbindung übertragen und nicht ausgegeben. cmux vm env ls blendet Werte aus, außer du fügst --show hinzu.

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

KEY=VALUE-Argumente können in deinem lokalen Shell-Verlauf landen. Nutze für Secrets --from-file oder die Standardeingabe.

Ports und der In-App-Browser

Starte einen Dev-Server auf einer Maschine und klicke mit ⌘ auf die localhost-URL im Cloud-Terminal. cmux öffnet sie in einem Browser-Pane unter der privaten Adresse der Maschine. Auch Server, die nur auf localhost lauschen, funktionieren. Du brauchst weder VPN noch Portweiterleitung.

cmux vm ports listet die offenen Ports einer Maschine auf. Die Cloud-Seitenleiste zeigt sie unter Ports. cmux vm open machine:port/number öffnet einen davon.

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

Desktop

Jede Maschine hat einen Linux-Desktop. Öffne ihn über das Maschinenmenü mit Open Desktop oder führe cmux vm desktop aus. Er öffnet sich über VNC in einem Browser-Pane. GUI-Apps, Chrome und Browser-Automatisierung laufen auf diesem Display.

cmux vm desktop brave-otter

Privates Netzwerk

Deine Maschinen haben keine öffentlichen eingehenden Ports. cmux gibt jedem Konto ein privates Netzwerk, und jeder Mac verbindet sich mit seinem eigenen WireGuard-Schlüssel, der den Mac nie verlässt. Die Verbindung startet innerhalb der cmux-App und erfordert keine Freigabe.

Deine Maschinen können sich gegenseitig über dasselbe private Netzwerk erreichen.

Die Seite Cloud Mac access auf cmux.com listet die Macs auf, die deine Maschinen erreichen können. Dort kannst du einen Mac umbenennen oder widerrufen. Das Widerrufen eines Mac meldet ihn ab und entfernt seinen Zugriff auf alle Maschinen.

System-VPN (optional)

cmux vpn up fügt eine Systemroute hinzu, damit andere Apps auf deinem Mac, etwa ein separater Browser oder ein Datenbank-Client, deine Maschinen erreichen können. cmux selbst braucht sie nicht. Genehmige beim ersten Mal die cmux-Netzwerkerweiterung unter Systemeinstellungen › Allgemein › Anmeldeobjekte & Erweiterungen. cmux vpn down schaltet sie wieder aus.

cmux vpn up
cmux vpn status
cmux vpn down

Öffentliche URLs

cmux cloud domains publish gibt einem Port auf einer Maschine eine HTTPS-URL. Der generierte Hostname endet auf .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>

Jede URL hat einen Zugriffsmodus. Standard ist der Eigentümer der Maschine: du selbst oder dein Team, wenn die Maschine einem Team gehört.

• personal: Nur du kannst sie öffnen.
• team: Aktuelle Mitglieder des Teams, dem die Maschine gehört, können sie öffnen.
• public: Jeder mit der URL kann sie öffnen. cmux bittet dich um eine Bestätigung.

Bei personal- und team-URLs melden sich Besucher zuerst auf einer cmux-Seite an. Die Maschine sieht nie cmux-Cookies. Mit cmux cloud domains grant kannst du auch einer einzelnen E-Mail-Adresse Zugriff auf eine einzelne URL geben.

Behandle eine öffentliche URL wie ein Passwort. Jeder, der sie hat, kann den Dienst nutzen.

Eigene Domains

cmux cloud domains verify gibt die DNS-Einträge aus, die du hinzufügen musst: einen TXT-Eintrag für den Eigentumsnachweis, die Routing-Einträge und die Zertifikatsdelegation. Füge sie hinzu und führe verify erneut aus. Nach der Verifizierung kannst du auf der Domain oder auf einer Subdomain eine Ebene darunter veröffentlichen.

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