Polecenie useradd: opcje, użycie -m i -s, ustawianie hasła przez passwd

Środowisko testoweRodzina RHELAlmaLinux 9.8shadow-utils 4.9konto rootDebian 12 zwykłe konto
Użytkownicy · grupyuseraddpasswdLokalizacja/usr/sbin/useradd

Polecenie useradd dodaje w Linuksie nowe konto użytkownika, a polecenie passwd ustawia lub blokuje hasło tego konta. Porównanie wartości domyślnych useradd i plików konfiguracyjnych na serwerach AlmaLinux 9 i Debian 12 pokazało, że AlmaLinux był ustawiony tak, by nawet bez opcji tworzyć katalog domowy i używać bash jako powłoki logowania, natomiast Debian nie miał ustawienia tworzącego katalog domowy, a jego domyślną powłoką było sh.

Wynik poniżej pochodzi z serwera AlmaLinux 9.8 na koncie root i z serwera Debian 12 na zwykłym koncie. Daty zmiany hasła, nazwy kont testowych i numery wersji pakietów shadow-utils i passwd zastąpiono przykładowymi wartościami.

1️⃣ Jak używać polecenia useradd

Podstawowa forma to [useradd opcje nazwa_konta]. Ponieważ polecenie zmienia /etc/passwd i /etc/shadow, w których są informacje o kontach, uruchamia się je z konta root lub przez sudo.

useradd user1

Według tabeli kodów wyjścia w oficjalnym podręczniku useradd kończy się kodem 0 po sukcesie i kodem 9, gdy konto o tej samej nazwie już istnieje. Utworzone konto sprawdza się poleceniem id lub getent passwd, a format wyniku id wygląda tak.

uid=1000(user1) gid=1000(user1) groups=1000(user1)

UID nowego konta to następna wartość po największym numerze już w użyciu, od UID_MIN 1000 w /etc/login.defs. Razem z kontem powstaje też grupa o tej samej nazwie.

Wiersz w /etc/passwd składa się z siedmiu pól rozdzielonych dwukropkami. Na serwerze AlmaLinux sprawdzono wiersz konta root.

getent passwd root
root:x:0:0:root:/root:/bin/bash

Od lewej są to nazwa konta, pole hasła, UID, GID, opis, katalog domowy i powłoka logowania. Litera x w polu hasła oznacza, że właściwy skrót hasła jest przechowywany osobno w /etc/shadow.

2️⃣ Tworzenie katalogu domowego za pomocą useradd -m

Opcja -m tworzy pod /home katalog domowy o nazwie konta i kopiuje do niego pliki z /etc/skel. To, czy katalog domowy powstaje także bez -m, zależy od wartości CREATE_HOME w /etc/login.defs.

grep CREATE_HOME /etc/login.defs
CREATE_HOME	yes

Na serwerze AlmaLinux 9.8 CREATE_HOME ma wartość yes, więc samo wpisanie useradd user1 tworzy /home/user1. W /etc/login.defs serwera Debian 12 ten sam grep nie znalazł żadnego wiersza i zakończył się kodem wyjścia 1. Oficjalny podręcznik podaje, że jeśli CREATE_HOME nie jest włączone, bez -m katalog domowy nie jest tworzony.

Na serwerze Debian 12 trzeba też sprawdzić domyślną powłokę. Po wypisaniu wartości domyślnych na zwykłym koncie SHELL miało wartość /bin/sh.

/usr/sbin/useradd -D
GROUP=100
HOME=/home
INACTIVE=-1
EXPIRE=
SHELL=/bin/sh
SKEL=/etc/skel
CREATE_MAIL_SPOOL=no
LOG_INIT=yes

Na serwerze Debian 12 /bin/sh był dowiązany do dash. Aby nowe konto logowało się do bash, podaje się razem katalog domowy i powłokę.

useradd -m -s /bin/bash user1

Pliki kopiowane do katalogu domowego znajdują się w /etc/skel.

ls -lA /etc/skel
total 12
-rw-r--r--. 1 root root  18 Apr 30  2024 .bash_logout
-rw-r--r--. 1 root root 141 Apr 30  2024 .bash_profile
-rw-r--r--. 1 root root 492 Apr 30  2024 .bashrc

W /etc/skel serwera AlmaLinux były trzy pliki konfiguracyjne bash, a serwer Debian 12 miał .bash_logout, .bashrc i .profile. Jeśli każde nowe konto ma dostać jakieś pliki konfiguracyjne, umieszcza się je wcześniej w /etc/skel; inny katalog wskazuje się opcją -k.

