Отдельный ключ для каждого пользователя
Не используйте один закрытый ключ совместно. Отдельные ключи помогают определить пользователя, отозвать доступ точечно и снизить риск для всей команды при утечке одного ключа.
REMOTE ACCESS / Руководство по подключению
Подключите облачный Mac через рабочий стол или командную строку
Если вам нужны Xcode, системные настройки и графические инструменты, откройте удалённый рабочий стол в браузере через консоль. Для сборки, синхронизации файлов и автоматизации используйте SSH. Оба способа подключают одну и ту же выделенную физическую машину, поэтому файлы, зависимости и рабочая среда сохраняются на узле.
Узел работает 365 дней в году
Выделенная физическая машина
Не виртуальная машина
DISPLAY
1920 × 1080
KEYBOARD
Local mapping
$ ssh node-user@$NODE_HOST
Host key verified
macOS session ready
$
Physical node online
SSH / DESKTOP
01 / Выбор способа
Сначала выберите способ подключения под задачу
Удалённый рабочий стол в браузере и SSH не заменяют друг друга. Первый даёт полноценный графический интерфейс macOS, а второй подходит для сценариев, автоматизации, низкой пропускной способности и длительных задач.
| Критерий | Удалённый рабочий стол в браузере | SSH |
|---|---|---|
| Подходящие задачи | Графические операции в Xcode, системные настройки, проверка интерфейса приложений, настройка клавиатуры и экрана | Скрипты сборки, операции Git, установка зависимостей, проверка журналов, автоматизация и пакетная обработка файлов |
| Способ взаимодействия | Удалённый рабочий стол отображается в браузере; управление выполняется локальной клавиатурой и указателем | Командная строка терминала с поддержкой ключей, мультиплексирования и скриптов |
| Что подготовить | Узел в сети, браузер разрешает необходимые функции сеанса, данные для входа на узел получены | Адрес узла, имя пользователя, файл закрытого ключа и проверенный отпечаток хоста при первом подключении |
| Рекомендации по сети | В первую очередь обеспечьте стабильное соединение; при высокой задержке снизьте разрешение и качество цвета | Требуется меньше пропускной способности; для длительных задач используйте мультиплексирование терминала и записывайте журналы в файл |
| Выход | Сохраните работу, затем выйдите из сеанса рабочего стола или закройте удалённое представление | Используйте exit для штатного завершения сеанса, не прерывая запись выполняющейся задачи |
Совет: при первом подключении используйте удалённый рабочий стол в браузере, чтобы проверить состояние системы и раскладку клавиатуры, а затем настройте ключи SSH. В повседневной разработке оставьте рабочий стол для графических операций, а сборку и синхронизацию запускайте через SSH.
02 / Графический интерфейс
Откройте удалённый рабочий стол в браузере через консоль
Полный процесс обычно включает проверку состояния узла, данных для входа, установку сеанса и настройку локального ввода. Если рабочий стол не открылся, не отправляйте запрос входа повторно много раз подряд.
-
01
Откройте сведения об узле
Войдите в консоль и найдите нужный узел в списке экземпляров. Убедитесь, что идентификатор, регион и состояние узла совпадают с заказом, и только после появления статуса «В сети» открывайте подключение. При управлении несколькими облачными Mac сначала проверяйте идентификатор узла, чтобы не попасть в другую среду.
Проверьте идентификатор узла · регион · статус «В сети» -
02
Проверьте данные для входа
Используйте данные для входа, отображаемые консолью для этого узла, и не применяйте учётные данные другого узла. При вставке проверьте, не добавились ли пробелы в начале или конце. Передавайте права доступа внутри команды только через контролируемый процесс работы с учётными данными, а не в групповых чатах или журналах сборки.
Проверьте имя пользователя · область действия учётных данных · пробелы во вводе -
03
Откройте рабочий стол и проверьте ввод
После загрузки рабочего стола откройте область текста без конфиденциальных данных и проверьте буквы, цифры, символы, Command, Option и переключение между языками. Если результат нажатия клавиш отличается от локальной клавиатуры, сначала согласуйте локальную и удалённую раскладки, а затем вводите сертификаты или команды.
Проверьте символьные клавиши · модификаторы · раскладку -
04
Настройте разрешение и качество изображения
Для редактирования текста и работы в Xcode начните с 1920 × 1080 . При заметной задержке сначала снизьте разрешение, затем качество цвета. После стабилизации сети повышайте параметры по одному, чтобы понять, какая настройка вызывает задержки.
Начальная настройка 1920 × 1080
Если страница пустая
Сначала дождитесь завершения текущего подключения, затем один раз обновите сведения об узле. Убедитесь, что браузер не блокирует необходимые функции сеанса, и повторите проверку в отдельном окне без расширений.
Если клавиши работают неправильно
Запишите нажатую клавишу, ожидаемый и фактический символ. Сначала согласуйте локальную и удалённую раскладки, затем проверьте, не перехватывает ли браузер сочетания клавиш.
Если изображение размыто
Убедитесь, что масштаб браузера установлен на стандартное значение, затем согласуйте его с удалённым разрешением. Не меняйте одновременно масштаб браузера, системный масштаб и качество удалённого изображения.
03 / Командная строка
Установите проверяемый SSH-сеанс
Перед SSH-подключением подготовьте адрес, имя пользователя и источник закрытого ключа. Отпечаток хоста при первом подключении необходимо сверить с записью в консоли — пропускать проверку нельзя.
Создайте отдельный ключ
LOCAL
ssh-keygen -t ed25519 -f ~/.ssh/mw_nodeСоздайте отдельный ключ для узла MacWorker и задайте пароль локального ключа. Не перезаписывайте ключ по умолчанию, которым уже пользуется команда.
Задайте параметры подключения
LOCAL
export NODE_HOST="адрес узла из консоли"
export NODE_USER="имя пользователя из консоли"Ориентируйтесь на адрес и имя пользователя, отображаемые в текущей консоли. Переменные среды действуют только в текущем сеансе терминала и не позволяют многократно выводить параметры подключения в истории команд.
Первое подключение
VERIFY
ssh -i ~/.ssh/mw_node "$NODE_USER@$NODE_HOST"После отображения отпечатка в терминале приостановите действие и посимвольно сверьте тип алгоритма и полный отпечаток с записью в консоли. Подтверждайте подключение только при полном совпадении.
Корректный выход
REMOTE
exitПеред выходом убедитесь, что запись файлов, установка зависимостей и сборка завершены. Длительные задачи запускайте в сеансе, который можно восстановить, а не в единственном окне терминала.
04 / Базовая безопасность
Контролируйте доступ на уровне пользователей и узлов
Выделенный физический узел не делит вычислительные ресурсы с другими клиентами, однако команда всё равно должна управлять ключами, учётными данными, изменениями состава и журналами входа.
Ограничьте передачу учётных данных
Не записывайте учётные данные в репозитории кода, журналы сборки или документацию проекта. При необходимости передачи используйте утверждённый командой контролируемый процесс и после этого проверьте область доступа.
Своевременно отзывайте доступ участников
Когда участник покидает проект или меняет обязанности, в тот же день удалите соответствующий открытый ключ и доступ к консоли, а также замените общие учётные данные, к которым он мог получить доступ.
Регулярно проверяйте журналы входа
Проверяйте время входа, источники и неудачные попытки как минимум в каждом цикле выпуска команды. При активности, не соответствующей рабочему времени или привычному региону, сначала заблокируйте связанные учётные данные, а затем проводите расследование.
При каждом изменении состава
Удаляйте открытые ключи и права доступа к консоли
В каждом цикле выпуска
Проверяйте журналы входа и активные ключи
При обнаружении аномалии
Прекратите использовать старые учётные данные и сохраните временную шкалу событий
05 / Передача файлов
Передавайте исходные файлы и результаты по зашифрованному соединению
Перед загрузкой определите, какие файлы действительно нужны задаче, а при скачивании забирайте только целевой результат. Кэш зависимостей, временные каталоги и архивы прошлых версий не следует автоматически передавать вместе со всем проектом.
UPLOAD
Загрузить ресурсы сборки
scp -i ~/.ssh/mw_node -r ./BuildInput "$NODE_USER@$NODE_HOST:~/Work/"Подходит для разовой загрузки конкретного каталога. Перед передачей исключите локальные журналы, временные результаты и ненужные старые файлы, а также убедитесь, что в целевом пути достаточно места.
DOWNLOAD
Скачать результат сборки
scp -i ~/.ssh/mw_node "$NODE_USER@$NODE_HOST:~/Work/output.zip" ./Artifacts/Сначала упорядочьте и проверьте результат на узле, затем скачайте один архив. После загрузки сравните размер или контрольную сумму файла, чтобы неполный результат не попал в следующий этап.
Контроль передачи больших файлов
01
Сначала сократите объём
Синхронизируйте только текущую ветку и ресурсы задачи, не копируйте весь рабочий каталог по умолчанию.
02
Затем разбейте передачу по времени
При высокой задержке передавайте файлы партиями и избегайте периодов перегрузки локальной сети.
03
В конце выполните проверку
Сохраните исходные файлы и удаляйте промежуточный архив только после совпадения размера и контрольной суммы.
06 / Оптимизация сеанса
При высокой задержке сначала сократите стоимость взаимодействия
Сначала определите, связана ли проблема с передачей изображения или выполнением команд. Задержки удалённого рабочего стола не обязательно означают снижение производительности узла; если SSH отвечает нормально, сначала настройте параметры изображения.
DISPLAY
1920 × 1080
Начните с умеренного разрешения
Сначала используйте одну область отображения и умеренное разрешение. При заметной задержке постепенно снижайте его, не меняя несколько параметров одновременно; после восстановления плавности повышайте чёткость текста.
COLOR
Снижайте постепенно
Сначала обеспечьте быструю реакцию ввода
Для написания кода и настройки системы обычно не требуется максимальное качество цвета. Снижение качества уменьшает объём обновляемого изображения; временно восстановите его для визуальной проверки.
TERMINAL
tmux
Защитите задачи от кратковременных обрывов сети
Запускайте сборку, тесты и обработку зависимостей в мультиплексируемом сеансе терминала и одновременно записывайте вывод в файл журнала. После повторного подключения восстановите сеанс, не начиная задачу заново.
tmux new -s build
tmux attach -t build
RECOVERY
Сохраняйте состояние
Подготовьте точки восстановления после обрыва
Разбивайте длительный процесс на повторяемые шаги, записывайте вывод в фиксированный каталог и отмечайте последний завершённый этап. После обрыва сначала проверьте процессы и результаты, не запускайте ту же задачу повторно сразу.
07 / Быстрая диагностика
Сужайте область поиска по симптомам
При диагностике сохраняйте идентификатор узла, время события, способ подключения и полное резюме ошибки. За один раз меняйте только одну переменную, чтобы понимать, какое действие помогло.
SSH сообщает об ошибке аутентификации
Сначала проверьте имя пользователя и путь к закрытому ключу, затем права файла ключа и наличие открытого ключа на целевом узле. Включите подробный режим, чтобы увидеть, какой ключ фактически использует клиент:
ssh -v -i ~/.ssh/mw_node "$NODE_USER@$NODE_HOST"Не отправляйте другим полный закрытый ключ или подробные журналы с конфиденциальными полями. В обращении указывайте только этап ошибки, сведения об алгоритме и обработанное резюме.
После подключения браузера страница пустая
Убедитесь, что узел всё ещё в сети, и дождитесь завершения установки текущего сеанса. Затем повторите попытку в отдельном окне браузера без расширений и проверьте, не блокирует ли браузер необходимые функции сеанса. Если SSH подключается, а рабочий стол остаётся пустым, перед обращением укажите версию браузера, время события и идентификатор узла.
Неправильно работают символы или модификаторы клавиатуры
В текстовой области без конфиденциальных данных запишите ожидаемый и фактический символы и сравните локальную и удалённую раскладки. Затем проверьте, не перехватываются ли Command, Option и Control системой или сочетаниями браузера. После изменения настроек проверьте клавиши по одной, не экспериментируйте в поле ввода учётных данных.
Истёк тайм-аут подключения к рабочему столу или SSH
По порядку проверьте локальную сеть, адрес назначения, состояние узла и настройки клиента. Сначала повторите проверку в заведомо стабильной локальной сети, затем убедитесь, что адрес не устарел и не был ошибочно скопирован. Если оба способа подключения к одному узлу завершаются тайм-аутом, зафиксируйте местное время, сеть и длительность ошибки.
SSH сообщает об изменении отпечатка хоста
Немедленно остановите подключение. Не обходите предупреждение отключением проверки или удалением записи известного хоста. Сначала убедитесь, что адрес узла не изменился, затем сверьте новый отпечаток и причину изменения через консоль. После проверки удалите старую запись для этого адреса и установите новое подключение.
Минимальные сведения для обращения: идентификатор узла, время и часовой пояс, способ подключения, клиент и его версия, полное резюме ошибки, выполненные шаги диагностики. Не прикладывайте закрытые ключи, пароли, платёжные данные или исходный код проекта.
READY TO CONNECT
Выберите узел и начните подключение через консоль
Сначала убедитесь, что узел в сети, затем откройте удалённый рабочий стол в браузере или настройте SSH под задачу. Для совместной работы с графическим интерфейсом и командной строкой оба сеанса можно подключить к одному выделенному физическому Mac.