SSD Nodes Learn Hosting plans →
Руководства Matt ConnorАвтор: Matt Connor

Где Nextcloud хранит файлы в Docker

Узнайте, как найти путь к данным в контейнере и на хосте. Разбираем структуру папок /data и /config, а также необходимые компоненты для создания полной резервной копии.

Где Nextcloud в Docker хранит файлы

Nextcloud в Docker хранит файлы в каталоге данных внутри контейнера, а фактическое расположение на сервере определяется томом или bind mount, подключённым к контейнеру. В образе linuxserver.io lscr.io/linuxserver/nextcloud пользовательские файлы находятся в /data, а config.php, приложения и темы — в /config. Оба пути относятся к контейнеру. Одна команда выводит путь на хосте, соответствующий этим путям, а в остальной части руководства рассматривается более сложная половина вопроса: всё, что не хранится в каталоге данных.

Зафиксируйте тег образа. Пути относятся к образу, а не к Nextcloud, и плавающий тег может измениться без вашего контроля. На 20 ноября 2026 года текущим стабильным выпуском образа является 35.0.3-ls3, содержащий Nextcloud 35.0.3, четвёртый выпуск основной версии Nextcloud 35. Образ обновляется только на одну основную версию за раз, поэтому стек, всё ещё работающий на 34.x, перейдёт на 35 за один шаг, и перед этим шагом стоит сделать резервную копию.

services:
  nextcloud:
    image: lscr.io/linuxserver/nextcloud:35.0.3-ls3
    container_name: nextcloud
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
    volumes:
      - nextcloud_config:/config
      - nextcloud_data:/data
    ports:
      - 443:443
    restart: unless-stopped

  nextcloud-db:
    image: mariadb:11.8
    container_name: nextcloud-db
    environment:
      - MARIADB_ROOT_PASSWORD=${MARIADB_ROOT_PASSWORD}
      - MARIADB_DATABASE=nextcloud
      - MARIADB_USER=nextcloud
      - MARIADB_PASSWORD=${NEXTCLOUD_DB_PASSWORD}
    volumes:
      - nextcloud_db:/var/lib/mysql
    restart: unless-stopped

volumes:
  nextcloud_config:
  nextcloud_data:
  nextcloud_db:

Два пароля берутся из файла .env рядом с compose-файлом, поэтому они не попадают в сам compose-файл. Итого в ответе три тома, и только один из них хранит пользовательские файлы.

Эти пути внутри контейнера взяты из документации именно для этого образа. Другой образ Nextcloud может иметь другую структуру файловой системы и хранить установку в собственном web root, поэтому путь, скопированный из сообщения на форуме, является лишь предположением. Проверьте фактические пути в работающем контейнере.

docker inspect nextcloud

Раздел Mounts в этом выводе содержит список всех mount, где Source — сторона на хосте, а Destination — сторона в контейнере. Этот список даёт ответ для вашей конфигурации независимо от выбранного образа.

Как найти реальный путь на хосте для тома?

Именованный том управляется Docker, поэтому путь к нему не выбирается вручную. Его нужно запросить.

docker volume ls
docker volume inspect nextcloud_nextcloud_data

Имя имеет значение. Docker Compose добавляет к именам томов имя проекта. По умолчанию это имя каталога, в котором находится compose-файл. Поэтому том, указанный в файле как nextcloud_data, обычно существует на диске как nextcloud_nextcloud_data. Команда docker volume ls показывает реальные имена. Сокращённый вывод inspect выглядит так:

[
    {
        "CreatedAt": "2026-08-18T09:12:44Z",
        "Driver": "local",
        "Mountpoint": "/var/lib/docker/volumes/nextcloud_nextcloud_data/_data",
        "Name": "nextcloud_nextcloud_data",
        "Scope": "local"
    }
]

Mountpoint — это нужный путь. Получайте его из вывода команды, а не определяйте заранее, потому что путь может измениться. В rootless Docker весь корень данных Docker по умолчанию находится в домашнем каталоге пользователя, от имени которого запущен daemon. Поэтому путь начинается с другого места.

Bind mount устраняет этот вопрос. Укажите - /srv/nextcloud/data:/data в compose-файле, и путем на хосте будет введённый вами путь. Команда docker inspect показывает его как Source. Выбор влияет не только на путь, потому что именованные тома и bind mount по-разному работают с правами владельца и резервным копированием.

Почему каталог данных не является резервной копией

