Зачем разбираться в 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. Типичные сочетания собраны в таблице.
| Цель | browseable | read only | Комментарий |
|---|---|---|---|
| Публичная шара только на чтение | yes | yes | Запись блокируется на уровне Samba |
| Общая папка команды с записью | yes | no | Нужны valid users = @group и права ФС на каталог |
| Служебная шара бэкапов | no | no | Доступ по прямому //server/backup |
| Личный каталог одного инженера | no | yes | valid 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
Прогоняйте чек-лист целиком, даже если правили одну строку.
- testparm отработал без ошибок и предупреждений о неизвестных параметрах.
- testparm -s показывает ожидаемые значения с учётом наследования из [global].
- Каждый каталог из path существует: ls -ld по всем путям.
- Пользователь, от имени которого работает шара (свой или force user), имеет доступ к каталогу: sudo -u USER test -r /path и sudo -u USER test -w /path.
- Все имена в valid users есть в базе Samba: pdbedit -L.
- Маски согласованы с правами каталога: create mask не обещает больше, чем даёт файловая система.
- force user и force group заданы осознанно, без root.
- workgroup совпадает с клиентской средой, а для домена настроены security = ads и realm.
- Проверка через 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 до жалоб пользователей, бэкап конфига до правки. Зато шара открывается с первого раза и с теми правами, которые вы задумали.
Источники
- smb.conf(5) — Debian Manpages — значения по умолчанию create mask, directory mask, force create mode и force directory mode, логика AND с маской и OR с force-режимом.
- smb.conf — официальная документация Samba — справочник по параметрам smb.conf.
- Настройка ресурсов Samba — Astra Linux Wiki — синтаксис valid users с префиксом @ для групп и разделителями.
- Install Samba on RHEL 8 — LinuxConfig — имена служб smb и nmb и команды systemctl для RHEL 8 / CentOS 8.