Пользователи и группы

Панель управляет локальными учётными записями подключённого Linux/Samba-сервера. Это не учётные записи самой панели и не управление пользователями контроллера AD. Проверка доменного сценария выделена отдельно.

Три разных назначения учётной записи

Учётная запись	Назначение
SSH-администратор	Вход в панель и выполнение серверных команд по sudo policy
Linux-пользователь	UID/GID, группы и права файловой системы
Samba-пользователь	Аутентификация файлового клиента по SMB

Наличие Linux-пользователя не означает, что у него есть Samba-пароль или доступ к ресурсу. Пароль Samba не заменяет SSH-реквизиты администратора.

Создание пользователя

В разделе Пользователи откройте форму добавления, задайте логин, отображаемое имя и пароль. Если отображаемое имя не задано, используется логин.

Приложение последовательно:

1. Создаёт Linux-пользователя с домашним каталогом и shell /bin/bash.
2. Устанавливает Linux-пароль.
3. Добавляет Samba-учётную запись с тем же паролем и включает её.

Используйте новый логин: форма не является механизмом подключения существующего Linux-пользователя к Samba. Для обычного логина используйте строчные латинские буквы, цифры, _, . и -, начиная с буквы или _; максимум 32 символа. Защищённые системные учётные записи изменять через API запрещено.

Созданная запись — полноценный Linux-пользователь, а не изолированная SMB-идентичность. Возможность её SSH-входа зависит от политики SSH-сервера; sudo-права ей автоматически не выдаются. После создания отдельно настройте группу и ресурс.

Смена пароля

Кнопка смены пароля обновляет Linux- и Samba-пароль выбранного пользователя. Это две последовательные операции, а не транзакция. При ошибке проверьте оба способа аутентификации перед повтором. Новые пароли не должны содержать переводы строк; текущая реализация удаляет пробелы по краям пароля.

Группы и префикс

В разделе Группы создайте, например, accounting. При стандартном samba.group.prefix=smb_ на сервере создаётся smb_accounting. В интерфейсе группы префикс скрывается; отображаются только группы с настроенным префиксом. Остальные системные группы этим списком не представлены.

Место использования	Значение при стандартном префиксе
Создание и управление группой в UI	accounting
Команды Linux	smb_accounting
Поле ресурса valid users	@smb_accounting
Поле ресурса force group	smb_accounting

Не добавляйте smb_ в имя при создании через UI: иначе получится двойной префикс. Подсказки полей ресурсов используют полное Linux-имя из API (systemName), а раздел управления группами — сокращённое имя (name). Существующие значения в конфигурации автоматически не переписываются; проверьте их перед сохранением.

Добавление и удаление участников

Откройте добавление участника у группы, выберите пользователя или введите несколько логинов через запятую. Добавление изменяет дополнительное членство Linux-пользователя. Несколько логинов обрабатываются отдельными запросами: часть может добавиться до ошибки.

Удаление участника убирает его из дополнительной группы, а не удаляет учётную запись. Основная группа пользователя может не отражаться в списке участников UI. Для проверки на сервере:

id alice
getent group smb_accounting

Это диагностические команды, а не команды изменения прав. Проверять их нужно на Samba-сервере. После изменения членства используйте новое SMB-подключение: уже открытая сессия может сохранять прежнюю идентичность и права.

Удаление

Пользователь: подтверждение показывает выбранный логин и последствия. Отмена не отправляет запрос удаления. Удаление последовательно убирает Samba-запись (smbpasswd -x) и Linux-пользователя (userdel без -r). Домашний каталог, почтовые файлы и данные ресурсов сохраняются; приложение не выполняет рекурсивное удаление или смену владельцев.

Файлы остаются с прежним числовым UID/GID: после удаления имя владельца может перестать отображаться. Повторное использование UID новой учётной записью может дать ей права на эти файлы. Администратор должен отдельно решить, как хранить, переносить или удалять данные и кому передавать владение; приложение этого автоматически не делает.

При ошибке Samba удаление Linux-пользователя не запускается. Если Samba-запись уже удалена, а Linux-шаг завершился ошибкой, API сообщает о частичном выполнении. Полного отката нет; при сбое соединения состояние могло измениться даже без подтверждённого ответа команды. Проверьте обе базы перед повторной попыткой. Защищённые системные пользователи по-прежнему не могут быть удалены через API.

Группа: удаляется Linux-группа с настроенным префиксом. Ссылки на неё в valid users, force group и владельцах каталогов автоматически не исправляются. Основная группа существующего пользователя может не удалиться.

Backup smb.conf не восстанавливает пользователей, пароли, SID, группы, владельцев или содержимое домашнего каталога. Для этих данных требуется отдельная резервная копия.