В руководстве Nextcloud указаны пять элементов, которые должна сохранять резервная копия: каталог конфигурации, каталог пользовательских приложений, каталог данных, каталог темы и база данных. В этом образе каталоги конфигурации, приложений и темы находятся в /config, а база данных работает в отдельном контейнере со своим томом. Если скопировать только /data, вы сохраните наименее важную часть системы.

База данных важна, потому что веб-интерфейс не просматривает каталог напрямую. Он отображает строки из файлового кэша. Поэтому в руководстве после ручного копирования файлов в каталог данных предлагается запустить сканирование. Восстановите /data рядом с пустой базой данных — и получите байты без индекса: без пользователей, общих ресурсов и записей в списке файлов. Восстановите базу данных рядом с пустым /data — и каждая строка будет ссылаться на отсутствующий файл.

config.php содержит учетные данные базы данных и доверенные домены. В нем также хранится идентификатор экземпляра. При добавлении префикса appdata_ этот идентификатор используется в имени каталога данных приложения. Получите эти значения из работающего экземпляра, а не используйте сохраненные в памяти значения.

docker exec -it nextcloud occ config:system:get datadirectory
docker exec -it nextcloud occ config:system:get instanceid

Первая команда выводит каталог данных, который фактически использует этот экземпляр. Здесь это /data. В этом образе в PATH доступна оболочка occ, поэтому запустите ее напрямую через docker exec. Не копируйте более длинную форму sudo и php occ из руководства Nextcloud. Она предназначена для установки вне контейнера.

Что незаметно заполняет том с данными?

Миниатюры и история по каждому пользователю хранятся в том же томе, что и файлы. При этом ни то ни другое не учитывается в объёме хранилища, который пользователь видит в веб-интерфейсе.

  • Миниатюры — это сгенерированные изображения предварительного просмотра. Они хранятся в каталоге данных приложения внутри каталога данных. Имя каталога начинается с appdata_, за которым следует идентификатор экземпляра.
  • Удалённые файлы остаются в корзине. trashbin_retention_obligation по умолчанию имеет значение auto. Поэтому удалённые файлы могут храниться дольше 30 дней, если свободного места достаточно, но также могут быть удалены раньше 30 дней, если требуется освободить место. Удалённые файлы не учитываются в обычной квоте пользователя, но у корзины есть собственный лимит: по умолчанию до 50% пространства квоты, оставшегося у пользователя, либо свободное место на диске для пользователя без квоты. Когда корзина превышает этот лимит, Nextcloud сначала удаляет самые старые подходящие элементы, включая элементы младше 30 дней при значении auto.
  • Старые версии также сохраняются. versions_retention_obligation по умолчанию имеет значение auto. Этот параметр со временем сокращает число версий и сохраняет последнюю версию в каждом временном интервале. Если задан максимальный срок хранения, фоновая задача удаляет версии, срок хранения которых истёк, или версии файлов, которых больше нет. Для учётных записей с квотой приложение Versions ориентируется на 50% свободного пространства квоты, доступного пользователю в данный момент. Для учётных записей без квоты оно напрямую использует свободное место в файловой системе. При необходимости освободить место приложение сначала удаляет самые старые версии, сохраняя как минимум две последние. Поэтому целевое значение не является жёстким ограничением. Версия, которую пользователь отметил вручную, не удаляется автоматически по истечении срока хранения. Однако пользователь всё равно может удалить её вручную, а occ versions:cleanup удаляет отмеченные версии вместе с остальными.

Перед удалением чего-либо измерьте объём данных.

docker exec -it nextcloud sh -c 'du -sh /data/*'
docker exec -it nextcloud sh -c 'du -sh /data/appdata_*'

В первой строке указано по одному числу для каталога каждого пользователя и для каталога данных приложения. Если число для данных приложения велико, проверьте его подкаталог preview. В данных приложения также хранятся аватары и кэшированные ресурсы. Приведённые ниже команды очистки описаны в документации, и каждая из них намеренно удаляет данные.

docker exec -it nextcloud occ trashbin:cleanup --all-users
docker exec -it nextcloud occ versions:cleanup alice
docker exec -it nextcloud occ preview:cleanup

preview:cleanup удаляет все сгенерированные миниатюры. Nextcloud создаёт их заново, когда пользователи открывают соответствующие файлы. Поэтому свободное место постепенно снова расходуется, а процессор получает дополнительную нагрузку. Если том является только частью более общей проблемы с диском, обычно другой частью являются старые образы и неактуальный кэш сборки.

Почему файлы, которые вы копируете на host, не появляются в Nextcloud?

Nextcloud читает кэш файлов из базы данных, а не из каталога. После копирования на диске появился файл без соответствующей записи в базе данных, поэтому web-интерфейсу нечего показывать. В руководстве описан именно этот случай: после прямого копирования файлов в каталог данных требуется выполнить сканирование.

docker exec -it nextcloud occ files:scan --path="/alice/files/Photos"
docker exec -it nextcloud occ files:scan --all --unscanned -v
docker exec -it nextcloud occ files:scan --all

Аргумент --path также показывает структуру каталога данных: у каждого пользователя есть каталог с его именем пользователя, а files внутри этого каталога содержит файлы, отображаемые в web-интерфейсе. Если вы знаете, куда были скопированы файлы, просканируйте один путь. --all обходит всех пользователей и на крупном экземпляре занимает много времени. --unscanned обрабатывает только файлы, которые ещё не были полностью просканированы. -v выводит каждый файл по мере обработки. Благодаря этому можно отличить команду, которая действительно зависла, от команды, за выполнением которой можно наблюдать.

Права владельца определяют, будет ли достаточно одного сканирования. Если пользователь контейнера не может записать файл, он индексируется, но затем его нельзя переместить. Поэтому список файлов выглядит корректно, а переименование или удаление файла через web-интерфейс завершается ошибкой.

Почему запись завершается ошибкой после установки PUID и PGID?

Потому что ядро сравнивает числа, а не имена. PUID и PGID задают числовой идентификатор пользователя (uid) и идентификатор группы (gid), от имени которых выполняется процесс в контейнере. Каждый файл на хосте также имеет числового владельца. Если эти числа не совпадают, в записи будет отказано, независимо от того, как имена выглядят с обеих сторон.

docker exec -it nextcloud id abc
sudo ls -ln /var/lib/docker/volumes/nextcloud_nextcloud_data/_data

id abc выводит uid и gid, которые реально использует контейнер; это те самые PUID и PGID, которые вы установили. ls -ln выводит числовых владельцев, и здесь важен -n: обычный ls -l транслирует эти числа через список пользователей хоста и показывает имя, которое внутри контейнера ничего не значит. Сравните эти два числа.

Затем протестируйте запись, вместо того чтобы гадать.

docker exec -u abc -it nextcloud touch /data/writetest

Permission denied с указанием /data служит подтверждением. Исправьте владельца изнутри контейнера, а затем снова запустите тот же тест.

docker exec -u 0 -it nextcloud chown -R abc:abc /data
docker exec -u abc -it nextcloud touch /data/writetest
docker exec -u abc -it nextcloud rm /data/writetest

Делайте это изнутри не просто так. В rootless Docker идентификаторы пользователей контейнера отображаются через подчиненный диапазон в /etc/subuid, поэтому uid 1000 внутри контейнера соответствует гораздо большему uid на хосте. Команда chown 1000:1000 на стороне хоста в таком случае установит владельца, которого контейнер не сможет использовать, и запись по-прежнему будет завершаться ошибкой. Запуск chown внутри контейнера проходит через то же отображение, которое использует сам процесс Nextcloud, поэтому числа совпадают по определению. Именно поэтому PUID и PGID должны совпадать с владельцем на диске, прежде чем вы начнете отладку чего-либо еще.

Как создавать резервную копию, чтобы восстановление действительно работало?

Снимайте дамп базы данных и копируйте каталоги в один и тот же момент. Режим обслуживания запрещает вход пользователей, поэтому между созданием дампа и копированием файлов новые загрузки не появятся.

docker exec -it nextcloud occ maintenance:mode --on
docker exec nextcloud-db mariadb-dump --single-transaction -u nextcloud -p"$NEXTCLOUD_DB_PASSWORD" nextcloud > nextcloud-sqlbkp.sql
docker run --rm -v nextcloud_nextcloud_data:/data:ro -v "$PWD":/backup alpine:3.22 tar czf /backup/nextcloud-data.tgz -C /data .
docker run --rm -v nextcloud_nextcloud_config:/config:ro -v "$PWD":/backup alpine:3.22 tar czf /backup/nextcloud-config.tgz -C /config .
docker exec -it nextcloud occ maintenance:mode --off

