Настройка smb.conf: параметры секций, маски прав и типичные ошибки | AdminWiki

Настройка smb.conf: параметры секций, маски прав и типичные ошибки

11 ноября 2026 12 мин. чтения

Зачем разбираться в smb.conf, а не копировать конфиги наугад

smb.conf — единая точка, где сходятся три независимых слоя доступа: учётные записи Samba, права файловой системы Linux и параметры конкретной шары. Правка одной строки здесь меняет то, что увидит клиент Windows или macOS, поэтому копировать конфиг из чужой статьи без понимания секций рискованно.

Прямой ответ на главный вопрос: параметры шары не выдают прав, они разрешают или запрещают операцию поверх прав Linux. Строка read only = no не сделает каталог записываемым, если у пользователя нет прав на него в файловой системе. И наоборот: chmod 777 не откроет шару, если пользователя нет в valid users.

Дальше идём по порядку: секции [global] и шары, назначение path, browseable, read only и valid users, логика create mask и directory mask, типичные ошибки с диагностикой через smbclient и чек-лист перед перезапуском smbd. Все примеры можно воспроизвести на тестовом стенде через testparm и smbclient, не трогая прод.

Структура smb.conf: секция [global] и секции шар

Файл smb.conf состоит из секций в квадратных скобках. [global] задаёт параметры для всего сервера, любая другая секция описывает отдельную шару и называется так, как её увидят клиенты. Порядок секций на работу не влияет, на читаемость влияет сильно.

Минимальный скелет конфига:

[global]
workgroup = WORKGROUP
server string = fileserver
security = user
log file = /var/log/samba/log.%m
log level = 1

[backup]
path = /srv/samba/backup
browseable = no
read only = yes
valid users = @backup

Если разворачиваете сервер с нуля, пошаговая инструкция по настройке Samba SMB на Ubuntu и Debian закрывает установку пакетов, создание пользователей и базовую конфигурацию.

Что задавать в [global], а что в шаре

Правило простое: всё, что относится к серверу целиком, живёт в [global]. Всё, что относится к каталогу и правам на него, живёт в секции шары.

  • [global]: workgroup, server string, security, log file, log level, interfaces, bind interfaces only, unix charset, idmap config для доменных сценариев.
  • Шара: path, browseable, read only, writable, valid users, write list, read list, create mask, directory mask, force user, force group, guest ok.

Параметры из [global] наследуются шарой, пока в секции шары не задано своё значение. Отсюда типичная путаница: в [global] стоит read only = yes, в шаре read only = no, и администратор ищет причину записи, глядя не в тот блок. Дублирование параметра в шаре переопределяет глобальное значение молча, без предупреждений.

Проверка синтаксиса через testparm

testparm разбирает smb.conf, проверяет имена параметров и значения, предупреждает о неизвестных ключах и печатает итоговый конфиг с учётом наследования. Запускайте его до любого перезапуска smbd.

  • testparm -s печатает эффективную конфигурацию: видно, какие значения реально получила шара после наследования из [global].
  • testparm -v показывает все параметры, включая значения по умолчанию, которые вы не задавали.
  • testparm -d 2 добавляет отладочный вывод, если нужно понять, как Samba прочитала конкретную строку.

testparm проверяет синтаксис, но не гарантирует, что каталог из path существует и доступен нужному пользователю. Существование каталога и его права проверяйте отдельно: ls -ld /srv/samba/backup и stat -c '%U %G %a' /srv/samba/backup.

Параметры шары: path, browseable, read only, valid users

Четыре параметра закрывают большую часть практических задач шары: path указывает каталог, browseable отвечает за видимость в списке, read only задаёт режим записи, valid users ограничивает круг пользователей.

  • path — абсолютный путь к каталогу. Каталог должен существовать до запуска smbd: если его нет, шара не поднимется, а клиент получит ошибку подключения.
  • browseable — показывать ли имя шары в списке ресурсов. По умолчанию yes. Для служебных шар ставьте no: шара останется доступной по прямому пути //server/share, но не будет висеть в общем списке.
  • read only — режим по умолчанию yes, то есть новая шара открывается только на чтение, пока вы явно не разрешите запись.
  • valid users — список пользователей и групп через пробел или запятую, которым разрешён вход на шару.
  • guest ok (синоним public) — разрешает анонимный доступ. По умолчанию no, включать стоит осознанно: гость работает с файлами от имени пользователя nobody.

Пример секции для командной папки:

[projects]
path = /srv/samba/projects
browseable = yes
read only = no
valid users = @devs
create mask = 0660
directory mask = 0770
force group = devs

valid users и ограничение доступа

Синтаксис: valid users = user1, user2, @devs. Имена групп предваряются символом @, а разделителем имён служит запятая или пробел. Более экзотические префиксы для доменных групп и netgroup в проверенных источниках не подтверждены, поэтому полагаться на них без проверки в вашей версии Samba не стоит.

Пользователь должен существовать в базе Samba, а не только в /etc/passwd. Добавьте его через smbpasswd -a user (создаст запись и запросит пароль) или через pdbedit -a -u user; список известных учётных записей выводит pdbedit -L. Если пользователь есть в системе, но отсутствует в базе Samba, valid users его не пропустит.

