Инженер — это не профессия, а состояние души

Подключаем сетевую 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_SEARCHuid=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, с общими правами и логированием.

Источники

← Все статьи раздела «Сетевое администрирование»