Памятка по удалённому подключению

За 10 минут после включения
подключитесь к Mac

Сначала проверьте подключение по SSH, затем откройте общий экран. Вы получите выделенный физический Mac mini с полноценным доступом к графическому интерфейсу macOS и командной строке — для удалённой работы, сборок и тестирования.

Десять минут — это ориентир для подключения после получения учётных данных, при готовых клиенте и сети, а не срок предоставления заказа. Адрес, порт и способ аутентификации смотрите в консоли.

Выберите способ подключения

Для рабочего стола — общий экран, для автоматизации — SSH

Для повседневной настройки можно использовать графический интерфейс, а для сборок, просмотра журналов и передачи файлов — командную строку. Эти способы дополняют друг друга: держать рабочий стол постоянно открытым для каждой сборки не нужно.

Ниже указаны порты служб по умолчанию. Для подключения используйте порты из консоли.
Способ подключенияДля каких задачНеобходимые портыАутентификация и примечания
Общий экран macOSНастройка Xcode, работа с симулятором, проверка графического интерфейса и удалённая работаVNC: TCP 5900 по умолчанию; для туннеля также нужен порт SSHИспользуйте данные системного пользователя, выданные при подключении. Подключение к рабочему столу не заменяет аутентификацию SSH по ключу.
Сторонний клиент VNCДоступ к рабочему столу macOS из Windows или LinuxVNC: TCP 5900 по умолчанию либо локальный порт туннеляКлиент должен поддерживать способ аутентификации сервера. Не отключайте аутентификацию и не разрешайте подключение отовсюду ради совместимости.
Командная строка SSHСборки, просмотр журналов, регистрация runner и передача файлов через SFTPSSH: TCP 22 по умолчанию; внешний порт указан в консолиПредпочтительно входить по ключу. При первом подключении проверьте отпечаток хоста и только потом подтвердите доверие.

Сначала проверьте порт, затем ищите проблему в клиенте. При тайм-ауте сначала проверьте адрес, правила исходящих подключений и порт назначения. Если появилось приглашение для аутентификации, сетевой маршрут, как правило, работает — проверьте имя пользователя, пароль или ключ.

Выберите свою ОС

Три клиента — один порядок проверки

Сначала установите SSH-соединение и проверьте инстанс и рабочую директорию, затем подключайтесь к рабочему столу. Эти инструкции не требуют отключать локальный брандмауэр или открывать облачный Mac для любых подключений.

Подключение с macOS

  1. Откройте «Терминал» и подключитесь, указав имя пользователя, адрес и порт SSH из консоли. При первом запросе отпечатка сначала проверьте его и не подтверждайте сразу.
  2. Чтобы открыть рабочий стол, запустите «Общий экран» и укажите адрес общего экрана инстанса. При использовании туннеля введите адрес и порт локального прослушивания.
  3. Введите имя системного пользователя и пароль. Открыв рабочий стол, проверьте раскладку клавиатуры, разрешение экрана и часовой пояс, затем откройте рабочий проект.
  4. Перед завершением сеанса рабочего стола убедитесь, что журнал сборки сохранён. Отключение общего экрана не прекращает аренду и не останавливает фоновые задачи.

Первичная проверка: в терминале отображается информация о системе, открывается Finder, а в каталоге проекта можно создавать и изменять файлы.

Подключение с Windows

  1. Проверьте в PowerShell, доступен ли клиент OpenSSH. Если на корпоративном устройстве нельзя устанавливать компоненты, сначала обратитесь к местному администратору.
  2. Проверьте адрес и порт командой SSH. При вводе пароля символы не отображаются — это нормально, не вставляйте пароль повторно.
  3. Установите клиент VNC, совместимый с аутентификацией общего экрана macOS, и отдельно укажите хост и порт. Формат адреса зависит от клиента.
  4. Рекомендуется подключаться к рабочему столу через SSH-туннель. Если рукопожатие не проходит, сначала проверьте совместимость аутентификации, затем состояние службы. Не пытайтесь угадывать пароль.

Первичная проверка: SSH-соединение устанавливается, VNC проходит аутентификацию, сочетания клавиш подходят для повседневной работы.

