Центр поддержки

Сначала найдите проблему — затем действуйте

Здесь собраны материалы по подключению, системе, сети, хранилищу, сборке и аккаунту RunnerVPS облачного Mac. Найдите нужный симптом и последовательно пройдите диагностику, не меняя несколько параметров одновременно.

Версия документации 2026.09для 5 доступных узлов

ПОДДЕРЖКА RUNNER Результат диагностики подключения
Проверяйте по порядку
A
Проверьте состояние устройства Сверьте идентификатор, регион и текущий статус доступа
Начало
B
Разделите способы доступа Отдельно проверьте SSH и графическое подключение
Разделение
C
Соберите воспроизводимые данные Зафиксируйте время, ошибку, сеть и обезличенные логи
Передача
Принцип работы
Меняйте только один параметр за раз
Обращение в поддержку
Создайте заявку после привязки устройства
Категории проблем

От симптома — к нужной проверке

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

Подключение

Не удаётся установить сеанс SSH или VNC

Для случаев с тайм-аутом подключения, изменением отпечатка хоста, отказом в учётных данных, обрывом графического сеанса или ошибками после повторного подключения.

Диагностика подключения
Система

Изменилась версия цепочки инструментов

Для случаев с неверно выбранным Xcode, изменившимся путём к инструментам командной строки, несовместимостью зависимостей после обновления системы или неработающими переменными среды.

Проверка системы
Сеть

Не удаётся получить, отправить данные или перенаправить порт

Для случаев с прерванным получением из Git, ошибкой передачи SFTP, недоступным туннелем SSH, сбоями DNS или ограничениями локальной сети.

Советы по передаче
Хранилище

Кэш сборки заполнил локальный диск

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

Проверка свободного места
Сборка

Не удаётся подписать, архивировать или выполнить задачу автоматизации

Для случаев с несовпадением сертификатов и файлов подписи, разными средами runner, загрязнённым кэшем зависимостей или отсутствующим артефактом архива.

Проверка сборки
Аккаунт

Нужно проверить заказ или данные устройства

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

Открыть консоль
Диагностика подключения

Последовательно сужайте область поиска неисправности

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

01 Состояние узла

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

02 Учётные данные доступа

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

03 Канал SSH

Сначала проверьте отпечаток хоста, затем используйте подробный вывод, чтобы определить этап сбоя. Разделите DNS, установление TCP-соединения, согласование ключей и аутентификацию пользователя — не сводите всё к сообщению «подключение не удалось».

04 Графический сеанс

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

05 Системный брандмауэр

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

06 Локальная сеть

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

Удалённый рабочий стол

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

VNC подходит для работы с Xcode, просмотрщиками и графическими инструментами. Перед подключением убедитесь, что канал SSH работает: при сбое графического сеанса останется путь проверки из командной строки.

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

Подготовьте контролируемый клиент VNC

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

  • Сохраняйте имя устройства и адрес доступа отдельно
  • Используйте индивидуальные контролируемые способы доступа
  • По возможности подключайтесь через контролируемую сеть или туннель SSH
Во время сеанса

Сначала настройте разрешение, затем оценивайте плавность

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

  • Начните с меньшего разрешения и проверьте отклик ввода
  • Не оценивайте изображение одновременно с передачей больших файлов
  • Запишите последнее изменение настроек перед появлением сбоя
Перед уходом

Заблокируйте сеанс, не завершайте процессы принудительно

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

  • Перед уходом сохраните проект и несохранённые изменения
  • Не перезапускайте задачу сразу из-за зависшего изображения
  • После ухода участника вовремя отзовите его способ доступа
Среда сборки

Зафиксируйте цепочку инструментов, затем очистите воссоздаваемые данные

Для непрерывной сборки особенно опасны незафиксированные изменения среды между задачами. Запишите выбор версий, материалы подписи и очистку кэша в командную инструкцию.

Зафиксируйте Xcode и инструменты командной строки

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

Отделяйте сертификаты и файлы подписи от репозитория кода

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

Очищайте кэш по источнику

Сначала выясните, что занимает место: DerivedData, кэш зависимостей, архивы, данные симуляторов или материалы проекта. В первую очередь удаляйте данные, которые можно создать заново, а нужные для передачи артефакты и материалы сбоя сохраняйте.

Контроль среды Перед запуском задачи
Xcode
Соответствует версиям и ограничениям проекта
Каталог разработчика
Указывает на нужную цепочку инструментов
Материалы подписи
Передаются временно для конкретной задачи
Место на диске
Включает кэш, архивы и экспорт
Минимальный тест
Сначала проверьте получение, компиляцию и создание артефакта
Меняйте по одному параметру Записывайте результат в журнал сборки
Сеть и файлы

Проверяйте канал подключения и канал передачи файлов отдельно

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

ТУННЕЛЬ SSH

Перенаправляйте только нужные порты

Определите локальный порт, адрес назначения и назначение, не открывая слишком широкое прослушивание. После создания туннеля отдельно проверьте сам SSH и перенаправленный сервис, чтобы отличить проблему аутентификации от проблемы приложения.

SFTP

Сначала проверьте права каталога

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

ПОЛУЧЕНИЕ ИЗ GIT

Ограничьте область действия учётных данных репозитория

Используйте для автоматизации учётные данные с минимальными правами и ограничьте их нужным репозиторием. При сбое получения отдельно проверьте DNS, доступность удалённого узла, отпечаток хоста, права учётных данных и адрес репозитория.

АРТЕФАКТ

Сначала передайте файл, затем удаляйте исходники

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

База знаний

От пошаговых инструкций — к командным стратегиям

Статьи ниже отсортированы по дате публикации от новых к старым. Они посвящены обновлению системы, безопасности подключений, выбору сервиса, аудио и видео, сборке Unity для iOS и задачам разработки на M4.

Статьи базы знаний готовятся

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

Все статьи базы знаний
Поддержка специалистов

Передайте заявку сразу в состояние, пригодное для диагностики

Технические вопросы лучше отправлять через консоль: так можно привязать их к конкретному устройству и заказу. Если войти не удаётся, напишите на support@runnervps.com, но не прикладывайте пароль, закрытый ключ или полные платёжные данные.

Идентификатор устройства Имя устройства в консоли; пароль доступа отправлять не нужно
Регион Сингапур, Япония (Токио), Южная Корея (Сеул), Гонконг или восток США
Время проблемы Укажите часовой пояс и период последней успешной операции
Шаги воспроизведения Запишите команды, действия и фактический результат в порядке выполнения
Обезличенные логи Удалите токены, ключи, пароли, учётные данные репозитория и персональные данные

Нужен выделенный M4 для воспроизведения проблемы?

Runner M4 и Runner M4 Plus — выделенные физические машины, а не виртуальные. Их можно арендовать посуточно, понедельно, помесячно или поквартально. Фактическая доступность в реальном времени отображается в консоли.