File e rete Cloud

Questa pagina spiega come trasferire file e segreti su una macchina, come aprirne le porte e il desktop, come funziona la sua rete privata e come pubblicare un URL.

Caricare e scaricare file

cmux vm push carica un file o una cartella su una macchina. Il trasferimento viene verificato con SHA-256. Per impostazione predefinita esclude .git, node_modules, .venv, __pycache__ e .DS_Store. Usa --no-default-excludes per includerli, --exclude per escludere altri percorsi e --watch per ricaricare le modifiche a ogni salvataggio.

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 singolo caricamento può arrivare a 256 MB. Per un repository grande, clonalo all'interno della macchina.

cmux vm pull scarica un file da una macchina.

File segreti

cmux vm push --secret carica un file piccolo, fino a 256 KB, tramite il collegamento cifrato di cmux. Il file viene scritto con la modalità 0600 per impostazione predefinita. Usalo per chiavi e credenziali invece di un caricamento normale.

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

Variabili d'ambiente

cmux vm env salva le variabili in ~/.config/cmux/env sul disco della macchina. Ogni nuova shell le carica. I valori viaggiano sul collegamento cifrato e non vengono mostrati. cmux vm env ls nasconde i valori a meno che tu non aggiunga --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

Gli argomenti KEY=VALUE possono restare nella cronologia della tua shell locale. Per i segreti usa --from-file o lo standard input.

Porte e browser integrato

Avvia un server di sviluppo su una macchina e fai ⌘-clic sull'URL localhost nel terminale Cloud. cmux lo apre in un riquadro del browser all'indirizzo privato della macchina. Funzionano anche i server che ascoltano solo su localhost. Non servono VPN né inoltro delle porte.

cmux vm ports elenca le porte aperte su una macchina. La barra laterale Cloud le mostra sotto Ports. cmux vm open machine:port/number ne apre una.

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

Desktop

Ogni macchina ha un desktop Linux. Aprilo dal menu della macchina con Open Desktop oppure esegui cmux vm desktop. Si apre in un riquadro del browser tramite VNC. App con interfaccia grafica, Chrome e automazione del browser girano su questo schermo.

cmux vm desktop brave-otter

Rete privata

Le tue macchine non hanno porte in ingresso pubbliche. cmux assegna a ogni account una rete privata, e ogni Mac si collega con la propria chiave WireGuard, che non lascia mai il Mac. La connessione si avvia all'interno dell'app cmux e non richiede approvazioni.

Le tue macchine possono raggiungersi a vicenda sulla stessa rete privata.

La pagina Cloud Mac access su cmux.com elenca i Mac che possono raggiungere le tue macchine. Lì puoi rinominare o revocare un Mac. Revocare un Mac ne effettua la disconnessione e rimuove il suo accesso a tutte le macchine.

VPN di sistema (facoltativa)

cmux vpn up aggiunge una rotta di sistema in modo che altre app sul tuo Mac, come un browser separato o un client di database, possano raggiungere le tue macchine. cmux non ne ha bisogno. La prima volta, approva l'estensione di rete di cmux in Impostazioni di Sistema › Generali › Elementi login ed estensioni. cmux vpn down la disattiva.

cmux vpn up
cmux vpn status
cmux vpn down

URL pubblici

cmux cloud domains publish assegna un URL HTTPS a una porta di una macchina. Il nome host generato termina con .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>

Ogni URL ha una modalità di accesso. Quella predefinita è il proprietario della macchina: tu, oppure il tuo team quando la macchina appartiene a un team.

• personal: solo tu puoi aprirlo.
• team: i membri attuali del team proprietario della macchina possono aprirlo.
• public: chiunque abbia l'URL può aprirlo. cmux ti chiede di confermare.

Per gli URL personal e team, i visitatori accedono prima su una pagina cmux. La macchina non vede mai i cookie di cmux. Puoi anche concedere a un indirizzo email l'accesso a un singolo URL con cmux cloud domains grant.

Tratta un URL pubblico come una password. Chiunque lo possieda può usare il servizio.

Domini personalizzati

cmux cloud domains verify stampa i record DNS da aggiungere: un record TXT per la proprietà, i record di instradamento e la delega del certificato. Aggiungili ed esegui di nuovo verify. Dopo la verifica puoi pubblicare sul dominio o su un sottodominio di un livello inferiore.

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