Чаще всего Plex Media Server не видит файлы в папке из-за недостаточных прав доступа: служба Plex работает от отдельного системного пользователя и физически не может прочитать каталог, даже если вы сами открываете его без проблем. Второй по частоте источник проблемы — неподдерживаемые имена файлов и папок, из-за которых сканер просто пропускает содержимое.
Ниже разберём проверенные причины и порядок диагностики: от банальной перепроверки пути библиотеки до нюансов с сетевыми дисками, Docker-контейнерами и символическими ссылками. Начинайте с первого раздела и двигайтесь по списку — в большинстве ситуаций проблема решается на одном из первых шагов.
Как Plex сканирует библиотеку и почему файлы «пропадают»
Медиасервер не показывает содержимое папки в реальном времени — он строит собственную базу данных при сканировании. Если файл появился в каталоге после последнего сканирования, а автоматическое обновление отключено, в интерфейсе его не будет. Проверьте настройку Настройки → Библиотека → Сканировать библиотеку автоматически и запустите сканирование вручную через меню библиотеки.
Важный нюанс: сканер молча пропускает файлы, которые не может прочитать или распознать, и не всегда показывает явную ошибку. Поэтому «пустая» библиотека почти никогда не означает сбой самого Plex — это сигнал проверить доступ, имена и структуру каталогов.
Проверка пути библиотеки и типа агента
Начните с самого простого: убедитесь, что в настройках библиотеки указан именно тот путь, где лежат файлы. Откройте Управление → Библиотеки → Изменить → Добавить папки и сверьте каталог. Частая ошибка — добавлена родительская папка уровнем выше или, наоборот, слишком глубокий подкаталог, а файлы лежат рядом.
Также проверьте соответствие типа библиотеки содержимому. Если библиотека создана как «Фильмы», а в папке лежат серии с сезонной структурой, сканер может их не подобрать корректно. То же касается агента: устаревшие агенты иногда ведут себя непредсказуемо, поэтому для новых библиотек используйте современные агенты Plex Movie и Plex TV Series, если они доступны в вашей версии сервера.
- 📂 Путь в настройках библиотеки совпадает с реальным расположением файлов
- 🎬 Тип библиотеки (фильмы/сериалы/музыка) соответствует содержимому
- 🔄 Ручное сканирование запускалось после добавления файлов
- 🧩 Используется актуальный агент, а не устаревший
Права доступа — причина номер один
На Windows служба Plex по умолчанию может работать от системной учётной записи, у которой нет доступа к пользовательским папкам и сетевым ресурсам. На Linux и NAS сервер обычно запускается от пользователя plex, и если у этого пользователя нет прав на чтение каталога с медиа, сканирование вернёт пустой результат.
На Linux проверить и выдать права можно командами:
sudo chown -R plex:plex /путь/к/медиа
sudo chmod -R 755 /путь/к/медиа
В Windows вариант без перенастройки прав — запускать Plex Media Server как приложение от своего пользователя, а не как службу, либо в свойствах службы указать учётную запись, у которой есть доступ к папкам с медиа. После изменения прав обязательно перезапустите сервер и повторите сканирование.
⚠️ Внимание: команда chmod -R 777, которую часто советуют на форумах, открывает доступ всем пользователям системы, включая запись. Это небезопасно — используйте минимально необходимые права на чтение.
Именование файлов и структура папок
Plex ориентируется на официальные правила именования, и нарушение структуры — частая причина «невидимых» файлов. Для фильмов рекомендуемый формат — Название (год).mkv, для сериалов — папка сериала, внутри папки сезонов и файлы вида Название - S01E01.mkv. Файлы с хаотичными названиями вроде final_rip_new(2).avi сканер может проигнорировать или отнести не туда.
Отдельная ловушка — скрытые и служебные элементы. Файлы и папки, начинающиеся с точки, а также каталоги с именем @eaDir (их создают некоторые NAS Synology), сканером игнорируются. Если в папке только один видеофайл и он лежит в корне библиотеки без подпапки, некоторые типы библиотек тоже могут его не подхватить — надёжнее раскладывать контент по отдельным каталогам.
Рекомендуемая структура папок для сериалов
Сериалы/Название сериала/Season 01/Название - S01E01.mkv, Название - S01E02.mkv и так далее. Название папки сериала должно совпадать с официальным названием, год можно указать в скобках для точного совпадения.
Сетевые диски, Docker и симлинки
Сетевые ресурсы — отдельный источник проблем. Подключенный в Windows сетевой диск с буквой (например, Z:\) существует только в сессии пользователя: служба Plex, работающая вне этой сессии, его не видит. Решение — указывать в библиотеке UNC-путь вида \\NAS\media\films и запускать сервер от учётной записи с доступом к этой шаре.
В Docker логика та же, но добавляется слой маппинга: контейнер видит только те каталоги, которые проброшены через тома. Если внутри контейнера путь /media смонтирован, а файлы лежат вне него, Plex их не увидит. Проверьте секцию volumes в конфигурации контейнера и права на хосте — пользователь, от которого работает Plex внутри контейнера (задаётся переменными PUID/PGID в популярных образах), должен иметь доступ на чтение.
Символические ссылки поддерживаются не везде одинаково: на Linux они обычно работают, если у Plex есть права на конечную цель, а вот в Docker-окружении ссылка, указывающая за пределы смонтированного тома, приведёт в никуда.
| Среда | Типичная причина | Что проверить |
|---|---|---|
| Windows (служба) | Нет доступа к сетевому диску | UNC-путь, учётная запись службы |
| Linux | Права пользователя plex | chown/chmod на каталог медиа |
| NAS (Synology и др.) | Разрешения общей папки | Доступ системного пользователя Plex |
| Docker | Каталог не проброшен в контейнер | Секция volumes, PUID/PGID |
⚠️ Внимание: после любых изменений прав, путей или монтирования томов перезапускайте Plex Media Server целиком, а не только обновляйте библиотеку — иначе старая сессия продолжит работать с прежним окружением.
Пошаговая диагностика: от простого к сложному
Чтобы не гадать, пройдите проверку последовательно. Сначала положите в проблемную папку один тестовый файл с «правильным» именем, например Test Movie (2020).mkv, и запустите сканирование. Если он появился — проблема в именах или структуре остальных файлов. Если нет — дело в правах или пути.
☑️ Диагностика «Plex не видит файлы»
Полезный инструмент — журналы сервера. В веб-интерфейсе откройте Настройки → Консоль (или смотрите файлы логов в каталоге данных Plex) во время сканирования: там видно, какие каталоги сканер открывает и на чём спотыкается. Ошибки вида «Permission denied» прямо укажут на проблему с доступом.
Когда ничего не помогает
Если права, пути и имена проверены, а файлы по-прежнему не появляются, остаются менее частые сценарии. Возможная причина — повреждённая база данных Plex: в этом случае помогает очистка через Настройки → Устранение неполадок → Оптимизировать базу данных и очистка корзины, после чего сканирование запускается заново.
Также проверьте, что сами файлы не повреждены и открываются в обычном плеере: битый контейнер с нулевым размером или прерванной загрузкой сканер обоснованно пропустит. И убедитесь, что версия сервера актуальна — старые выпуски могли содержать ошибки сканирования, исправленные в свежих обновлениях.
Частые вопросы
Plex видит папку, но она пустая при сканировании — что делать?
Почти всегда это права доступа: сервер смог открыть каталог, но не может прочитать файлы внутри. Проверьте владельца и права на файлы, а не только на папку, затем перезапустите сервер и повторите сканирование.
Почему Plex не видит файлы на сетевом диске Windows?
Диск с буквой подключается только в пользовательской сессии, а служба Plex работает вне её. Укажите в библиотеке UNC-путь вида \\сервер\папка и настройте запуск сервера от учётной записи с доступом к сетевому ресурсу.
Нужно ли переименовывать все файлы под правила Plex?
Строгая схема критична в первую очередь для сериалов — без маркеров сезона и серии сканер не сможет корректно их разложить. Фильмы с «неправильными» именами обычно попадают в библиотеку, но могут получить неверные метаданные или не распознаться вовсе.
Файлы появляются только после ручного сканирования — это нормально?
Это означает, что отключено или не работает автоматическое обнаружение изменений. Включите опцию автоматического сканирования в настройках библиотеки. На сетевых и внешних дисках автообнаружение может не срабатывать — тогда помогает периодическое сканирование по расписанию.
Может ли антивирус мешать сканированию Plex?
Да, возможная причина — антивирус блокирует службе доступ к каталогам или изолирует файлы при проверке. Временно добавьте папку с медиа в исключения и повторите сканирование, чтобы проверить эту гипотезу.