В этом руководстве адрес узла, отпечаток хоста, графические операции в Xcode, передача кода, настройка сети и безопасный выход объединены в чёткую последовательность. Командные задачи выполняйте по SSH, а полноценный графический интерфейс macOS открывайте только при необходимости.
SSH потребляет меньше трафика и подходит для сборок, журналов, зависимостей и автоматизации. Графический удалённый доступ используйте для интерфейса Xcode, наблюдения за симулятором и настроек, которые необходимо выполнять на рабочем столе.
Используйте для операций Git, установки зависимостей, запуска скриптов, просмотра журналов, тестовых сборок и задач CI. Сначала проверьте по SSH адрес узла, учётные данные и состояние хоста, затем настраивайте другие способы доступа.
Используйте для работы с графическим интерфейсом Xcode, проверки настроек проекта, наблюдения за симулятором и приложениями рабочего стола. При нестабильной сети сначала снизьте разрешение, частоту кадров и качество цвета, не создавая новые сессии снова и снова.
Данные подключения нужно брать из сведений об экземпляре в консоли, соответствующем заказу. Не вводите адрес узла и учётные данные по переписке, старым снимкам экрана или пересланному тексту. При первом подключении сравните показанный отпечаток хоста с отпечатком в сведениях об экземпляре и принимайте его только при полном совпадении.
Проверьте регион узла, адрес, SSH-порт, имя пользователя и тип ключа. Убедитесь, что эти поля относятся к одному заказу и одному физическому узлу.
Закрытый ключ должен быть доступен только текущему локальному пользователю. Если клиент сообщает о слишком широких правах, сначала исправьте права файла, затем повторите подключение.
Сравните тип алгоритма и значение отпечатка посимвольно. При несовпадении прекратите подключение и не обходите предупреждение удалением старой записи.
После входа проверьте имя хоста, текущего пользователя, версию системы, свободное место на диске и путь к Xcode, а затем устанавливайте зависимости.
Адреса, имена пользователей, пути и названия проектов ниже являются неисполняемыми заполнителями. При использовании замените их данными из консоли и фактического проекта.
$ ssh -i /path/to/private_key -p <port> <user>@<node-address>
The authenticity of host cannot be established.
ED25519 key fingerprint is <fingerprint-to-verify>.
Continue connecting only after verification: yes
<user>@<host> % hostname
<instance-hostname>
<user>@<host> % xcodebuild test \
-workspace <project-workspace> \
-scheme <test-scheme> \
-destination 'platform=macOS'
Test Suite '<test-suite>' passed
Executed <test-count> tests, with 0 failures
<user>@<host> % bundle exec fastlane <workflow-name>
[fastlane] Checking project configuration
[fastlane] Running tests
[fastlane] Exporting artifact
[fastlane] Finished without reported errorsНазвания полей графического клиента могут различаться, но логика подключения одинакова: адрес и порт берутся из сведений об экземпляре, разрешение и качество изображения зависят от локальной сети, а буфер обмена и общий доступ к файлам включаются только в необходимом объёме.
В консоли проверьте, что целевой экземпляр работает, и убедитесь, что старая графическая сессия не занята. Если один рабочий процесс используют несколько человек, заранее договоритесь о передаче сессии, чтобы не отключать друг друга.
Скопируйте параметры подключения из сведений об экземпляре. Не храните ключи, пароли или данные восстановления в общих заметках, открытых репозиториях, снимках заявок или незашифрованных синхронизируемых каталогах.
Для первого подключения используйте один монитор, разрешение 1920×1080 или ниже и среднее качество цвета. После проверки стабильности ввода и изображения постепенно повышайте параметры; не включайте сразу высокое разрешение, частоту кадров и глубину цвета.
Включайте текстовый буфер обмена только при необходимости. Ограничьте подключаемый каталог отдельной папкой обмена и не открывайте локальный пользовательский каталог, каталог ключей или пути с материалами подписи.
Уточните, сохраняет ли клиент задачи, блокирует рабочий стол или завершает сессию при отключении. После работы используйте явную процедуру выхода, не предполагая, что закрытие окна клиента завершило сессию.
При выборе способа передачи учитывайте отслеживаемость, инкрементальные обновления, права файлов и риск раскрытия чувствительных данных. Не переносите частный код или материалы сборки через общедоступные ссылки.
Подходит для кода репозитория, файлов фиксации зависимостей и проверяемой конфигурации. Сначала проверьте удалённый адрес и ветку, затем выполняйте получение; частные учётные данные настраивайте контролируемым способом и не записывайте в репозиторий.
Подходит для инкрементальной загрузки ресурсов, скачивания обезличенных журналов и возврата артефактов сборки. Ограничьте целевой удалённый каталог, а после передачи проверьте владельца, права, размер и время изменения.
Подходит для одноразовой передачи материалов, кэша или архивов. На стороне отправителя создайте хеш, на узле вычислите его заново и сравните посимвольно; распаковывайте и обрабатывайте данные только при совпадении результатов.
Высокие разрешение, частота кадров и качество цвета одновременно увеличивают нагрузку на передачу. Меняйте за раз только один параметр и сохраняйте сравнение до и после, чтобы не скрыть настоящую причину.
| Симптом | Первый шаг | Второй шаг | Способ проверки |
|---|---|---|---|
| Задержка реакции мыши | Снизить разрешение | Снизить частоту кадров | Переместить окно и проверить синхронность ввода |
| Частая перерисовка изображения | Снизить качество цвета | Отключить динамические эффекты рабочего стола | Прокрутить файл с кодом и проверить область перерисовки |
| Периодические разрывы сессии | Перейти на проводную сеть или стабильный Wi‑Fi | Приостановить другие задачи с большим трафиком | Параллельно держать SSH-сессию и наблюдать непрерывность соединения |
| Ввод работает, но изображение зависло | Дождаться завершения текущей отрисовки | Повторно подключиться к исходной сессии | Не создавать несколько параллельных графических сессий |
По возможности используйте проводную сеть; при работе по Wi‑Fi обеспечьте стабильный сигнал и избегайте постоянной передачи больших объёмов данных.
Последовательно меняйте разрешение, частоту кадров и качество цвета, изменяя за раз только один параметр и записывая результат.
Сборки, журналы и работу с файлами оставляйте в SSH, а в графической сессии выполняйте только задачи, требующие интерфейса.
После каждого шага повторяйте проверку и сохраняйте полный текст ошибки, время события, регион узла и версию клиента. Не отправляйте только сообщение «не подключается» или один обрезанный снимок экрана.
Сначала убедитесь, что локальная сеть работает, затем проверьте адрес узла и порт по текущим сведениям об экземпляре. После этого проверьте локальный брандмауэр, сетевые политики организации и VPN. Если SSH и графическая сессия одновременно завершаются по тайм-ауту, сначала исследуйте сетевой маршрут и состояние узла, а не переустанавливайте графический клиент.
Изменение отпечатка может быть вызвано неверным адресом, подключением к другому узлу или изменением данных экземпляра. Остановите подключение, заново проверьте в консоли текущие адрес и отпечаток, а также идентификатор заказа и регион узла. Обновляйте локальную запись только после подтверждения источника нового отпечатка.
Сначала убедитесь, что регистр имени пользователя совпадает со сведениями об экземпляре, затем проверьте, что клиент загружает нужный ключ, а не старый файл с таким же именем. Проверьте права, формат и путь к файлу ключа; при использовании агента или менеджера ключей убедитесь, что он не заменяет ожидаемые данные аутентификации. Не перебирайте подряд учётные данные из неизвестных источников.
Сначала сохраните SSH-подключение и убедитесь, что система отвечает; затем проверьте наличие другой графической сессии, слишком высокие параметры изображения и поддержку клиентом текущего режима подключения. Снизьте настройки до одного монитора и меньшего разрешения и повторно подключитесь к исходной сессии. Если SSH работает, а изображение по-прежнему недоступно, зафиксируйте версию клиента и время сессии и отправьте заявку.
Команда должна заранее определить ответственного за текущую сессию и время передачи. Перед подключением проверяйте существующие сессии, а при выходе используйте отключение или выход из клиента; не решайте конфликт принудительным созданием новой сессии. Если фоновую сборку нужно сохранить, запускайте её в устойчивом командном процессе, а не оставляйте открытым графическое окно.
Идентификатор заказа, регион узла, время возникновения проблемы, полные шаги воспроизведения и обезличенные журналы. Для графической сессии дополнительно укажите название и версию клиента, разрешение и тип сети.
После работы последовательно выйдите из графической сессии, остановите ненужные слушатели, проверьте, не раскрыты ли учётные данные, и удалите временные файлы обмена локально и на узле.
Если учётные данные попали в открытый репозиторий, общие снимки экрана, общедоступный каталог загрузок или неконтролируемый журнал, немедленно прекратите их использование и выполните замену. Удаление открытой копии не заменяет замену учётных данных: содержимое могло быть закэшировано или скопировано.
Проверьте SSH-туннели, перенаправление портов, фоновые процессы клиента и локальный прокси. Оставляйте только точки доступа с ясным назначением и фиксируйте ответственного, цель и условие закрытия.
Сохраните версию системы, путь к Xcode, lock-файлы зависимостей, команды сборки и краткое описание ошибок; удалите закрытые ключи, пароли учётных записей, коды восстановления, временные пакеты обмена и необезличенные журналы.
Сначала выберите конфигурацию и узел для развёртывания. Если вы ещё настраиваете инструментарий, продолжите чтение руководства по первому развёртыванию или откройте справочный центр для решения конкретной проблемы.