Подключение с Linux

  1. Используйте клиент OpenSSH из своего дистрибутива. Проверьте права доступа к локальному ключу: он не должен быть доступен другим пользователям.
  2. Подключитесь по SSH, используя выданные данные. Для передачи проекта или сборки используйте тот же вход SSH через SFTP.
  3. Выберите клиент VNC, совместимый с аутентификацией сервера. По возможности подключайтесь к локальному порту, перенаправленному через SSH, а не открывайте службу рабочего стола напрямую.
  4. При первом входе проверьте буфер обмена и раскладку ввода. Передавайте файлы пакетами через SFTP, а не используйте буфер обмена рабочего стола для синхронизации проекта.

Первичная проверка: аутентификация по ключу работает, SFTP открывает нужный каталог, ввод и отображение на рабочем столе работают корректно.

Команды SSH и туннеля для рабочего стола

Сначала задайте переменные в локальном терминале: SSH_USER — имя системного пользователя, SSH_HOST — адрес инстанса, SSH_PORT — порт SSH из консоли. Не записывайте пароль в команду или скрипт.

ssh -p "$SSH_PORT" "$SSH_USER@$SSH_HOST"

ssh -N -o ExitOnForwardFailure=yes \
  -L 127.0.0.1:15900:127.0.0.1:5900 \
  -p "$SSH_PORT" "$SSH_USER@$SSH_HOST"

Вторая команда подходит, только если служба общего экрана на удалённом Mac прослушивает локальный TCP-порт 5900 и разрешена переадресация через SSH. Оставьте этот терминал запущенным, а в клиенте VNC подключитесь к 127.0.0.1:15900 . Это локальный порт, а не внешний порт инстанса. Если он занят, укажите другой свободный локальный порт.

Обеспечьте плавную работу

Снизьте нагрузку на изображение — это эффективнее, чем бездумно увеличивать пропускную способность

На работу удалённого рабочего стола влияют задержка, потеря пакетов, частота изменений изображения и возможности кодирования клиента. Эти настройки — отправная точка, а не результат измерения скорости узла или гарантия пропускной способности; ориентируйтесь на собственные замеры локальной сети.

Начните с низкого разрешения и стабильного соединения, затем постепенно повышайте качество
Сеть и задачиНачальное разрешениеКачество и глубина цветаЧто настроить
Мобильная сеть или нестабильное международное соединение1280 × 720Сначала включите адаптивное сжатие; если клиент поддерживает, попробуйте 16-битный цветОтключите анимацию рабочего стола, приостановите синхронизацию больших файлов и сначала проверьте отзывчивость ввода.
Стабильный широкополосный интернет, код и документы1920 × 1080Начните с автоматического качества; повышайте его, только если текст отображается недостаточно чёткоМеняйте по одному параметру и сравнивайте прокрутку, перемещение окон и ввод с клавиатуры.
Проверка интерфейса и обработка изображенийОт 1920 × 1080Для точной передачи цвета выберите глубину 24 бита или выше, если клиент это поддерживаетПроверьте масштабирование и артефакты сжатия; качество итогового изображения оценивайте по экспортированному файлу.

Рабочий стол — для управления, не для оценки видео и звука в реальном времени

Предпросмотр видео, быстрая анимация и взаимодействие с высокой частотой кадров увеличивают объём изменений изображения. Медиафайлы можно перекодировать удалённо, но итоговое видео следует скачать и проверить локально. Не путайте пропуски кадров на удалённом рабочем столе с проблемами экспортированного файла.

Рекомендуемый порядок: снизить разрешение → включить адаптивное качество → проверить потери пакетов → настроить глубину цвета.

Не полагайтесь на постоянно открытый рабочий стол для сборок и передачи файлов

Для длительных сборок используйте runner или управляемую фоновую задачу и сохраняйте журналы в файл. Передавайте проекты и результаты сборки через SFTP. Продолжит ли задача работу после отключения рабочего стола, зависит от способа запуска: не рассчитывайте, что любая команда в терминале останется активной.

Если планируете работать постоянно, сначала проверьте полный рабочий цикл и только потом выбирайте долгий срок аренды.

Ограничения отладки на реальном устройстве

Запуск симулятора не означает, что Mac обнаружит ваш телефон

Выделенный физический облачный Mac и доступность мобильного устройства по сети — разные вещи. Xcode, симулятор и сборки можно запускать удалённо. Для подключения локального iPhone или iPad также нужны сопряжение, доверие и обнаружение устройства по сети.

Вариант 1: сначала проверьте симулятор удалённо

Откройте проект на облачном Mac, проверьте совместимость Xcode, SDK и настроек проекта, затем запустите симулятор для проверки интерфейса, логики и базовых сценариев. Так можно сначала исключить проблемы со сборкой и средой выполнения.