Для тонких сценариев есть write list и read list. write list даёт перечисленным пользователям запись даже при read only = yes, read list делает шару доступной только для чтения для указанных имён, пока остальные пишут. Так настраивают папку общих материалов, где менять файлы должен только редактор.

read only, writable и browseable в связке

writable = yes и writeable = yes — синонимы read only = no. Типичные сочетания собраны в таблице.

Цельbrowseableread onlyКомментарий
Публичная шара только на чтениеyesyesЗапись блокируется на уровне Samba
Общая папка команды с записьюyesnoНужны valid users = @group и права ФС на каталог
Служебная шара бэкаповnonoДоступ по прямому //server/backup
Личный каталог одного инженераnoyesvalid users = конкретное имя

Начинайте с read only = yes и добавляйте запись только тем шарам, где она нужна. Такой порядок снижает риск, что из-за опечатки общий каталог станет записываемым для всей группы.

Маски прав: create mask и directory mask

create mask и directory mask задают максимальные права, которые Samba выставит новым файлам и каталогам, созданным через SMB. Маска работает как фильтр: снятые в ней биты не выставляются, добавить права маской нельзя.

  • Значения по умолчанию: create mask = 0744, directory mask = 0755. Файл, который клиент Windows создаёт с запросом 0666, получит 0644.
  • Для личных шар этого достаточно: владелец читает и пишет, группа и остальные только читают.
  • Для групповой работы ставьте create mask = 0660 и directory mask = 0770, добавьте force group = devs и setgid на каталоге (chmod g+s), чтобы вложенные каталоги оставались в нужной группе.

force create mode и force directory mode работают в обратную сторону: принудительно добавляют биты. Параметр force create mode = 0660 гарантирует, что файл будет доступен группе, даже если клиент запросил более строгие права.

Про inherit permissions = yes: распространено мнение, что этот параметр полностью отменяет действие create mask и directory mask для новых объектов, но в проверенной документации Samba подтверждения этому нет. Если вы рассчитываете на такую логику, проверьте фактическое поведение на тестовом каталоге, прежде чем полагаться на неё в проде.

Как маски взаимодействуют с правами файловой системы Linux

Права нового файла формируются цепочкой: клиент запрашивает набор бит, Samba применяет create mask, после чего побитово OR-ит результат с force create mode. Для каталога вычисленный UNIX-режим побитово AND-ится с directory mask, а затем побитово OR-ится с force directory mode. Значения force create mode и force directory mode по умолчанию равны 000, то есть дополнительных битов не добавляют.

Участие umask процесса smbd в этой цепочке в проверенной документации Samba прямо не описано. Практический вывод: не полагайтесь на то, что umask «докрутит» права предсказуемым образом, и проверяйте итог на реальном файле.

Владелец файла определяется пользователем, от имени которого smbd выполнил операцию: это либо аутентифицированный пользователь Samba, либо force user. Права каталога о будущем владельце ничего не говорят, они лишь ограничивают, кто может создавать в нём записи.

Разбор конфликта: каталог /srv/samba/common принадлежит root:root с правами 0755, в шаре задан force user = nobody. Файл создастся с владельцем nobody, но группа root записи в каталоге не имеет, и коллеги получат отказ при попытке изменить файл. Лечится сменой владельца каталога (chown nobody:devs) и прав (chmod 2775) либо корректным force group.

Проверка: ls -l показывает владельца и биты, stat -c '%A %U %G %n' путь даёт компактный вывод, getfacl путь показывает ACL, если они используются. Сравнивайте фактические права с тем, что обещает маска, а не с тем, что вы задумали.

force user и force group: когда нужны и чем опасны

force user заставляет smbd выполнять все файловые операции на шаре от имени указанного пользователя, независимо от того, кто подключился. Это решает проблему, когда файлы создаются с разными владельцами и ломают бэкап, но расширяет права: любой, кого пропустил valid users, работает с правами этого пользователя.

force user = root открывает путь к повышению привилегий через симлинки и записи в чужие каталоги. Заведите отдельного пользователя без shell (например, samba-share) и выдайте ему права только на нужный каталог.

force group задаёт группу для создаваемых файлов и часто заменяет возню с масками: force group = devs вместе с directory mask = 0770 даёт предсказуемый результат для команды. force user и force group комбинируются, но итог проверяйте на тестовом файле, а не на проде.

Типичные ошибки в smb.conf и как их ловить

Большинство инцидентов с Samba сводится к пяти ошибкам. Все они ловятся до перезапуска, если знать, куда смотреть.

  • Неверный workgroup. Клиенты не видят сервер в сетевом окружении, хотя smbd работает. Значение workgroup в [global] должно совпадать с рабочей группой клиентов; в домене вместо workgroup настраивают security = ads и realm.
  • Забытый force user. Файлы создаются с неожиданным владельцем, и следующий пользователь не может их изменить. Проверяйте ls -l на свежем файле и наличие force user или force group в секции шары.
  • Конфликт прав: маска разрешает группе запись, а каталог принадлежит другому владельцу и закрыт правами 0755. Лечится chown и chmod на каталоге, правка create mask тут не помогает.
  • Отсутствующий или недоступный path. Каталога нет, он на несмонтированном разделе или закрыт для пользователя Samba. Смотрите journalctl -u smbd и файл из log file.
  • Переопределение параметров. Значение из [global] перекрыто секцией шары, и вы правите не тот блок. testparm -s показывает эффективную конфигурацию и снимает вопрос.