Z kolei po dodaniu -M katalog domowy nie powstaje, nawet gdy CREATE_HOME ma wartość yes.

3️⃣ Opcje useradd

Listę opcji wypisuje useradd --help. Często używane opcje w shadow-utils 4.9 na serwerze AlmaLinux 9.8 są następujące.

OpcjaKopiujOpis
-m, --create-homeTworzy katalog domowy i kopiuje pliki z /etc/skel
-M, --no-create-homeNie tworzy katalogu domowego
-s, --shellUstawia powłokę logowania
-g, --gidUstawia grupę podstawową, tylko istniejące grupy
-G, --groupsUstawia grupy dodatkowe, kilka rozdziela się przecinkami
-c, --commentWypełnia pole opisu (GECOS)
-D, --defaultsWypisuje wartości domyślne; z dodatkowymi opcjami je zmienia
OpcjaKopiujOpis
-d, --home-dirUstawia ścieżkę katalogu domowego
-u, --uidUstawia UID
-e, --expiredateUstawia datę wygaśnięcia konta (YYYY-MM-DD)
-f, --inactiveLiczba dni od wygaśnięcia hasła do chwili, gdy konta nie można już używać
-r, --systemTworzy konto systemowe
-N, --no-user-groupNie tworzy grupy o tej samej nazwie co konto
-p, --passwordUstawia zaszyfrowane hasło

Kilka opcji można zapisać razem w jednym wierszu. Ten przykład ustawia naraz ścieżkę katalogu domowego, powłokę i pole opisu.

useradd -m -d /home/web1 -s /bin/bash -c 'Web user' web1

-G dodaje grupy i pozostawia grupę podstawową bez zmian. W /etc/sudoers serwera AlmaLinux był wiersz pozwalający grupie wheel uruchamiać wszystkie polecenia. Dlatego konto dodane do grupy wheel może przez sudo uruchamiać polecenia z uprawnieniami root.

grep -E '^%wheel' /etc/sudoers
%wheel	ALL=(ALL)	ALL
useradd -G wheel user2

Po sprawdzeniu tak utworzonego konta poleceniem id w polu groups pojawia się dopisane 10(wheel).

uid=1001(user2) gid=1001(user2) groups=1001(user2),10(wheel)

-r tworzy konto systemowe używane przez programy usługowe. UID jest wybierany z przedziału od SYS_UID_MIN 201 do SYS_UID_MAX 999 w /etc/login.defs. Według oficjalnego podręcznika konto -r nie dostaje katalogu domowego nawet przy CREATE_HOME yes, a konto, które nigdy nie musi się logować, dostaje powłokę /sbin/nologin.

useradd -r -s /sbin/nologin svc1

-p to opcja przyjmująca wartość zaszyfrowanego hasła. Oficjalny podręcznik odradza ją, ponieważ wartość może być widoczna dla użytkowników przeglądających listę procesów; dlatego hasło ustawia się poleceniem passwd po utworzeniu konta.

🔲 Symulator polecenia useradd

W symulatorze poniżej można samodzielnie wpisać kolejne kroki: utworzyć konto poleceniem useradd, ustawić hasło poleceniem passwd i sprawdzić je za pomocą id i getent.

Symulator polecenia useraddshadow-utils 4.9
[root@server work]#
To wirtualny serwer AlmaLinux działający tylko w przeglądarce; utworzone konta pojawiają się w tabeli po lewej i w drzewie /home, a ↑↓ przywołuje wcześniej wpisane polecenia.

4️⃣ Praktyczne przykłady polecenia useradd

  • ↪️ Tworzenie konta deweloperskiego i częste błędy na początku

🔲 Tworzenie konta deweloperskiego

Konto dla dewelopera utworzono w jednym wierszu, z katalogiem domowym, powłoką bash, polem opisu i grupą wheel. useradd zakończył działanie bez wypisania czegokolwiek, a podane wartości było widać bez zmian w wyniku id i w wierszu /etc/passwd.

~]# useradd -m -s /bin/bash -c 'Dev User' -G wheel devuser
~]# id devuser
uid=1001(devuser) gid=1001(devuser) groups=1001(devuser),10(wheel)
~]# grep '^devuser:' /etc/passwd
devuser:x:1001:1001:Dev User:/home/devuser:/bin/bash

