Главная › Помощь › MediaMTX и запуск

Не работает MediaMTX? 5 частых проблем

Окно CMD мигает и закрывается? MediaMTX не стартует из-за невалидного yaml или блокировки антивирусом? Разбор 5 типовых проблем с готовыми решениями и шаблонами конфига.

Попробовать бесплатно →Смотреть демо

MediaMTX — популярный open-source ретранслятор RTSP, RTMP, HLS, WebRTC. При первом запуске на Windows у ~80% пользователей возникают одинаковые ошибки. Ниже собрали 5 самых частых, которые приходят в нашу поддержку, и готовые решения, проверенные на сотнях инсталляций.

Содержание:
  1. MediaMTX не запускается
  2. Частые ошибки YAML-конфига
  3. Антивирус блокирует MediaMTX
  4. Порт 8554 занят другой программой
  5. Запущено несколько экземпляров MediaMTX

MediaMTX не запускается

Окно CMD мигает и закрывается

Причина. Обычно причина — ошибка в файле mediamtx.yml (неправильные отступы, невалидные ключи, склеенные строки).

  1. Откройте CMD вручную: Win+R → cmd → Enter
  2. Перейдите в папку: cd C:\mediamtx
  3. Запустите: mediamtx.exe — прочитайте ошибку в консоли
  4. Исправьте конфиг по шаблону ниже или пересоздайте файл с нуля в Блокноте (Notepad)

Советы:

  • Редактируйте ТОЛЬКО в Блокноте (Notepad). НЕ используйте WordPad или Word — они ломают форматирование
  • Отступы — только пробелы (2 пробела), никогда табы
  • Значение ":8554" и URL источника обязательно в кавычках

Частые ошибки YAML-конфига

Ошибки при запуске MediaMTX из-за конфига

Антивирус блокирует MediaMTX

MediaMTX не запускается или закрывается — антивирус удаляет файл

Причина. Антивирус (Kaspersky, Dr.Web, Windows Defender и др.) может распознать mediamtx.exe как подозрительный файл и заблокировать или удалить его.

  1. Проверьте карантин антивируса — если mediamtx.exe там, восстановите его
  2. Добавьте папку C:\mediamtx в исключения антивируса
  3. Для Windows Defender: Параметры > Безопасность > Защита от вирусов > Исключения > Добавить папку

Советы:

  • MediaMTX — легитимная open-source программа. Антивирусы реагируют на неподписанные exe-файлы
  • Если антивирус управляется централизованно (корпоративный) — попросите сисадмина добавить исключение

Порт 8554 занят другой программой

MediaMTX не может запуститься — порт уже используется

Причина. Другая программа (или второй экземпляр MediaMTX) уже слушает порт 8554. MediaMTX выдаст ошибку: "address already in use".

  1. Найдите PID процесса (последний столбец) и завершите его: taskkill /PID <номер> /F
  2. Если порт занят системным сервисом — смените порт MediaMTX в конфиге на 8555

Запущено несколько экземпляров MediaMTX

Конфликт портов, видео не обновляется

Причина. Если MediaMTX запущен вручную + через автозапуск + через ярлык — возникает конфликт.

Не получается починить сами?

RTSP.KZ берёт ретрансляцию на себя — вы подключаете камеру, мы отдаём HLS-ссылку для браузера и e-ondiris.gov.kz. 1 час бесплатно без регистрации.

Начать →

Смотрите также

Камера и RTSP-потокVPN и сетьТрансляция на сайтеWindowsRTSP не открываетсяПорт 554Проброс портаVPN для камерыRTSP в браузере