¶ Первые 10 минут: проверки, которые решают большинство проблем
Начните с этой страницы, если Ринго не работает у всех или у многих устройств либо вы не знаете, с чего начать. Проверки расположены от самых частых причин к редким, каждая занимает около минуты. Как только проверка покажет проблему, переходите по ссылке к её решению.
¶ 1. Сервер работает
Выполните на любом компьютере:
curl -s https://<домен>/health
| Ответ | Что это значит | Что делать |
|---|---|---|
{"status":"ok","details":{"db":{"status":"up"}}} |
Backend и база данных работают. | Перейдите к проверке 2. |
{"status":"error","details":{"db":{"status":"down"}}} |
Backend работает, база данных не отвечает. | См. Сервер → контейнеры. |
502 или 503, страница прокси |
Backend не запущен или прокси не может к нему подключиться. | Выполните на сервере docker ps -a, затем см. Сервер → контейнеры. |
| Ошибка сертификата у всех сразу (сервер отдаёт самоподписанный сертификат), хотя раньше всё работало | При встроенном nginx-proxy так выглядит остановленный backend. |
Сначала выполните docker ps -a (см. Сервер → контейнеры), затем проверку 3. |
Заодно проверьте на сервере свободное место: если диск заполнен, перестаёт работать всё сразу.
df -h / /var/lib/docker
Если занято 95–100 %, см. Сервер → место на диске.
¶ 2. Срок APNs-сертификата
Если APNs-сертификат истёк, push не отправляются, и у всех устройств команды остаются в статусе «В очереди». Сертификат действует один год. Напоминание Apple отправляет на почту Apple ID, на который выпущен сертификат.
Откройте Настройки → Сертификат APNS и посмотрите поле «Истекает»:
Если сертификат истёк или скоро истечёт, продлите его на identity.apple.com кнопкой Renew (не Create) и загрузите в Ринго. Подробнее см. Команды MDM → APNs-сертификат.
¶ 3. TLS-сертификат сервера
echo | openssl s_client -connect <домен>:443 -servername <домен> 2>/dev/null | openssl x509 -noout -subject -enddate
echo | openssl s_client -connect <домен>:443 -servername <домен> -showcerts 2>/dev/null | grep -E '^ *[0-9] s:'
| Результат | Что это значит |
|---|---|
Дата notAfter в прошлом |
Сертификат истёк, устройства и агенты не могут подключиться. |
Одна строка 0 s: у сертификата публичного удостоверяющего центра |
Цепочка неполная: прокси не отдаёт промежуточный сертификат, и устройства и агенты не доверяют серверу. |
В subject не ваш домен |
Прокси отдаёт сертификат по умолчанию, для вашего домена сертификата нет. |
| Вывода нет, команда не завершается | TLS-соединение не устанавливается: соединение блокируется в сети. |
В любом из этих случаев см. Сеть → TLS-сертификат.
¶ 4. Доступность адресов для устройств
Выполните следующие команды с компьютера за пределами вашей сети или из сети, где находятся проблемные устройства, и сравните выведенный код ответа с ожидаемым.
curl -s -o /dev/null -w '%{http_code}\n' "https://<домен>/scep?operation=GetCACaps"
Ожидается 200: сервер вернул список возможностей SCEP.
curl -s -o /dev/null -w '%{http_code}\n' -X PUT https://<домен>/mdm/checkin
Ожидается 400: пустой запрос дошёл до Ринго и отклонён с сообщением «Отсутствует тело mdm запроса».
curl -s -o /dev/null -w '%{http_code}\n' -X PUT https://<домен>/mdm/connect
Ожидается 400, как и для /mdm/checkin.
curl -s -o /dev/null -w '%{http_code}\n' https://<домен>/enroll
Ожидается 200: открывается страница регистрации.
curl -s -o /dev/null -w '%{http_code}\n' https://<домен>/agent/manifest
Ожидается 200: сервер вернул сведения о версии агента.
curl -s -o /dev/null -w '%{http_code}\n' "https://<домен>/socket.io/?EIO=4&transport=polling"
Ожидается 200: канал агента доступен.
Если вы получили 403, 404, 502, 503 или 000 (нет ответа), см. Сеть → адреса. Если код совпадает, но в ответе HTML-страница вместо текста или JSON, отвечает не Ринго, а прокси или WAF.
¶ 5. Связь сервера с Apple
Push отправляет backend, поэтому проверку выполняйте на сервере Ринго:
curl -s --http2 -X POST https://api.push.apple.com/3/device/0 -w ' %{http_code}\n'
Ожидаемый ответ — {"reason":"MissingProviderToken"} 403: Apple ответил. Если ответа нет, исходящий трафик на порт 443 к 17.0.0.0/8 закрыт или серверу нужен прокси. См. Сеть → от сервера до Apple.
¶ 6. Связь устройств с Apple
Выполните из сети устройств:
nc -vz -G 5 courier.push.apple.com 5223 # macOS
nc -vz -w 5 courier.push.apple.com 5223 # Linux
Если порт 5223 закрыт, push не доходят до устройств в этой сети. Исключение — устройства в Wi-Fi, которые могут использовать порт 443. См. Сеть → от устройств до Apple. На управляемом Mac можно сразу проверить, доходят ли push: см. Диагностика на устройстве → доставка push.
¶ 7. Лицензия
Откройте Настройки → Лицензия. На странице указаны срок действия и количество устройств, которые ещё можно добавить, — отдельно для компьютеров и мобильных устройств.
Если указано «Осталось: 0» или срок истёк, новые устройства не регистрируются. См. Регистрация → лицензия.
¶ 8. Время на сервере
timedatectl | grep -E 'synchronized|NTP'
date -u; curl -sI https://<домен>/health | grep -i '^date'
Срок действия сертификатов, которые Ринго выдаёт по SCEP, отсчитывается от времени сервера. Если часы сервера спешат, на устройстве выданный сертификат может оказаться ещё не действующим. Включите синхронизацию времени: timedatectl set-ntp true.
¶ Все проверки пройдены, а проблема осталась
Значит, проблема затрагивает часть устройств или один канал управления. Найдите симптом в таблицах на странице «Начните здесь» или проверьте само устройство по странице Диагностика на устройстве.
¶ Если проблема не решена
Обратитесь в техническую поддержку. Что указать в обращении, описано на странице Обращение в поддержку.
Проверено на Ринго 3.0.5, октябрь 2026. Тексты ошибок — Справочник ошибок, термины — Термины.