Katalog domowy utworzono z uprawnieniami drwx------, które pozwalają go otworzyć tylko temu kontu, i skopiowano do niego trzy pliki konfiguracyjne bash z /etc/skel. Ponieważ serwer ma CREATE_MAIL_SPOOL=yes, powstał też plik kolejki poczty o rozmiarze 0.

~]# ls -la /home/devuser
total 20
drwx------. 2 devuser devuser 4096 Nov 14 07:40 .
drwxr-xr-x. 4 root    root    4096 Nov 14 07:40 ..
-rw-r--r--. 1 devuser devuser   18 Apr 30  2024 .bash_logout
-rw-r--r--. 1 devuser devuser  141 Apr 30  2024 .bash_profile
-rw-r--r--. 1 devuser devuser  554 Nov  3 02:28 .bashrc
~]# ls -l /var/spool/mail/devuser
-rw-rw----. 1 devuser mail 0 Nov 14 07:40 /var/spool/mail/devuser

Sprawdzenie poleceniem passwd -S zaraz po utworzeniu konta pokazało stan LK.

~]# passwd -S devuser
devuser LK 2026-11-14 0 99999 7 -1 (Password locked.)

Po ustawieniu hasła przez dwukrotne wpisanie go w passwd devuser ponowne sprawdzenie pokazało stan zmieniony na PS.

~]# passwd -S devuser
devuser PS 2026-11-14 0 99999 7 -1 (Password set, SHA512 crypt.)

🔲 Częste błędy na początku

Po wpisaniu za -G grupy, która jeszcze nie istniała, konto nie zostało utworzone, a polecenie zakończyło się kodem wyjścia 6. Grupy dodawane opcją -G trzeba utworzyć wcześniej.

~]# useradd -G developers bob
useradd: group 'developers' does not exist

Przy błędnie wpisanej ścieżce powłoki pojawił się tylko jeden wiersz ostrzeżenia, a konto i tak zostało utworzone. W ostatnim polu /etc/passwd zapisano nieistniejącą ścieżkę /bin/bsh, dlatego po utworzeniu konta trzeba ponownie sprawdzić to pole.

~]# useradd -s /bin/bsh bob
useradd: Warning: missing or non-executable shell '/bin/bsh'
~]# grep '^bob:' /etc/passwd
bob:x:1002:1002::/home/bob:/bin/bsh

Innym błędem jest pomylenie małego -g z wielkim -G. Gdy wcześniejsze konto bob usunięto poleceniem userdel -r i utworzono ponownie z -g wheel, grupą podstawową została wheel, a grupa o nazwie konta nie powstała.

~]# useradd -g wheel bob
~]# id bob
uid=1002(bob) gid=10(wheel) groups=10(wheel)

Konto utworzone z -M nie ma katalogu domowego, więc po przejściu na nie przez su - pojawiło się ostrzeżenie [su: warning: cannot change directory to /home/tempuser: No such file or directory].

~]# useradd -M tempuser
~]# ls -ld /home/tempuser
ls: cannot access '/home/tempuser': No such file or directory
~]# su - tempuser -c pwd
su: warning: cannot change directory to /home/tempuser: No such file or directory
/root

🔲 Jak czytać wynik useradd

Po sukcesie useradd niczego nie wypisuje, więc wynik sprawdza się w plikach z informacjami o kontach. W /etc/group devuser został dopisany do listy członków na końcu wiersza wheel dodanego opcją -G, a grupa devuser o tej samej nazwie co konto miała puste pole członków.

~]# grep -E '^(wheel|devuser):' /etc/group
wheel:x:10:linuxuser,devuser
devuser:x:1001:

W /etc/shadow drugie pole przed ustawieniem hasła miało wartość [!!], a trzecie pole, 20771, to liczba dni liczonych od 1 stycznia 1970, czyli 14 listopada 2026.

~]# grep '^devuser:' /etc/shadow | cut -d: -f1-3
devuser:!!:20771

useradd, passwd i id można samodzielnie wpisać w narzędziu Symulator polecenia useradd.

Do ustawienia okresu ważności hasła i daty wygaśnięcia tak utworzonego konta służy polecenie chage.

5️⃣ Wartości domyślne useradd i /etc/login.defs

useradd -D uruchomione bez opcji wypisuje wartości domyślne zapisane w /etc/default/useradd. Oto wynik na serwerze AlmaLinux.

useradd -D
GROUP=100
HOME=/home
INACTIVE=-1
EXPIRE=
SHELL=/bin/bash
SKEL=/etc/skel
CREATE_MAIL_SPOOL=yes

