Что мы настраиваем и кому подойдёт это руководство
Рабочая общая папка на Samba в Linux поднимается за шесть шагов: установка пакетов, правка /etc/samba/smb.conf, создание каталога и пользователя Samba, проверка синтаксиса через testparm, запуск smbd и nmbd с автозагрузкой, тест с клиента через smbclient -L. Ниже — минимум для файлового сервера в локальной сети: одна шара, доступ по логину и паролю, протоколы SMB2/SMB3.
Разница между дистрибутивами упирается в три вещи: менеджер пакетов (apt или dnf), инструмент фаервола (ufw или firewalld) и SELinux, который в RHEL-семействе включён по умолчанию. Путь к конфигу совпадает: /etc/samba/smb.conf. Поэтому сам файл переносится между системами почти без правок, а ломается настройка чаще всего на правах и фильтрах пакетов, а не на параметрах Samba.
За рамками материала остаются контроллер домена Active Directory, печать через CUPS, кластеризация CTDB и тонкая настройка производительности. Если нужна интеграция с AD и SMB signing, смотрите разбор настройки SMB на Astra Linux: там разобраны домен и подписывание протокола.
Какие дистрибутивы и версии Samba 4.x покрывает гайд
Инструкция рассчитана на Debian 12 и 13, Ubuntu 22.04 и 24.04, RHEL 9 и 10, AlmaLinux 9, Rocky Linux 9. Везде используется ветка Samba 4.x и протоколы SMB2/SMB3, SMB1 не включаем. Первое, что сверяйте перед копированием чужого конфига, — путь к smb.conf, имена служб и наличие мандатного контроля доступа.
| Параметр | Debian / Ubuntu | RHEL / AlmaLinux / Rocky |
|---|---|---|
| Менеджер пакетов | apt | dnf |
| Пакеты | samba, smbclient | samba, samba-client |
| Путь к конфигу | /etc/samba/smb.conf | /etc/samba/smb.conf |
| Службы | smbd, nmbd | smbd, nmbd |
| Фаервол | ufw | firewalld |
| Мандатный контроль | AppArmor | SELinux |
| Логи | /var/log/samba/ | /var/log/samba/ |
В контейнерных образах и в сборках под AD DC путь к smb.conf может отличаться от штатного. Не полагайтесь на память: где лежит файл, покажет systemctl cat smbd, а какие юниты вообще есть — systemctl list-unit-files | grep -i smb.
Что понадобится перед началом
- Доступ с sudo или root на сервере и консоль на клиенте для теста.
- Имя хоста (hostname) и имя рабочей группы, обычно WORKGROUP.
- Имя шары и путь к каталогу на диске, например /srv/share.
- Список пользователей, которым нужен доступ, и имя группы для них.
- Доступ к настройкам фаервола: ufw на Debian/Ubuntu, firewalld на RHEL-семействе.
- Бэкап текущего /etc/samba/smb.conf, если Samba уже стоит.
Почему так: Samba работает поверх прав Linux. Параметры valid users и create mask фильтруют запросы по SMB, но не отменяют chmod и chown на каталоге. Пользователь Samba — отдельная запись в базе passdb, привязанная к системному пользователю по имени, а не второй системный аккаунт. Если слой прав выставлен неверно, конфиг с идеальным синтаксисом всё равно даст отказ в доступе.
Установка Samba в Debian/Ubuntu и RHEL-семействе
Пакеты различаются названиями: в Debian/Ubuntu сервер и клиент лежат в samba и smbclient, в RHEL-семействе — в samba и samba-client. В обоих случаях после установки появляется /etc/samba/smb.conf, а клиентская утилита smbclient в поставку серверного пакета не входит.
Установка в Debian и Ubuntu
sudo apt update
sudo apt install -y samba smbclient
smbd --version
systemctl status smbd --no-pager
Установщик Debian и Ubuntu обычно сразу запускает smbd и nmbd, поэтому статус active (running) сразу после установки — норма, а не признак того, что вы что-то сломали. Проверка smbd --version нужна, чтобы зафиксировать ветку Samba 4.x до правки конфига. В Debian 12 пакет samba имеет версию 4.17.12+dfsg-0+deb12u4, то есть ветку 4.17 (Debian 12: пакет samba 4.17.12); для Ubuntu 24.04 и RHEL 9 точную минорную версию сверяйте по выводу smbd --version и пакетному репозиторию дистрибутива, а не по памяти: набор доступных параметров у разных минорных версий отличается.
Установка в RHEL, AlmaLinux и Rocky Linux
sudo dnf install -y samba samba-client
smbd --version
systemctl status smbd --no-pager
getenforce
На RHEL-семействе службу smb включают и запускают вручную: sudo systemctl enable --now smb (Red Hat Enterprise Linux 9: настройка сетевых файловых служб). Автозагрузка не подразумевается сама собой, её нужно включить явно. Кроме того, SELinux в режиме Enforcing блокирует доступ к каталогу, который не помечен типом samba_share_t. Проверьте getenforce до первой попытки подключения: ответ Enforcing означает, что контекст каталога придётся настраивать отдельным шагом. Репозитории дистрибутивов держат разные минорные версии Samba 4.x, поэтому вывод smbd --version стоит внести в runbook или в заявку на изменение: после обновления пакетов часть параметров может вести себя иначе.
Разбираем структуру smb.conf: что менять и где
Файл состоит из секций в квадратных скобках. [global] задаёт параметры сервера целиком, остальные секции описывают шары и принтеры. Правило одно: сначала cp -a /etc/samba/smb.conf /etc/samba/smb.conf.bak.$(date +%F), потом правка, потом testparm. Штатный конфиг на 300 строк в основном состоит из комментариев, вычищать их не обязательно, но чужие конфиги целиком копировать не стоит: лишние параметры из старых гайдов либо игнорируются, либо ослабляют защиту.
| Параметр | Секция | Что делает | Чем грозит отсутствие или неверное значение |
|---|---|---|---|
| workgroup | global | Имя рабочей группы для NetBIOS-браузинга | Windows-клиенты из другой группы не увидят сервер в сетевом окружении |
| security | global | Режим аутентификации, user по умолчанию | При ads или domain без настроенного домена аутентификация не пройдёт |
| server string | global | Описание сервера в выводе smbclient -L | Косметика, но без него в списке сложно отличить хосты |
| path | шара | Каталог на диске | Без него секция шары не создаётся |
| browseable | шара | Показывать шару в списке ресурсов | При no шара работает, но не видна в smbclient -L и в проводнике |
| read only | шара | Запрет записи | По умолчанию yes: пользователи подключатся, но писать не смогут |
| valid users | шара | Список допущенных пользователей и групп | Без него доступ получают все успешно аутентифицированные |
| create mask | шара | Права новых файлов | Файлы создаются по umask, групповая работа ломается |
| directory mask | шара | Права новых каталогов | Подкаталоги теряют группу и бит setgid |
| force group | шара | Назначает группу новым файлам | Файлы достаются группе пользователя, коллеги не получают доступ |
Секция [global]: минимум для рабочего сервера
[global]
workgroup = WORKGROUP
server string = File server %v
security = user
map to guest = never
server min protocol = SMB2
server max protocol = SMB3
log file = /var/log/samba/log.%m
max log size = 1000
security = user означает аутентификацию по локальной базе Samba, этого достаточно для файлового сервера в рабочей группе. map to guest = never закрывает маппинг неудачных логинов в гостя: при неверном пароле клиент получит отказ, а не анонимный доступ. Это значение и так действует по умолчанию (Альт: Samba в режиме файлового сервера), но лучше прописать его явно, чтобы конфиг читался однозначно. Параметр server min protocol = SMB2 отсекает SMB1 на уровне сервера, поэтому старый клиент не подключится даже при большом желании. Логи с разбивкой по машинам (%m) нужны, чтобы разбирать жалобы конкретного клиента, а не искать иголку в общем файле.
Секция общей папки: параметры и права
[share]
comment = Common share
path = /srv/share
browseable = yes
read only = no
valid users = @smbusers
create mask = 0660
directory mask = 2770
force group = smbusers
Связка прав работает так: каталог должен быть доступен пользователю Linux по chmod и chown, Samba транслирует запросы SMB в файловые операции от имени этого пользователя. directory mask = 2770 ставит бит setgid, и новые подкаталоги наследуют группу smbusers, а не основную группу создателя. force group = smbusers делает то же для файлов. Без этих двух параметров группа быстро превращается в лотерею: у одного файла владелец alice и группа alice, у другого alice и smbusers.
Создаём общую папку: пошаговый пример
Порядок действий: группа, системный пользователь, каталог с правами, пароль Samba, секция в конфиге. Каждый шаг проверяем командой, чтобы не искать причину отказа на финальном подключении.
Пользователь Samba и права на каталог
sudo groupadd smbusers
sudo useradd -M -s /usr/sbin/nologin alice
sudo usermod -aG smbusers alice
sudo mkdir -p /srv/share
sudo chown root:smbusers /srv/share
sudo chmod 2770 /srv/share
sudo smbpasswd -a alice
sudo pdbedit -L
Пользователь Samba — запись в отдельной базе (по умолчанию passdb.tdb), привязанная к системному пользователю по имени. Системный пароль и пароль SMB независимы: smbpasswd -a alice задаёт второй и не меняет первый. Если системного пользователя с таким именем нет, smbpasswd -a вернёт ошибку добавления записи, поэтому useradd выполняется до него. Проверка pdbedit -L показывает список учётных записей Samba: если alice там нет, дальше идти бессмысленно.
На RHEL-семействе добавьте контекст SELinux:
sudo semanage fcontext -a -t samba_share_t "/srv/share(/.*)?"
sudo restorecon -Rv /srv/share
ls -Zd /srv/share
Быстрый chcon -t samba_share_t -R /srv/share работает до ближайшего restorecon, а правило через semanage переживает переразметку. Без метки samba_share_t при Enforcing возможен отказ «Permission denied» даже при открытых правах на файлы (пример настройки RHEL 9 с SELinux и Samba). Отдельно проверьте булевы значения: getsebool -a | grep samba покажет, включён ли samba_export_all_rw. Для одной шары в /srv он не нужен, хватает типа samba_share_t.
Готовый минимальный конфиг шары
Полный пример для /etc/samba/smb.conf: секция [global] из предыдущего раздела плюс [share]. Менять нужно три вещи: path, имя секции и valid users. Остальное — рабочий минимум, который не конфликтует со значениями по умолчанию.
[global]
workgroup = WORKGROUP
server string = File server %v
security = user
map to guest = never
server min protocol = SMB2
server max protocol = SMB3
[share]
comment = Common share
path = /srv/share
browseable = yes
read only = no
valid users = @smbusers
create mask = 0660
directory mask = 2770
force group = smbusers
Перед сохранением сделайте бэкап: sudo cp -a /etc/samba/smb.conf /etc/samba/smb.conf.bak.$(date +%F). Если Samba уже работает с другим набором шар, добавляйте новую секцию в конец файла, не переписывайте существующие. Расширенные сценарии с разграничением прав по группам и интеграцией с Windows 10/11 разобраны в материале про полную конфигурацию smb.conf на Ubuntu и Debian.
Проверка конфига и запуск smbd/nmbd с автозагрузкой
Порядок такой: testparm, затем start, затем enable. Можно и наоборот, но тогда синтаксическую ошибку вы поймаете уже после перезапуска службы, когда шара отвалится у пользователей.
testparm: что проверяем и как читать вывод
sudo testparm
sudo testparm -s
sudo testparm -v
Утилита проверяет синтаксис, при успехе печатает Loaded services file OK и выводит эффективный конфиг после подстановки значений по умолчанию. Ключ -s убирает приглашение и печатает только результат, -v показывает все параметры с умолчаниями. Ищите в выводе свою секцию [share] и параметры, которых вы не задавали: так всплывают унаследованные значения, например read only = Yes, из-за которого запись не работает при формально верном конфиге. Предупреждение о том, что секция не printable, безобидно. Права на файловой системе и сетевой доступ testparm не проверяет, это отдельные шаги.
Автозагрузка smbd и nmbd
sudo systemctl enable --now smbd nmbd
systemctl is-enabled smbd nmbd
systemctl status smbd --no-pager
enable --now включает автозагрузку и сразу запускает службу, это заменяет пару enable + start. nmbd отвечает за NetBIOS-имена и просмотр сети; там, где клиенты ходят по DNS-имени или IP и работают через SMB2/SMB3, без него шара доступна, но старые Windows-клиенты не увидят сервер в списке сети. Если systemctl ругается на отсутствующий юнит, проверьте имена: systemctl list-unit-files | grep -i smb. В минимальных сборках и контейнерах nmbd может отсутствовать, тогда ограничьтесь smbd.
Тестируем доступ с клиента: smbclient -L и подключение
Тест с клиента отвечает на главный вопрос: сервер отдаёт шары и пускает по паролю. Проверяйте с другой машины, а не с самого сервера, иначе фаервол и сетевые фильтры останутся вне подозрений.
smbclient -L: проверка списка шар
smbclient -L //192.0.2.10 -U alice -m SMB3
smbclient -L //srv-file -U alice
В выводе ищите строку Sharename со своей шарой и служебный ресурс IPC$. Пароль запросят интерактивно; вариант -U alice%password удобен для скриптов, но оставляет пароль в истории shell и в списке процессов. Если шары в списке нет, проверьте browseable, статус smbd и фаервол: при browseable = no ресурс работает, но в списке не отображается. smbclient -L — самый быстрый способ проверки после настройки, графический клиент для него не нужен.
Подключение к шаре и типичные ошибки
smbclient //192.0.2.10/share -U alice
ls
put test.txt
get test.txt
exit
Расшифровка частых кодов: NT_STATUS_LOGON_FAILURE означает неверный пароль или имя пользователя; NT_STATUS_ACCESS_DENIED указывает на права каталога, valid users или SELinux; NT_STATUS_BAD_NETWORK_NAME — на опечатку в имени шары или неверный path; таймаут и NT_STATUS_CONNECTION_REFUSED говорят о фаерволе или о том, что smbd не слушает порт.
Порядок диагностики:
systemctl status smbd nmbd --no-pager
sudo smbstatus
ss -tlnp | grep -E '139|445'
sudo ufw status (Debian/Ubuntu) или sudo firewall-cmd --list-services (RHEL)
ls -ld /srv/share
getenforce и ls -Zd /srv/share (RHEL)
smbstatus показывает активные подключения, пользователя и версию протокола: если клиент пришёл по SMB3, в выводе это видно. Порты открывайте узко: sudo ufw allow 445/tcp на Debian/Ubuntu, sudo firewall-cmd --permanent --add-port=445/tcp и sudo firewall-cmd --reload на RHEL. Samba использует порты 137,138/udp и 139,445/tcp, а порт 445/tcp обслуживает протокол SMB (ArchWiki: Samba). Порт 139/tcp относится к NetBIOS over TCP/IP и нужен в основном для старых сценариев и браузинга; если nmbd не используется, обычно достаточно 445/tcp. Предопределённая служба samba в firewalld открывает набор портов Samba сразу, это оправдано, когда нужен nmbd и браузинг сети. Подробный разбор фаервола и тюнинга есть в руководстве по файловому серверу на Ubuntu Server и Debian с UFW.
guest ok = yes и client min protocol = NT1 не используйте как способ «заставить работать». Первый разрешает анонимный (гостевой) доступ к файловому хранилищу без аутентификации (FirstVDS: установка и настройка Samba на Ubuntu), второй включает SMB1. Ошибка почти всегда сидит в правах, SELinux или фаерволе, а не в конфиге Samba.
Совместимость версий и различия дистрибутивов: чтобы конфиг не сломал прод
Samba 4.x и протоколы SMB2/SMB3
Ветка Samba 4.x по умолчанию работает по SMB2 и SMB3. В Samba 4.11 значения по умолчанию параметров client min protocol и server min protocol были изменены на SMB2_02, а в release notes 4.11.0 есть раздел «SMB1 is disabled by default» (Samba 4.11.0 — Release Notes). Поэтому в актуальных версиях отдельно понижать server min protocol не требуется, а включать NT1 имеет смысл только для старого периферийного устройства вроде сетевого МФУ или древнего NAS, и лучше в отдельном сегменте сети. Параметры из гайдов прошлого десятилетия (lanman auth, ntlm auth = yes, понижение client max protocol) в современных версиях либо игнорируются, либо ослабляют защиту. Что реально применилось, показывает testparm -v.
Если сомневаетесь в выборе протокола для смешанной среды с Windows, Linux и macOS, критерии собраны в сравнении SMB, NFS, AFP и WebDAV.
Таблица различий Debian/Ubuntu и RHEL-семейства
| Что сверять | Debian / Ubuntu | RHEL / AlmaLinux / Rocky |
|---|---|---|
| Установка | apt install samba smbclient | dnf install samba samba-client |
| Конфиг | /etc/samba/smb.conf | /etc/samba/smb.conf |
| Службы | smbd, nmbd | smbd, nmbd |
| Автозагрузка | systemctl enable --now smbd nmbd | systemctl enable --now smb (и nmb при необходимости) |
| Фаервол | ufw allow 445/tcp | firewall-cmd --add-service=samba |
| Мандатный контроль | AppArmor, профиль smbd | SELinux, тип samba_share_t |
| Ветка Samba 4.x | Debian 12: 4.17.12; остальное сверяйте через smbd --version | минорную версию сверяйте через smbd --version |
| Проверка версии | smbd --version | smbd --version |
Конфиг переносится между дистрибутивами, потому что путь к файлу совпадает. Сверять нужно ветку Samba через smbd --version и слой мандатного контроля: конфиг, который годами работал на Ubuntu, на RHEL упрётся в SELinux. Второй частый сюрприз — разница в минорных версиях: параметр, добавленный в более новой ветке, на старой будет молча проигнорирован, и testparm об этом предупредит строкой об неизвестном параметре.
Безопасность и типичные ошибки базовой настройки
- Гостевой доступ. guest ok = yes разрешает анонимный доступ без аутентификации, а map to guest = bad user перенаправляет подключения с недействительной учётной записью на гостя (обычно nobody). Держите map to guest = never и ограничивайте доступ через valid users.
- SMB1 и ntlm auth = yes. Устаревшие протоколы нужны единицам устройств, а риск создают для всех. Оставьте server min protocol = SMB2.
- chmod 777 на каталог. Права записи получают все локальные пользователи, включая сервисные. Рабочий вариант: владелец root, группа smbusers, режим 2770.
- SMB наружу. Порт 445/tcp не должен смотреть в интернет: только локальная сеть или VPN. Сканирование SMB в интернете находят быстро.
- Правка без бэкапа и без testparm. Одна опечатка в имени параметра не мешает службе запуститься, но меняет поведение шары. Бэкап с датой решает откат за секунды.
- Забытый SELinux. На RHEL-семействе верный smb.conf и верные права не спасут, если у каталога нет типа samba_share_t.
- Пароль в командной строке. Ключ -U alice%password виден в ps и остаётся в history. Используйте файл учётных данных с ключом -A и правами 600.
Базовая настройка из этой статьи рассчитана на доверенную локальную сеть. Для инфраструктуры с доступом извне добавьте VPN, шифрование SMB3 и централизованную аутентификацию, прежде чем открывать шару десяткам пользователей.
Чек-лист проверки после настройки
- Бэкап /etc/samba/smb.conf с датой сделан до правки.
- testparm отрабатывает без ошибок и в выводе видна секция вашей шары с нужными параметрами.
- smbd и nmbd запущены: systemctl is-active smbd nmbd возвращает active.
- Автозагрузка включена: systemctl is-enabled smbd nmbd возвращает enabled.
- smbclient -L //host -U user показывает шару и IPC$.
- smbclient //host/share -U user пускает внутрь, команды put и get не дают ошибок.
- smbstatus показывает подключение с ожидаемой версией протокола (SMB3).
- Фаервол открыт только для нужных портов: 445/tcp, при необходимости 139/tcp и 137-138/udp для nmbd.
- Права каталога минимальны: владелец root, группа smbusers, режим 2770.
- На RHEL-семействе у каталога тип samba_share_t и getenforce показывает ожидаемый режим.
- guest ok и SMB1 не включены, если для них нет отдельного обоснования.
Финальная проверка после перезагрузки: sudo reboot, затем systemctl status smbd --no-pager и smbclient -L //host -U user с клиентской машины. Если шара появилась в списке и пускает по паролю, конфиг переживёт и плановое обновление пакетов, и внезапный ребут гипервизора. Дальше наращивайте сложность: отдельные шары для групп, квоты и бэкап каталога, а базовую теорию по пакетным менеджерам и сетям держите под рукой в практическом руководстве по Linux для IT-специалистов.