Установка и настройка Samba в Linux: пошаговый гайд 2026 | AdminWiki

Установка и настройка Samba в Linux: пошаговый гайд 2026

11 ноября 2026 14 мин. чтения
Содержание статьи

Что мы настраиваем и кому подойдёт это руководство

Рабочая общая папка на 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 / UbuntuRHEL / AlmaLinux / Rocky
Менеджер пакетовaptdnf
Пакетыsamba, smbclientsamba, samba-client
Путь к конфигу/etc/samba/smb.conf/etc/samba/smb.conf
Службыsmbd, nmbdsmbd, nmbd
Фаерволufwfirewalld
Мандатный контрольAppArmorSELinux
Логи/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 строк в основном состоит из комментариев, вычищать их не обязательно, но чужие конфиги целиком копировать не стоит: лишние параметры из старых гайдов либо игнорируются, либо ослабляют защиту.

ПараметрСекцияЧто делаетЧем грозит отсутствие или неверное значение
workgroupglobalИмя рабочей группы для NetBIOS-браузингаWindows-клиенты из другой группы не увидят сервер в сетевом окружении
securityglobalРежим аутентификации, user по умолчаниюПри ads или domain без настроенного домена аутентификация не пройдёт
server stringglobalОписание сервера в выводе 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 / UbuntuRHEL / AlmaLinux / Rocky
Установкаapt install samba smbclientdnf install samba samba-client
Конфиг/etc/samba/smb.conf/etc/samba/smb.conf
Службыsmbd, nmbdsmbd, nmbd
Автозагрузкаsystemctl enable --now smbd nmbdsystemctl enable --now smb (и nmb при необходимости)
Фаерволufw allow 445/tcpfirewall-cmd --add-service=samba
Мандатный контрольAppArmor, профиль smbdSELinux, тип samba_share_t
Ветка Samba 4.xDebian 12: 4.17.12; остальное сверяйте через smbd --versionминорную версию сверяйте через smbd --version
Проверка версииsmbd --versionsmbd --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-специалистов.

Поделиться: