Archivos y red de Cloud

Esta página explica cómo transferir archivos y secretos a una máquina, cómo abrir sus puertos y su escritorio, cómo funciona su red privada y cómo publicar una URL.

Subir y descargar archivos

cmux vm push sube un archivo o una carpeta a una máquina. La transferencia se verifica con SHA-256. Por defecto omite .git, node_modules, .venv, __pycache__ y .DS_Store. Usa --no-default-excludes para incluirlos, --exclude para omitir más rutas y --watch para volver a subir los cambios cada vez que guardas.

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

Cada subida puede ocupar hasta 256 MB. Para un repositorio grande, clónalo dentro de la máquina.

cmux vm pull descarga un archivo de una máquina.

Archivos secretos

cmux vm push --secret sube un archivo pequeño, de hasta 256 KB, a través del enlace cifrado de cmux. El archivo se escribe con el modo 0600 por defecto. Úsalo para claves y credenciales en lugar de una subida normal.

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

Variables de entorno

cmux vm env guarda las variables en ~/.config/cmux/env en el disco de la máquina. Cada shell nueva las carga. Los valores viajan por el enlace cifrado y no se muestran. cmux vm env ls oculta los valores a menos que añadas --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

Los argumentos KEY=VALUE pueden quedar en el historial de tu shell local. Usa --from-file o la entrada estándar para los secretos.

Puertos y el navegador integrado

Inicia un servidor de desarrollo en una máquina y haz ⌘-clic en la URL de localhost en el terminal de Cloud. cmux la abre en un panel de navegador en la dirección privada de la máquina. Los servidores que solo escuchan en localhost también funcionan. No necesitas VPN ni reenvío de puertos.

cmux vm ports lista los puertos abiertos en una máquina. La barra lateral de Cloud los muestra en Ports. cmux vm open machine:port/number abre uno.

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

Escritorio

Cada máquina tiene un escritorio Linux. Ábrelo desde el menú de la máquina con Open Desktop o ejecuta cmux vm desktop. Se abre en un panel de navegador mediante VNC. Las apps gráficas, Chrome y la automatización del navegador se ejecutan en esta pantalla.

cmux vm desktop brave-otter

Red privada

Tus máquinas no tienen puertos de entrada públicos. cmux da a cada cuenta una red privada, y cada Mac se conecta con su propia clave de WireGuard, que nunca sale del Mac. La conexión se inicia dentro de la app de cmux y no necesita aprobación.

Tus máquinas pueden comunicarse entre sí en la misma red privada.

La página Cloud Mac access de cmux.com muestra los Mac que pueden acceder a tus máquinas. Allí puedes renombrar o revocar un Mac. Revocar un Mac cierra su sesión y elimina su acceso a todas las máquinas.

VPN del sistema (opcional)

cmux vpn up añade una ruta del sistema para que otras apps de tu Mac, como otro navegador o un cliente de bases de datos, puedan acceder a tus máquinas. cmux no la necesita. La primera vez, aprueba la extensión de red de cmux en Ajustes del Sistema › General › Ítems de inicio y extensiones. cmux vpn down la desactiva.

cmux vpn up
cmux vpn status
cmux vpn down

URL públicas

cmux cloud domains publish asigna una URL HTTPS a un puerto de una máquina. El nombre de host generado termina en .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>

Cada URL tiene un modo de acceso. Por defecto es el propietario de la máquina: tú, o tu equipo cuando la máquina pertenece a un equipo.

• personal: solo tú puedes abrirla.
• team: los miembros actuales del equipo propietario de la máquina pueden abrirla.
• public: cualquiera con la URL puede abrirla. cmux te pide que lo confirmes.

En las URL personal y team, los visitantes inician sesión primero en una página de cmux. La máquina nunca ve las cookies de cmux. También puedes dar acceso a una URL concreta a una dirección de correo con cmux cloud domains grant.

Trata una URL pública como una contraseña. Cualquiera que la tenga puede usar el servicio.

Dominios personalizados

cmux cloud domains verify muestra los registros DNS que debes añadir: un registro TXT para demostrar la propiedad, los registros de enrutamiento y la delegación del certificado. Añádelos y vuelve a ejecutar verify. Tras la verificación, puedes publicar en el dominio o en un subdominio un nivel por debajo.

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