Чаще всего Plex не видит файлы в папке из-за неправильных имён файлов, недостаточных прав доступа к каталогу или устаревшего кэша библиотеки — и в подавляющем большинстве случаев проблема решается без переустановки сервера. Первым делом проверьте, совпадает ли путь, указанный в настройках библиотеки, с реальным расположением папки на диске, и обновите библиотеку принудительно через кнопку «Обновить библиотеку» (Scan Library Files).
Медиасервер Plex Media Server индексирует контент по строгим правилам: он анализирует структуру каталогов, имена файлов и метаданные. Если хотя бы одно условие нарушено, файл просто не попадёт в библиотеку, хотя на диске он есть и открывается любым плеером. Ниже разберём все типичные причины и способы их устранения — от самых простых до специфических сценариев с NAS и сетевыми дисками.
Проверка пути к папке и обновление библиотеки
Начните с самого очевидного: откройте настройки библиотеки в веб-интерфейсе Plex (Настройки → Библиотеки → Изменить → Добавить папки) и сверьте указанный путь с фактическим расположением файлов. Типичная ошибка — папка была переименована или перемещена, а в настройках остался старый путь. При этом Plex не выдаёт явной ошибки, а просто показывает пустую библиотеку.
После проверки пути выполните принудительное сканирование. В ряде случаев автоматическое обновление отключено или не срабатывает, поэтому запустите его вручную:
- 🔍 Нажмите на три точки рядом с названием библиотеки и выберите «Обновить библиотеку» (Scan Library Files);
- ⚙️ Проверьте в настройках сервера пункт
Библиотека → Сканировать библиотеки автоматически— он должен быть включён; - 🗑️ Если файлы удалялись или перемещались, выполните «Очистить корзину» (Empty Trash), чтобы убрать устаревшие записи;
- 🔄 При подозрении на повреждённый кэш используйте «Обновить все метаданные» (Refresh All Metadata).
☑️ Базовая диагностика библиотеки Plex
Если после ручного сканирования файлы не появились, перезапустите сам сервер. На Windows это делается через значок в системном трее, на Linux — командой sudo systemctl restart plexmediaserver. Перезапуск сбрасывает зависшие процессы индексации, которые иногда блокируют обнаружение новых файлов.
Имена файлов и структура папок
Plex сильно зависит от соглашений об именовании. Фильм с названием вида Film.2019.1080p.BluRay.x264-GROUP.mkv обычно распознаётся, а вот файл movie_final_v2_новый.mkv может быть проигнорирован сканером. Рекомендуемый формат для фильмов — «Название (год).расширение», для сериалов — «Название — S01E01», при этом сериалы должны лежать в отдельных папках по сезонам.
Структура каталогов тоже имеет значение. Не смешивайте фильмы и сериалы в одной библиотеке — для каждого типа контента создаётся отдельная библиотека со своим агентом метаданных. Если библиотека создана как «Фильмы», а внутри лежат серии сериала, сканер может не добавить их корректно или пропустить вовсе.
⚠️ Внимание: файлы, лежащие непосредственно в корне папки библиотеки без вложенных каталогов, иногда игнорируются сканером сериалов. Для сериалов обязательна структура «Название сериала/Season 01/эпизоды». Проверьте соответствие официальным рекомендациям Plex по именованию.
Также проверьте, нет ли в папке файла .plexignore — он создаётся вручную или сторонними утилитами и содержит шаблоны исключений. Его наличие — частая причина «невидимости» целых каталогов.
Права доступа к папке
На Linux и NAS это причина номер один. Служба Plex Media Server работает от имени отдельного пользователя (обычно plex), и если у этого пользователя нет прав на чтение каталога, файлы для сервера попросту не существуют. Проверить и выдать права можно командами:
sudo chown -R plex:plex /путь/к/медиа
sudo chmod -R 755 /путь/к/медиа
На Windows ситуация иная: если сервер установлен как служба, он работает от системной учётной записи и может не иметь доступа к сетевым папкам и дискам, подключённым под вашим пользователем. Вам нужно либо запускать Plex от своего имени, либо настроить службу на работу от учётной записи, у которой есть доступ к нужным ресурсам.
Сетевые диски и NAS
Когда медиатека находится на сетевом диске или NAS (Synology, QNAP и подобных), добавляются специфические нюансы. На Windows сетевой диск, подключённый как буква (например, Z:\), виден только в контексте вашего пользователя. Plex, запущенный как служба, его не увидит. Решение — указывать UNC-путь вида \\NAS\media\films вместо буквы диска.
На самих NAS убедитесь, что пакету Plex разрешён доступ к общей папке. На Synology это настраивается через Панель управления → Общие папки → Разрешения, где системному пользователю Plex нужно выдать права на чтение. Точный путь и название раздела могут отличаться в зависимости от версии DSM — сверяйтесь с документацией вашей модели.
| Причина | Как проявляется | Что проверить |
|---|---|---|
| Неверный путь к папке | Библиотека пустая полностью | Путь в настройках библиотеки |
| Нет прав доступа | Часть папок видна, часть — нет | Права пользователя plex / учётной записи службы |
| Неправильные имена | Отдельные файлы отсутствуют | Формат «Название (год)», S01E01 для сериалов |
| Сетевой диск по букве | Пустая библиотека на Windows-службе | Использование UNC-пути \\сервер\папка |
| Файл .plexignore | Игнорируются целые каталоги | Наличие и содержимое файла в папке |
Неподдерживаемые форматы и повреждённые файлы
Plex сканирует медиафайлы, и если контейнер или кодек не распознаётся, файл может не попасть в библиотеку. Сначала убедитесь, что файл вообще воспроизводится — откройте его в VLC или другом плеере прямо с того же диска. Битый или недокачанный файл сканер проигнорирует молча.
Обратите внимание и на расширения: файлы .part, .tmp, .!qb — это недокачанные загрузки, которые Plex не станет индексировать. То же касается образов дисков в некоторых конфигурациях и файлов с нулевым размером.
Как посмотреть логи сканирования
Логи Plex находятся в папке Logs каталога данных сервера (путь зависит от ОС: на Windows это обычно %LOCALAPPDATA%\Plex Media Server\Logs). Файл Plex Media Scanner.log показывает, какие папки сканер обработал и какие файлы пропустил с указанием причины. Это самый надёжный способ понять, почему конкретный файл не попал в библиотеку.
Кэш, агенты и пересоздание библиотеки
Если ничего из перечисленного не помогло, виновником может быть повреждённая база данных библиотеки. Симптомы: сканирование завершается мгновенно, новые файлы не появляются, хотя старые отображаются. В таком случае попробуйте последовательно: очистить корзину, оптимизировать базу данных (Настройки → Управление → Оптимизировать базу данных), затем перезапустить сервер и повторить сканирование.
⚠️ Внимание: удаление и пересоздание библиотеки — крайняя мера. Вы потеряете историю просмотров, пользовательские коллекции и отметки «просмотрено» для этой библиотеки. Перед этим убедитесь, что исчерпаны остальные варианты, и не удаляйте сами файлы — только библиотеку в интерфейсе Plex.
Также проверьте выбранный агент метаданных в настройках библиотеки. Устаревшие агенты после обновлений сервера иногда перестают корректно добавлять контент. Переключение на актуальный агент Plex Movie или Plex TV Series и повторное сканирование решают эту ситуацию.
Часто задаваемые вопросы
Plex видит папку, но не видит файлы внутри — в чём причина?
Чаще всего дело в правах доступа на уровне файлов (папка доступна, а файлы — нет) либо в именах, не соответствующих правилам сканера. Проверьте лог сканера и права на конкретные файлы, а не только на каталог.
Почему Plex не видит файлы на внешнем USB-диске?
Возможные причины: диск смонтирован после старта сервера, у службы Plex нет прав на точку монтирования, либо файловая система диска (например, exFAT на Linux) смонтирована с ограничениями. Перезапустите сервер после подключения диска и проверьте права.
Нужно ли переименовывать все файлы вручную?
Нет, существуют утилиты для пакетного переименования по шаблонам Plex (например, FileBot и аналоги). Они автоматически приводят имена к формату «Название (год)» или «S01E01», что заметно упрощает подготовку большой медиатеки.
Файлы появляются, но без обложек и описаний — это та же проблема?
Нет, это проблема загрузки метаданных, а не сканирования. Проверьте интернет-соединение сервера, выбранный агент и язык метаданных в настройках библиотеки, затем выполните «Обновить все метаданные».
Поможет ли переустановка Plex Media Server?
Переустановка редко решает проблему «невидимых» файлов, потому что причина почти всегда во внешних факторах: путях, правах, именах или сетевых подключениях. Сначала выполните диагностику по шагам из этой статьи — переустановка оправдана только при повреждении самой установки сервера.