# Облачные файлы и сеть

На этой странице описано, как передавать файлы и секреты на машину, как открывать ее порты и рабочий стол, как работает ее частная сеть и как опубликовать URL.

## Загрузка и скачивание файлов

cmux vm push загружает файл или папку на машину. Передача проверяется с помощью SHA-256. По умолчанию пропускаются .git, node\_modules, .venv, \_\_pycache\_\_ и .DS\_Store. Используйте --no-default-excludes, чтобы включить их, --exclude, чтобы пропустить другие пути, и --watch, чтобы повторно загружать изменения при сохранении.

```
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
```

Одна загрузка может занимать до 256 MB. Большой репозиторий клонируйте внутри машины.

cmux vm pull скачивает файл с машины.

## Секретные файлы

cmux vm push --secret загружает небольшой файл, до 256 KB, по зашифрованному каналу cmux. По умолчанию файл записывается с режимом 0600. Используйте его для ключей и учетных данных вместо обычной загрузки.

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

## Переменные окружения

cmux vm env хранит переменные в ~/.config/cmux/env на диске машины. Каждая новая оболочка их загружает. Значения передаются по зашифрованному каналу и не выводятся на экран. cmux vm env ls скрывает значения, если не добавить --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
```

Аргументы KEY=VALUE могут остаться в истории вашей локальной оболочки. Для секретов используйте --from-file или стандартный ввод.

## Порты и встроенный браузер

Запустите dev-сервер на машине и щелкните с ⌘ по URL localhost в облачном терминале. cmux откроет его в панели браузера по частному адресу машины. Серверы, которые слушают только localhost, тоже работают. VPN или проброс портов не нужны.

cmux vm ports показывает открытые порты машины. Боковая панель Cloud показывает их в разделе Ports. cmux vm open machine:port/number открывает один из них.

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

## Рабочий стол

У каждой машины есть рабочий стол Linux. Откройте его из меню машины с помощью Open Desktop или выполните cmux vm desktop. Он открывается в панели браузера через VNC. На этом экране работают GUI-приложения, Chrome и автоматизация браузера.

```
cmux vm desktop brave-otter
```

## Частная сеть

У ваших машин нет публичных входящих портов. cmux дает каждому аккаунту частную сеть, и каждый Mac подключается со своим ключом WireGuard, который никогда не покидает этот Mac. Соединение запускается внутри приложения cmux и не требует подтверждения.

Ваши машины могут обращаться друг к другу в той же частной сети.

Страница Cloud Mac access на cmux.com показывает компьютеры Mac, которые могут подключаться к вашим машинам. Там можно переименовать Mac или отозвать его доступ. Отзыв выполняет выход на этом Mac и лишает его доступа ко всем машинам.

## Системный VPN (необязательно)

cmux vpn up добавляет системный маршрут, чтобы другие приложения на вашем Mac, например отдельный браузер или клиент базы данных, могли подключаться к вашим машинам. Самому cmux он не нужен. При первом запуске разрешите сетевое расширение cmux в Системные настройки › Основные › Объекты входа и расширения. cmux vpn down отключает его.

```
cmux vpn up
cmux vpn status
cmux vpn down
```

## Публичные URL

cmux cloud domains publish назначает порту на машине URL с HTTPS. Сгенерированное имя хоста заканчивается на .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>
```

У каждого URL есть режим доступа. По умолчанию используется владелец машины: вы или ваша команда, если машина принадлежит команде.

-   personal: открыть URL можете только вы.
-   team: открыть URL могут текущие участники команды, которой принадлежит машина.
-   public: открыть URL может любой, у кого он есть. cmux попросит подтверждение.

Для URL personal и team посетители сначала входят в аккаунт на странице cmux. Машина никогда не видит cookie cmux. Также можно дать доступ к одному URL одному адресу электронной почты с помощью cmux cloud domains grant.

Относитесь к публичному URL как к паролю. Любой, у кого он есть, может пользоваться сервисом.

## Собственные домены

cmux cloud domains verify выводит DNS-записи, которые нужно добавить: запись TXT для подтверждения владения, записи маршрутизации и делегирование сертификата. Добавьте их и снова выполните verify. После проверки можно публиковать на домене или на поддомене на один уровень ниже.

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

Canonical: https://cmux.com/ru/docs/cloud/networking

Documentation index: https://cmux.com/llms.txt