Симулятор не заменяет реальные тесты камеры, датчиков, сотовой сети, производительности и терморегуляции. Для проверки этих возможностей отдельно запланируйте тестирование на реальном устройстве.

Результат: воспроизводимая запись сборки, журнал тестов и результаты запуска симулятора.

Вариант 2: проверьте условия сетевой отладки устройства

Для сетевой отладки обычно требуется сначала корректно связать устройство с целевым Mac и соблюсти требования к версии Xcode и ОС. Устройство и Mac должны обнаруживать друг друга или обмениваться данными по проверенному сетевому маршруту.

SSH-туннель сам по себе не решает проблемы обнаружения устройства, первоначального сопряжения и подтверждения доверия. Доступность публичного адреса ещё не означает, что можно сразу отлаживать реальное устройство по Wi-Fi.

До заказа проверьте способ сопряжения, сетевую топологию, версию ОС устройства и доступные разрешения.

Подключение удалённых устройств нужно проверять отдельно. Переадресация USB и другие решения для удалённых устройств зависят от совместимости протоколов, драйверов, повторного подключения устройства и качества сети. Они не входят в стандартную поставку; мобильные устройства также не предоставляются. Если локальное устройство обязательно должно подключаться к облачному Xcode, сначала сообщите команде модель устройства, версию ОС, способ сопряжения и цель тестирования. После проверки возможности можно планировать работу. Если нужно только проверить установочный пакет, передайте подписанную сборку тестировщикам для проверки на локальном устройстве — постоянно поддерживать сеанс удалённой отладки не нужно.

После подключения

Сначала ограничьте доступ, затем добавьте проект и ключи

Выделенный физический сервер не делит вычислительные ресурсы с другими арендаторами, но это не заменяет защиту учётной записи. Выполните три шага ниже, прежде чем добавлять сертификаты сборки, код и учётные данные автоматизации.

  1. Включите вход по ключу

    Создайте ключ на доверенном локальном устройстве и добавьте открытый ключ в файл авторизованных ключей нужного пользователя на удалённом Mac. Закрытый ключ оставьте локально и не загружайте на сервер или в заявку. Откройте новое окно терминала и проверьте вход по ключу, сохранив прежний сеанс как способ восстановления. Затем настройте параметры аутентификации по паролю.

  2. Смените выданный пароль

    После первого входа смените системный пароль и сохраните его в надёжном менеджере паролей. Не записывайте пароль в конфигурацию runner, историю команд или репозиторий проекта. Для совместной работы выдавайте каждому участнику отдельную учётную запись с возможностью отслеживания действий — не используйте один набор данных постоянно.

  3. Откройте только нужные порты

    Оставьте только используемые способы доступа по SSH и к рабочему столу; если возможно, подключайтесь через туннель. Перед изменением брандмауэра или правил доступа проверьте текущий административный вход и подготовьте способ отката. Не отключайте всю защиту сразу ради поиска проблемы с подключением.

Что указать в заявке при сбое

Укажите идентификатор инстанса, ОС и версию клиента, способ подключения, время сбоя и часовой пояс, точный текст ошибки и её тип: тайм-аут, отказ в соединении или ошибка аутентификации. Можно приложить скриншот без конфиденциальных данных. Не прикладывайте пароль, закрытый ключ или полные учётные данные.

Проверка перед подключением

Подготовьте всё необходимое для первого входа

Проверяйте пункты по порядку. Если чего-то не хватает, сначала подготовьте это, а не тратьте время на повторные попытки. Если корпоративная сеть блокирует необходимые исходящие подключения, заранее запросите разрешение.

  • Учётные данные сохранены
    Адрес инстанса, имя системного пользователя, данные для аутентификации и фактические порты сверены с консолью и сохранены в надёжном месте.
  • Клиент установлен
    Команда SSH работает; для графического интерфейса подготовлен совместимый клиент общего экрана или VNC.
  • Открытый ключ добавлен и проверен
    При входе по ключу открытый ключ добавлен нужному пользователю, а вход проверен в новом сеансе; закрытый ключ хранится только локально.
  • Сеть разрешает исходящие подключения
    Проверен фактический порт SSH; для прямого подключения к рабочему столу также проверен порт VNC, а для туннеля — локальный порт прослушивания.

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

Сначала проверьте подключение, затем переносите рабочие задачи.

Проверьте рабочий стол, командную строку и реальные задачи. Чтобы начать аренду, выберите конфигурацию под нагрузку; если инстанс уже есть, проверьте учётные данные в консоли.