Отдельно проверьте valid users: пользователь может существовать в Linux, но отсутствовать в базе Samba. pdbedit -L выводит тех, кого Samba действительно знает.

Диагностика по логам и smbclient

Логи задаются в [global]: log file = /var/log/samba/log.%m создаёт отдельный файл на каждого клиента, log level = 1 пишет только ошибки. Для разбора поднимите уровень до 3, воспроизведите проблему и верните обратно: log level = 10 на боевом сервере быстро съедает диск.

Воспроизведение через smbclient занимает минуту:

smbclient //localhost/projects -U user
ls
mkdir testdir
put /etc/hostname test.txt

Ошибка NT_STATUS_ACCESS_DENIED на mkdir означает, что запись закрыта либо режимом read only, либо правами файловой системы. NT_STATUS_LOGON_FAILURE указывает на пароль или отсутствие учётной записи в базе Samba. NT_STATUS_BAD_NETWORK_NAME говорит о несуществующей шаре или неверном path.

Для контроля активных подключений используйте smbstatus: smbstatus -b покажет сессии, smbstatus -s перечислит шары, smbstatus -L выведет заблокированные файлы. Перед перезапуском smbd smbstatus подскажет, кто именно потеряет сессию.

Чек-лист проверки smb.conf перед перезапуском smbd

Прогоняйте чек-лист целиком, даже если правили одну строку.

  1. testparm отработал без ошибок и предупреждений о неизвестных параметрах.
  2. testparm -s показывает ожидаемые значения с учётом наследования из [global].
  3. Каждый каталог из path существует: ls -ld по всем путям.
  4. Пользователь, от имени которого работает шара (свой или force user), имеет доступ к каталогу: sudo -u USER test -r /path и sudo -u USER test -w /path.
  5. Все имена в valid users есть в базе Samba: pdbedit -L.
  6. Маски согласованы с правами каталога: create mask не обещает больше, чем даёт файловая система.
  7. force user и force group заданы осознанно, без root.
  8. workgroup совпадает с клиентской средой, а для домена настроены security = ads и realm.
  9. Проверка через smbclient прошла до перезапуска, минимум на локальном хосте.

Готовый пример файлового сервера с разграничением прав разобран в руководстве по настройке NFS и SMB на минимальном файловом сервере Linux.

Безопасный перезапуск smbd и проверка результата

Перезапуск обрывает активные сессии: открытые файлы у клиентов закроются, несохранённые данные могут потеряться. Предупредите пользователей и выберите окно с минимальной нагрузкой.

sudo systemctl restart smbd
sudo systemctl status smbd --no-pager
sudo journalctl -u smbd -n 50 --no-pager

Имена служб зависят от дистрибутива. В RHEL 8 и CentOS 8 службы называются smb и nmb: их включают и запускают командой sudo systemctl enable --now {smb,nmb}, а после правки конфига перезапускают через sudo systemctl restart {smb,nmb}. Для Debian и Ubuntu в проверенных источниках подтверждения имён smbd и nmbd нет, поэтому сверьтесь с systemctl list-unit-files на своём хосте, прежде чем копировать команду.

nmbd отвечает за NetBIOS-имена и обнаружение сервера в сетевом окружении: если после правки [global] сервер пропал из списка, перезапустите и его.

Проверка результата: smbclient -L localhost -U user покажет список шар, затем подключитесь к нужной, создайте файл и проверьте владельца и биты через ls -l. Если они не совпали с ожиданием, возвращайтесь к разделу про маски: правьте create mask, force group или права каталога.

Откат держите под рукой: cp /etc/samba/smb.conf /etc/samba/smb.conf.bak перед правкой и конфиг в git. Возврат к рабочему состоянию тогда занимает одну команду и один перезапуск.

Итог: как применять конфиг осознанно

Порядок работы с smb.conf: определите задачу шары, задайте path и valid users, выберите режим записи, затем согласуйте create mask, directory mask и права каталога в Linux. Меняйте по одному параметру, после каждого шага запускайте testparm и проверяйте доступ через smbclient.

Держите конфиг в системе контроля версий и пишите в коммите, зачем изменён параметр. Через полгода read only = no без объяснения превращается в загадку для всей команды, а история правок отвечает на вопрос за секунды.

Если сервер работает в смешанной среде и вы сомневаетесь в выборе протокола, начните со сравнения SMB, NFS, AFP и WebDAV: там есть критерии по аутентификации, блокировкам файлов и пропускной способности.

Профилактика инцидентов выглядит скучно: testparm до перезапуска, smbclient до жалоб пользователей, бэкап конфига до правки. Зато шара открывается с первого раза и с теми правами, которые вы задумали.

Источники

Поделиться: