Этот раздел помогает найти и устранить причину неполадки в Ринго. Выберите отправную точку:
Если вы не знаете, с чего начать, пройдите по схеме поиска причины: она задаёт вопросы по порядку и приводит к нужной странице.
Раздел написан для Ринго 3.x и проверен на версии 3.0.5. Версию вашего сервера можно посмотреть в разделе Настройки → Информация о системе.
Ответы на эти вопросы сразу сужают круг возможных причин:
| Вопрос | Если да | Если нет |
|---|---|---|
| Проблема затрагивает все устройства? | Проверьте сервер, сертификаты и сеть сервера: Первые 10 минут. | Причина в конкретном устройстве или в его сети. |
| Другой канал управления работает? Например, MDM-команды выполняются, а агент не отвечает. | Сервер работает. Ищите причину в неработающем канале. | Ищите общую причину: TLS, DNS, доступность сервера. |
| Всё работало раньше и перестало в определённый день? | Выясните, что изменилось: истёк сертификат (APNs, TLS, enroll-профиля), обновили прокси, WAF или Ринго, сменили домен. | Вероятна ошибка конфигурации прокси, WAF или сети. |
В каждой группе симптомы расположены от частых к редким.
| Симптом | Вероятная причина | Где решение |
|---|---|---|
| У всех устройств команды остаются в статусе «В очереди». | Истёк APNs-сертификат или сервер не может подключиться к Apple. | Команды MDM → Шаг 1 |
| У одного устройства команды несколько часов остаются в статусе «В очереди». | Устройство выключено или не в сети, истёк сертификат enroll-профиля или профиль MDM удалён. | Команды MDM → «В очереди» |
| Команда в статусе «Отложено». | Экран устройства заблокирован (ответ NotNow). Обычно это не ошибка. |
Команды MDM → «Отложено» |
| Команда в статусе «Отправлено», результата нет. | Устройство потеряло сеть или WAF блокирует его ответ. | Команды MDM → «Отправлено» |
| Команда в статусе «Ошибка». | Устройство отказалось выполнить команду: ошибка в профиле, ограничение ОС, устройство не контролируемое. | Команды MDM → «Ошибка» |
| Команда в статусе «Отменено», хотя её никто не отменял. | Устройство заново зарегистрировали профилем, Apple сообщила, что push-токен недействителен, агент сообщил об удалении профиля MDM, либо устройство 50 раз ответило NotNow. |
Команды MDM → «Отменено» |
| Команда в статусе «Выполнено», но настройка не действует. | Конфликт профилей или настройка не подходит для этой ОС либо типа регистрации. | Команды MDM → «Выполнено» |
| После замены APNs-сертификата push перестали доходить. | Сертификат создан заново (Create), а не продлён (Renew). | Команды MDM → APNs |
| Симптом | Вероятная причина | Где решение |
|---|---|---|
| Нет терминала, данные об устройстве неполные. | Агент не запущен или не подключается к серверу. | Агент |
| Агент то подключается, то пропадает. | Прокси или балансировщик разрывает соединение websocket по таймауту. | Связь агента с сервером → шаг 2 |
| Агент не подключается на части устройств, MDM работает. | Прокси не отдаёт промежуточный сертификат (неполная цепочка), SSL-inspection в сети устройств или на устройствах не установлен корневой сертификат. | Связь агента с сервером → шаг 3 |
| После обновления Ринго агенты не подключаются. | Версия агента не совпадает с сервером, а обновление агента доставляется через MDM. | Агент на macOS → шаг 3 |
| Агент на Mac не проходит авторизацию, а «Обновить профиль MDM» не помогает. | На Mac остался прежний сертификат агента. | Агент на macOS → несколько сертификатов агента |
| Политика не запускается. | Ограничение частоты, устройство вне области действия, политика выключена. | Политики и пакеты → политики |
| Пакет не устанавливается. | Точка распространения недоступна с устройства (HTTP, SMB 445, DNS) или установщик завершился ошибкой. | Политики и пакеты → пакеты |
| Self Service пустой или бесконечно загружается. | Для устройства ничего не опубликовано. | Политики и пакеты → Self Service |
| В инвентаризации отображается не всё ПО. | Индекс Spotlight на Mac неполный. | Политики и пакеты → инвентаризация |
| Профиль MDM удалён, а терминал продолжает работать. | Сообщение CheckOut не дошло до сервера. |
Агент на macOS → удаление профиля MDM |
| Симптом | Вероятная причина | Где решение |
|---|---|---|
Профиль не устанавливается, а сервер отвечает на POST /mdm/enroll/profile кодом 402. |
Исчерпан лимит лицензии. | Регистрация → лицензия |
| Страница регистрации не открывается или не принимает учётные данные. | Пути /enroll и /enroll/auth закрыты на прокси или учётные данные неверны. |
Регистрация → Шаг 1 |
| Профиль скачан, но не устанавливается: «SCEP‑сервер … был недоступен или не отвечал» или ошибка сертификата. | Пути /scep и /mdm/checkin недоступны, ошибка TLS или обрыв сети. |
Регистрация → Шаг 2 |
| Профиль установлен, но устройства нет в Ринго. | Сообщения Authenticate или TokenUpdate не дошли до сервера. |
Регистрация → Шаг 3 |
| Устройство появилось, а агент нет (macOS). | Профиль агента не доставлен (это MDM-команда) или агент не подключился. | Регистрация → Шаг 4 |
| Симптом | Вероятная причина | Где решение |
|---|---|---|
Веб-интерфейс не открывается, /health не отвечает. |
Контейнер backend остановлен. | Сервер → контейнеры |
У всех сразу ошибка сертификата: сервер отдаёт самоподписанный сертификат, по HTTP отвечает 503. |
При встроенном прокси (nginx-proxy) так выглядит остановленный backend. | Сервер → контейнеры |
| Ринго перестал работать, на диске не осталось места. | Логи без ротации заняли диск. | Сервер → диск |
| Браузер сообщает об ошибке сертификата. | TLS-сертификат истёк, цепочка неполная или прокси отдаёт сертификат по умолчанию. | Сеть → TLS |
| После смены домена устройства не подключаются. | .env изменён без пересоздания контейнеров или профили выданы на старый домен. |
Сервер → смена домена |
| Внутри сети работает, снаружи нет (или наоборот). | Разные DNS-ответы внутри и снаружи, ACL прокси, отсутствие hairpin NAT. | Сеть → DNS |
| Работа нестабильна: обрывы, медленные ответы. | DPI или ТСПУ на пути, MTU, перегруженный прокси. | Сеть → нестабильная работа |
Проверено на Ринго 3.0.5, октябрь 2026. Тексты ошибок — Справочник ошибок, термины — Термины.