HOME, SHELL i SKEL to nadrzędna ścieżka, pod którą powstają katalogi domowe, domyślna powłoka i katalog z plikami do skopiowania. GROUP=100 to numer domyślnej grupy users, używanej, gdy nie tworzy się grupy o nazwie konta. INACTIVE=-1 i puste EXPIRE oznaczają, że nie ustawiono ani dezaktywacji po wygaśnięciu hasła, ani daty wygaśnięcia konta.

Po dodaniu za -D opcji takiej jak -s zamiast wypisania wartości domyślnych zmieniane są wartości w /etc/default/useradd. Aby tylko sprawdzić wartości domyślne, uruchamia się samo -D.

Zakres UID, uprawnienia katalogu domowego i sposób przechowywania haseł ustawia się w /etc/login.defs.

grep -E '^(UID_MIN|UID_MAX|SYS_UID_MIN|SYS_UID_MAX|HOME_MODE|USERGROUPS_ENAB|ENCRYPT_METHOD|CREATE_HOME)' /etc/login.defs
HOME_MODE	0700
UID_MIN                  1000
UID_MAX                 60000
SYS_UID_MIN               201
SYS_UID_MAX               999
ENCRYPT_METHOD SHA512
USERGROUPS_ENAB yes
CREATE_HOME	yes

HOME_MODE 0700 oznacza, że nowe katalogi domowe są tworzone z uprawnieniami pozwalającymi otworzyć je tylko temu kontu, a ENCRYPT_METHOD SHA512 oznacza, że hasła ustawione poleceniem passwd są przechowywane jako skrót SHA-512. USERGROUPS_ENAB yes to ustawienie, które dla każdego nowego konta tworzy grupę o tej samej nazwie.

/etc/login.defs serwera Debian 12 też miał te same UID_MIN 1000 i ENCRYPT_METHOD SHA512, ale nie miał wierszy HOME_MODE i CREATE_HOME. Wynik useradd -D w Debianie zawierał CREATE_MAIL_SPOOL=no, które nie tworzy pliku kolejki poczty.

6️⃣ Jak używać polecenia passwd

Z nazwą konta polecenie passwd zmienia hasło tego konta, a bez nazwy zmienia hasło konta, które jest teraz zalogowane. Hasło innego konta może zmienić tylko root.

passwd user1
Changing password for user user1.
New password: 
Retype new password: 
passwd: all authentication tokens updated successfully.

Wpisywane hasło nie pojawia się na ekranie i jest zapisywane tylko wtedy, gdy oba wpisy są takie same. Jeśli się różnią, pojawia się [Sorry, passwords do not match.] i polecenie znowu pyta o nowe hasło. W konfiguracji PAM serwera AlmaLinux wiersz pam_pwquality, który sprawdza hasła, ma retry=3, więc o hasło pyta się łącznie do trzech razy.

Domyślna minimalna długość w pwquality to 8 znaków, więc przy krótszym haśle pojawia się [BAD PASSWORD: The password is shorter than 8 characters]. Na serwerze AlmaLinux 9.8 wiersz enforce_for_root w pwquality.conf był zakomentowany, ale ta sama wartość była dopisana do wiersza konfiguracji PAM. Dlatego nawet po wpisaniu krótkiego hasła jako root po ostrzeżeniu ponownie padło pytanie o nowe hasło, a na końcu pojawiło się [Password change has been aborted.].

To, że zwykłe konto może zmienić własne hasło, wynika z uprawnień dwóch plików.

stat -c "%A %U %G %n" /usr/bin/passwd /etc/shadow
-rwsr-xr-x root root /usr/bin/passwd
---------- root root /etc/shadow

/etc/shadow ma wszystkie pola uprawnień puste, więc odczytywać i zapisywać go może tylko root. /usr/bin/passwd ma s (setuid) w polu właściciela, więc nawet uruchomiony przez zwykłe konto działa z uprawnieniami root i zapisuje nowe hasło w /etc/shadow.

7️⃣ Opcje passwd i sprawdzanie stanu

Opcje passwd się różnią, bo każda dystrybucja dostarcza inny program. Na serwerze AlmaLinux passwd był w pakiecie passwd oddzielnym od shadow-utils.

rpm -qf /usr/sbin/useradd /usr/bin/passwd
shadow-utils-4.9-10.el9.x86_64
passwd-0.80-10.el9.x86_64

Na serwerze Debian 12 useradd i passwd były oba w pakiecie passwd. Według passwd --help na serwerze AlmaLinux 9.8 często używane opcje są następujące i wszystkich może używać tylko root.

