Подключаем сетевую SMB-шару к Nextcloud 35.0.3, установленному из snap-пакета на Ubuntu 24.04 LTS. Разберём весь путь: от монтирования CIFS до зелёной галочки в админке — и три ложных следа, на которых мы потеряли больше всего времени.
Решение имеет смысл, когда Nextcloud развёрнут именно снапом (а значит, живёт в AppArmor-песочнице со своим mount namespace), шара лежит на Windows/DFS-сервере, и переименовать каталоги на стороне сервера нельзя — например, это рабочая структура файлового архива, за которую отвечает другой отдел. У нас таким архивом оказались аудиторские документы, и весь путь до них был по-русски, с пробелами и скобками.
Сразу скажем главное: кириллица в пути шары оказалась ни при чём. Но чтобы это понять, пришлось разобраться, как snap изолирует процессы — и почему привычные тесты из консоли врут.
Исходная схема
| Параметр | Значение |
|---|---|
| Хост | Ubuntu 24.04 LTS, Nextcloud 35.0.3 из snap (strict confinement) |
| SMB-сервер | 192.168.x.x, DFS, шара вида //192.168.x.x/dfs/Совместная работа/…/аудит 2026 ( за 2025г.) |
| Протокол | SMB 3.0, аутентификация по учётной записи домена |
| Тип внешнего хранилища | «Локальное (серверное хранилище)» — снап не содержит smbclient, поэтому тип SMB напрямую недоступен |
| Точка монтирования | /media/nextcloud/audit2026 (почему не /mnt — ниже) |
Подготовка: учётные данные и монтирование
Пароль в командной строке и в fstab не светим — выносим в отдельный файл с правами 600:
sudo install -m 600 /dev/null /etc/samba/credentials/nextcloud-smb
sudo tee /etc/samba/credentials/nextcloud-smb <<'EOF'
username=smb-user
password=********
domain=EXAMPLE
EOF
Монтируем шару. Опции uid=0,gid=0 здесь ключевые — к ним мы ещё вернёмся, потому что именно на владельце каталога всё и застопорилось:
sudo mkdir -p /media/nextcloud/audit2026
sudo mount -t cifs '//192.168.x.x/dfs/Совместная работа/…/аудит 2026 ( за 2025г.)' \
/media/nextcloud/audit2026 \
-o credentials=/etc/samba/credentials/nextcloud-smb,uid=0,gid=0,iocharset=utf8,vers=3.0,file_mode=0770,dir_mode=0770,nofail,_netdev,nodfs
Постоянная запись в /etc/fstab:
//192.168.x.x/dfs/Совместная\040работа/…/аудит\0402026\040(\040за\0402025г.) /media/nextcloud/audit2026 cifs credentials=/etc/samba/credentials/nextcloud-smb,uid=0,gid=0,iocharset=utf8,vers=3.0,file_mode=0770,dir_mode=0770,nofail,_netdev,nodfs,x-gvfs-hide 0 0
Важно. В
/etc/fstabпробелы в пути шары экранируются только как\040— иначе строка развалится на поля. Кириллицу и скобки экранировать не нужно, но файл должен быть в UTF-8. После правки fstab выполнитеsudo systemctl daemon-reload, иначе systemd продолжит использовать старую версию.
Почему точка монтирования — /media, а не /mnt
У snap-пакета нет доступа к файловой системе «как у обычной программы». Доступ к внешним каталогам даёт интерфейс removable-media:
sudo snap connect nextcloud:removable-media
snap connections nextcloud # убеждаемся, что интерфейс подключён
Интерфейс разрешает только /media/** и /run/media/**. Каталог /mnt в его область не входит, и монтирования, сделанные под /mnt, не пропагируются в mount namespace снапа. Наша первая попытка была именно с /mnt/nextcloud/audit2026: files_external:verify честно отвечал status: ok, а скан возвращал ноль файлов без единой ошибки — внутри песочницы по этому пути просто лежал пустой каталог с хостовой ФС.
Важно. Проверка вида
sudo -u www-data ls /media/nextcloud/audit2026— ложный ориентир. Она выполняется вне AppArmor-профиля снапа и ничего не говорит о том, что увидит сам Nextcloud. Правильный тест — только изнутри песочницы (ниже).
Грабли, на которых мы потеряли время
Ложный след №1: кириллица
Изначальная гипотеза была красивой: «snap не переваривает русские имена». На деле AppArmor оперирует путём точки монтирования на клиенте — а она у нас чистый ASCII. Имена файлов внутри шары — содержимое каталога, а не путь, и на медиацию доступа не влияют. На сервере в итоге не переименовали вообще ничего.
Ложный след №2: «verify ok — значит, всё доступно»
files_external:verify делает поверхностную проверку существования пути и не доказывает, что ограниченный PHP-процесс способен перечислить содержимое каталога. Зелёный статус при пустом скане — нормальная для этой ситуации картина.
Настоящая причина: у root в песочнице отобраны capabilities
Когда мы наконец заглянули внутрь песочницы (правильное имя приложения — nextcloud.php-fpm, приложения «php» в снапе нет):
sudo snap run --shell nextcloud.php-fpm
ls -la /media/nextcloud/audit2026
# ls: cannot open directory '/media/nextcloud/audit2026': Permission denied
При этом в journalctl -k -g DENIED не было ни одной записи про запрет open на этот путь — то есть путь AppArmor разрешал. Зато там были записи вида:
apparmor="DENIED" operation="capable" profile="snap.nextcloud.php-fpm" capability=1 # CAP_DAC_OVERRIDE
apparmor="DENIED" operation="capable" profile="snap.nextcloud.php-fpm" capability=2 # CAP_DAC_READ_SEARCH
Расшифровка: процессы снапа работают под uid 0, но профиль отбирает у root возможность игнорировать Unix-права. А каталог был смонтирован с uid=www-data,dir_mode=0770 — для root без CAP_DAC_OVERRIDE это «чужой каталог с нулём прав для остальных», законный EACCES по обычным правам. Снаружи песочницы тот же root имеет capability, поэтому все внешние тесты проходили. Лечение — uid=0,gid=0 в опциях монтирования: это лишь локальное представление владельца, на сервер и аутентификацию не влияет.
Финальный штрих: галочка в админке
Даже после того как песочница начала видеть файлы, скан упорно возвращал 0/0: хранилище ещё указывало на старый путь /mnt/… и висело в статусе «не проверено». После смены пути зашли в веб-интерфейс под администратором (Настройки → Внешние хранилища) и поставили галочку напротив подключения — статус стал зелёным, и файлы подхватились. Путь в конфиге при необходимости правится и из консоли:
sudo nextcloud.occ files_external:config 3 datadir /media/nextcloud/audit2026
sudo nextcloud.occ files_external:scan 3 --path "/"
Сводная таблица грабель
| Что случается | Почему | Что делать |
|---|---|---|
verify ok, но скан 0/0 без ошибок | Монтирование в /mnt не попадает в mount namespace снапа — внутри пустой каталог | Монтировать под /media, подключить removable-media |
sudo -u www-data ls показывает файлы, Nextcloud — нет | Тест идёт вне AppArmor-профиля | Проверять изнутри: sudo snap run --shell nextcloud.php-fpm |
snap run --shell nextcloud.php → cannot find app | Приложения «php» в снапе нет | Использовать nextcloud.php-fpm |
Permission denied под root в песочнице при правах 0770 www-data | Профиль отбирает у root CAP_DAC_OVERRIDE/CAP_DAC_READ_SEARCH | uid=0,gid=0 в опциях CIFS-монтирования |
| После исправления монтирования скан всё равно 0/0 | Хранилище указывает на старый путь и/или не подтверждено | Сменить datadir, поставить галочку в админке, повторить скан |
Полезная диагностика на все случаи:
# шелл с AppArmor-профилем снапа
sudo snap run --shell nextcloud.php-fpm
ls -la /media/nextcloud/audit2026
exit
# AppArmor-отказы (отсутствие записей про open на ваш путь — тоже информация!)
sudo journalctl -k -g DENIED --since "15 min ago"
# статус хранилищ и их конфигурация
sudo nextcloud.occ files_external:list
sudo nextcloud.occ files_external:verify 3
Итог
Простым оказалось всё, что касалось самого SMB: аутентификация, версия протокола, кириллица — проблем не создали вообще. Рабочей систему делают три вещи: точка монтирования строго под /media (область действия интерфейса removable-media), uid=0,gid=0 в опциях монтирования (root в песочнице лишён CAP_DAC_OVERRIDE) и подтверждение хранилища галочкой в админке после смены пути. У нас по этой схеме к Nextcloud подключён архив аудиторских документов: файлы продолжают жить на файловом сервере, а сотрудники получают к ним доступ через веб-интерфейс и клиентов Nextcloud, с общими правами и логированием.