Обратите внимание, какого параметра нет в команде создания дампа: флага -t. TTY преобразует окончания строк. SQL-дамп, прошедший через TTY, повреждается, и это обнаруживается только во время восстановления. Также обратите внимание: пароль в командной строке виден в выводе ps, пока выполняется команда. Чтение пароля из файла .env в shell позволяет не вводить его в историю shell, но не скрывает подставленное значение аргумента командной строки. В старых образах базы данных используется mysqldump вместо mariadb-dump. Руководство описывает оба варианта.

Для восстановления загрузите дамп в пустую базу данных, распакуйте оба архива в новые тома, запустите контейнеры, а затем отключите режим обслуживания. Если каталоги и дамп созданы в разное время, файловый кэш и данные на диске расходятся. Команда occ files:scan --all исправляет только одно направление расхождения. Она находит файлы, для которых есть файл, но нет строки в базе данных. Она не может восстановить файл, на который указывает строка.

Храните результат за пределами сервера. Копия на том же VPS будет потеряна вместе с VPS. Поэтому restic в удалённый репозиторий должен входить в этот процесс. По этой же причине снимок у провайдера — это другой инструмент, а не резервная копия. Если вы ещё разворачиваете стек, в материале полная установка Nextcloud на VPS описаны reverse proxy и сертификат TLS (transport layer security), которые не рассматриваются в этом руководстве.

FAQ

Где находится каталог данных Nextcloud в Docker-контейнере?

В образе linuxserver.io он находится в контейнере по пути /data, а приложения и темы — по пути config.php и ниже /config. Это пути внутри контейнера. Чтобы узнать путь на хосте, выполните docker inspect nextcloud и прочитайте значение Source в разделе Mounts либо выполните docker volume inspect для тома и прочитайте Mountpoint. В других образах Nextcloud используются другие пути внутри контейнера. Проверьте документацию для закреплённого tag и подтвердите путь с помощью docker exec -it nextcloud occ config:system:get datadirectory.

Почему файлы, которые я копирую в том, не отображаются в Nextcloud?

Nextcloud получает список файлов из file cache в базе данных, а не читает каталог напрямую. Поэтому файл, добавленный в обход Nextcloud, не имеет соответствующей записи и остаётся невидимым. Выполните docker exec -it nextcloud occ files:scan --path="/alice/files/Photos" для одного каталога или occ files:scan --all для всех пользователей. Если файлы отображаются, но их нельзя переместить или удалить, причина связана с владельцем: пользователь контейнера должен иметь право записи.

Достаточно ли копии тома с данными для восстановления Nextcloud?

Нет. В томе с данными содержится содержимое файлов. В базе данных находятся индекс файлов, пользователи и общие ресурсы, а config.php содержит учётные данные базы данных и идентификатор экземпляра. Для рабочего восстановления нужны каталог данных, каталог конфигурации, база данных, а также каталоги custom apps и тем, если вы их используете. Скопируйте все эти данные на один и тот же момент времени. Если база данных новее файлов, она может ссылаться на отсутствующие файлы.

Почему мой том с данными намного больше, чем объём файлов, видимых пользователям?

В томе также хранятся previews, удалённые файлы и старые версии. Они не входят в объём, который видит пользователь. Измерьте объём с помощью docker exec -it nextcloud sh -c 'du -sh /data/*'. По умолчанию корзина удаляет файлы, которым больше 30 дней, если требуется освободить место, и хранит их дольше, если свободного места достаточно. Очистка версий нацелена на половину оставшегося места квоты для учётных записей с квотой и напрямую использует свободное место файловой системы в остальных случаях. Сохранение недавних версий может помешать достичь этой цели. Очистите эти данные с помощью occ trashbin:cleanup --all-users, occ versions:cleanup alice и occ preview:cleanup. Учтите, что previews снова будут занимать место, когда пользователи открывают файлы.

Можно ли перенести каталог данных Nextcloud на другой диск?

Подключите новое расположение по тому же пути внутри контейнера, не изменяя путь, известный Nextcloud. Остановите контейнер и скопируйте старое содержимое на новый диск с сохранением владельца и прав доступа (cp -a или rsync -aAX). Затем измените путь тома или bind mount в compose-файле и снова запустите контейнер. Nextcloud по-прежнему будет видеть /data, поэтому изменять записи в базе данных не потребуется. Проверьте результат с помощью docker exec -it nextcloud occ config:system:get datadirectory и выполните одну тестовую загрузку.

Была ли эта статья полезной?