OpcjaZadanie
-S, --statusWypisuje stan hasła w jednym wierszu
-l, --lockBlokuje hasło, dodając ! przed skrótem
-u, --unlockOdblokowuje hasło
-d, --deleteUsuwa hasło
-e, --expireOd razu unieważnia hasło, zmiana przy następnym logowaniu
-x, --maximumMaksymalna liczba dni używania hasła
-n, --minimumMinimalna liczba dni używania hasła
-w, --warningLiczba dni ostrzeżenia przed wygaśnięciem
-i, --inactiveLiczba dni od wygaśnięcia do dezaktywacji konta
--stdinPrzyjmuje nowe hasło ze standardowego wejścia

passwd --help na serwerze Debian 12 nie miał --stdin, za to miał -a, które razem z -S wypisuje stan wszystkich kont.

-S wypisuje stan hasła w jednym wierszu.

passwd -S root
root PS 2026-01-15 0 99999 7 -1 (Password set, SHA512 crypt.)

Pola to kolejno nazwa konta, stan, data ostatniej zmiany hasła, minimalna liczba dni, maksymalna liczba dni, dni ostrzeżenia i dni nieaktywności. Stan PS to hasło, którego można używać, LK to hasło zablokowane, a NP oznacza brak hasła. Według oficjalnego podręcznika konto utworzone przez useradd ma wyłączone hasło, więc nie może logować się hasłem, dopóki nie zostanie ono ustawione poleceniem passwd.

W AlmaLinux opcji -S może używać tylko root. Gdy root pożyczył przez runuser uprawnienia konta nobody i uruchomił polecenie, zakończyło się ono komunikatem [Only root can do that.].

runuser -u nobody -- passwd -S nobody
Only root can do that.

Na serwerze Debian 12 zwykłe konto mogło sprawdzić własny stan. Pole stanu pokazywało P zamiast PS, a na końcu nie było objaśnienia w nawiasie.

passwd -S
webuser P 2026-01-20 0 99999 7 -1

Sprawdzenie stanu root z tego samego zwykłego konta zostało zablokowane komunikatem [You may not view or modify password information for root.].

Nawet po zablokowaniu hasła opcją -l według oficjalnego podręcznika nadal można się zalogować przez inne uwierzytelnianie, na przykład klucze SSH. Aby zablokować całe konto, używa się [chage -E 0 nazwa_konta].

🔢 FAQ & polecane treści

Na serwerze AlmaLinux 9.8 /usr/sbin/adduser był dowiązaniem do useradd, więc oba polecenia były tym samym programem. Na serwerze Debian 12 adduser to osobny program z pakietu adduser, a oficjalny podręcznik opisuje go jako program, który obudowuje narzędzia niższego poziomu, takie jak useradd, i pyta o pole opisu i hasło.

useradd znajduje się w /usr/sbin. /etc/login.defs serwera Debian 12 nie dodawał /usr/sbin do PATH zwykłych kont, a wpisanie [useradd -D] na zwykłym koncie zakończyło się komunikatem [command not found]. Trzeba dodać [sudo] albo uruchomić polecenie z konta root.

passwd w systemach z rodziny RHEL, takich jak AlmaLinux, ma opcję --stdin, która przyjmuje nowe hasło ze standardowego wejścia, i może jej używać tylko root. passwd na serwerze Debian 12 nie miał tej opcji. Na obu serwerach był [chpasswd], który według oficjalnego podręcznika przyjmuje ze standardowego wejścia wiersze w formie [konto:hasło] i ustawia naraz hasła wielu kont. Hasła wpisane bezpośrednio w wierszu poleceń mogą zostać w historii powłoki.

ℹ️ Informacja o linkach partnerskich
Treści tej witryny zawierają linki partnerskie. Jeśli odwiedzający kupi produkt lub usługę przez taki link, witryna otrzymuje od sprzedawcy prowizję. Kwota płacona przy tym przez kupującego (podczas promocji spada↓) nie wzrasta. Podane ceny, rabaty i dostępność odnoszą się do chwili pisania i mogą różnić się od stanu faktycznego, dlatego przed zakupem sprawdź je u sprzedawcy. Produkty wybieramy i oceniamy według własnych kryteriów, a prowizja nie wpływa ani na kolejność prezentacji, ani na treść ocen.

Dodaj komentarz

Twój adres email nie zostanie opublikowany. Wymagane pola są oznaczone *

Prove your humanity: 3   +   7   =