SSD Nodes Learn Hosting plans →
Anleitungen Matt ConnorVon Matt Connor · Aktualisiert 2026-10-22

Linux umask verstehen: Standardrechte neuer Dateien

Die umask entfernt Rechtebits bei neuen Dateien und Verzeichnissen. Prüfen Sie sie mit umask, lesen Sie die Modi aus und erklären Sie Unterschiede zwischen root und Benutzer.

Verified Every command ran end-to-end on a fresh Ubuntu 24.04 server, August 13, 2026.

Was die umask unter Linux bewirkt

Die umask ist eine Zahl, die jeder Prozess unter Linux mitführt. Sie bestimmt den Modus jeder Datei und jedes Verzeichnisses, die dieser Prozess erstellt. Ein Programm fordert beim Erstellen eine Reihe von Berechtigungen beim Kernel an. Der Kernel löscht jedes Bit, das die Maske angibt, und wendet die verbleibenden Bits an. Eine umask gewährt niemals Zugriff. Sie entfernt nur Bits aus den Berechtigungen, die das erstellende Programm angefordert hat. Der Kernel dokumentiert eine Ausnahme: Wenn das übergeordnete Verzeichnis über eine Default-ACL verfügt, wird die Maske ignoriert. Stattdessen wird die geerbte ACL angewendet.

Der Wert ist keine Eigenschaft Ihrer Distribution. Er hängt davon ab, unter welchem Benutzerkonto Sie arbeiten und wie die Shell gestartet wurde. Diese beiden Werte können auf demselben Rechner zur selben Zeit unterschiedlich sein, auch bei einem unveränderten Standard-Image. Der erste Schritt ist daher keine Suche in einem Handbuch. Messen Sie den Wert direkt auf dem System, das vor Ihnen steht.

Umask in der aktuellen Shell anzeigen

umask
umask -S

Die erste Form gibt die Maske oktal aus. Die zweite gibt dieselbe Maske als Berechtigungen aus, die sie zulässt, und verwendet dabei das von chmod akzeptierte symbolische Format. Lassen Sie beide Zeilen auf dem Bildschirm stehen. Alle folgenden Schritte vergleichen die Ausgabe mit dem, was Ihre Shell gerade ausgegeben hat.

umask ist ein Shell-Builtin und kein Programm auf dem Datenträger. Bestätigen Sie dies mit type umask. Das ist relevant, weil ein Builtin den Shell-Prozess selbst ändert. Ein separates Programm könnte nur seinen eigenen Prozess ändern, anschließend beendet es sich und nimmt die Änderung mit.

Datei und Verzeichnis erstellen und die Berechtigungsmodi anschließend auslesen

cd "$(mktemp -d)"
touch probe.file
mkdir probe.dir
stat -c '%a %A %n' probe.file probe.dir

%a gibt den Modus oktal aus, und %A gibt denselben Modus in der Form drwxr-xr-x aus, die ls -l verwendet. Vergleichen Sie beide Zeilen mit der zuvor ausgegebenen Maske. Jedes in der Maske gesetzte Bit fehlt in den Modi, weil eine Maske ausschließlich diese Bits löscht. Wenn sich die Spalte %A noch nicht intuitiv lesen lässt, sollten Sie zuerst die Berechtigungszeichenfolge drwxr-xr-x sicher verstehen.

Datei und Verzeichnis unterscheiden sich voneinander. Die Maske ist nicht der Grund für diesen Unterschied. touch fordert Lese- und Schreibrechte für Besitzer, Gruppe und andere an. mkdir fordert für alle drei Lese-, Schreib- und Ausführungsrechte an. Dieselbe Maske wird von zwei unterschiedlichen Anforderungen abgezogen. Eine mit touch erstellte Datei ist daher unabhängig vom Inhalt der Maske niemals ausführbar: Das Execute-Bit wurde nie angefordert, und eine Maske kann ein Bit nicht wieder hinzufügen.

( umask a=rwx; touch open.file; stat -c '%a %A %n' open.file )

Die Klammern führen die Befehle in einer Subshell aus. Die Änderung gilt daher nur innerhalb dieser Subshell. Die Maske fordert jetzt an, dass kein Bit gelöscht wird, und stat zeigt für die Datei weiterhin kein Execute-Bit an. Führen Sie anschließend erneut umask aus. Danach ist der ursprüngliche Wert wieder vorhanden. Das zeigt, dass die Einstellung innerhalb eines Prozesses gilt und an Kindprozesse vererbt wird, statt auf der Festplatte gespeichert zu werden.

Bei Verzeichnissen wirkt sich ein gelöschtes Execute-Bit aus.

( umask a=rw; mkdir noexec.dir; cd noexec.dir )

Als normaler Benutzer schlägt cd mit bash: cd: noexec.dir: Permission denied fehl, weil die Maske das von mkdir angeforderte Execute-Bit gelöscht hat. Ein Verzeichnis ohne Execute-Bit kann nicht betreten werden. root überspringt diese Prüfung. Daher zeigt sich dieses Verhalten nur bei einem normalen Benutzerkonto.

Warum root und Ihr eigener Benutzer eine unterschiedliche umask sehen

Führen Sie dieselbe Messung über ein anderes Konto und auf eine andere Weise gestartet aus. Lesen Sie anschließend beide Ausgaben direkt nebeneinander.

umask
sudo -i umask

sudo -i startet die Login-Shell von root und führt den integrierten Befehl darin aus. Damit handelt es sich um ein anderes Konto mit einem anderen Startpfad. Auf unveränderten Ubuntu- und Debian-Server-Images können die beiden Zeilen unterschiedliche Werte ausgeben. Beide Zeilen sind korrekt. Jede zeigt das Ergebnis ihres eigenen Startpfads. Im restlichen Beitrag geht es darum, welcher Teil des Systems dieses Ergebnis erzeugt hat.

Welche Datei in Ihrem Image den Wert festgelegt hat

grep -nE '^(UMASK|USERGROUPS_ENAB)' /etc/login.defs
grep -rn pam_umask /etc/pam.d/
grep -rn umask /etc/profile /etc/profile.d/ /etc/bash.bashrc ~/.profile ~/.bashrc 2>/dev/null || echo 'no umask line in the shell startup files'

Wenn der erste grep-Befehl keine Ausgabe liefert, führen Sie ihn erneut ohne den Anker ^ aus. Die Zeile ist möglicherweise auskommentiert. Eine auskommentierte Zeile dient als Dokumentation und ist keine Konfiguration. Der dritte grep-Befehl ist der Teil, der viele überrascht. Unter Debian und Ubuntu verweist die mitgelieferte /etc/profile meistens auf PAM, anstatt selbst eine Maske festzulegen. Die Datei, die Sie für zuständig hielten, ist es daher häufig nicht. grep beendet sich mit einem Fehlerstatus, wenn es keine Übereinstimmung findet. Deshalb endet diese Zeile mit || echo. Wenn in einer Image-Datei keine Startdatei eine Maske erwähnt, erhalten Sie die Meldung statt keiner Ausgabe. Diese Meldung ist das Ergebnis.

/etc/login.defs gibt einen Wert vor, PAM verwendet jedoch einen anderen

Die Zeile UMASK in /etc/login.defs ist der Wert, den die meisten Anleitungen nennen. Weder der Kernel noch die Shell liest diese Datei. Gelesen wird sie von pam_umask, einem PAM-Modul (Pluggable Authentication Modules), das beim Erstellen einer Sitzung ausgeführt wird. pam_umask verwendet den ersten gefundenen Wert: zuerst einen Eintrag umask= im GECOS-Feld des Benutzers, danach ein Argument umask=, das direkt in der Zeile pam_umask.so angegeben ist, anschließend UMASK aus /etc/login.defs und zuletzt einen Eintrag UMASK= in /etc/default/login. Distributionen patchen dieses Modul. Führen Sie daher man pam_umask auf Ihrem eigenen Image aus und prüfen Sie die dort ausgegebene Reihenfolge.

So kann /etc/login.defs einen Wert vorgeben, während Ihre Sitzung mit einem anderen Wert endet, ohne dass auf einer der beiden Seiten eine Warnung ausgegeben wird. Die grep-Befehle zeigen, welcher Fall bei Ihnen vorliegt. Wenn die Zeile pam_umask.so ein eigenes Argument umask= enthält, ist die Zeile in login.defs nicht mehr maßgeblich.

USERGROUPS_ENAB und die Ausnahme für root

id -un
id -gn

Wenn beide denselben Namen ausgeben, verwenden Sie eine private Benutzergruppe: Das Konto wurde mit einer eigenen Gruppe erstellt, die nach dem Konto benannt ist. USERGROUPS_ENAB in /etc/login.defs sorgt dafür, dass useradd diese Gruppe standardmäßig erstellt. pam_umask verfügt über ein entsprechendes usergroups-Verhalten. Im Upstream-Modul wird es durch ein usergroups-Argument in der pam_umask.so-Zeile oder durch einen Build-time-Standardwert aktiviert, und nousergroups deaktiviert es. Ubuntu hat das Modul 2011 so angepasst, dass es stattdessen USERGROUPS_ENAB liest. Lesen Sie daher den Kommentar über dieser Zeile und prüfen Sie man pam_umask in Ihrem eigenen Image. Ist dieses Verhalten aktiviert, das Konto nicht root und der Name der primären Gruppe identisch mit dem Benutzernamen, kopiert das Modul die Eigentümerziffer der Maske in die Gruppenziffer. Die Sitzung endet dann mit einer Maske, die die Gruppenbits für alles offen lässt, was dieses Konto erstellt. root wird vom Modul selbst ausgeschlossen. Diese Ausnahme ist der häufigste einzelne Grund dafür, dass zwei Shells auf demselben Server unterschiedliche Masken ausgeben.

Der Grund für diese Regel ist, dass eine private Gruppe genau ein Mitglied hat. Schreibrechte für die Gruppe bedeuten dann nur Schreibrechte für den Eigentümer. Das gilt so lange, bis jemand ein zweites Mitglied zur Gruppe hinzufügt. Ab diesem Zeitpunkt kann das neue Mitglied jede Datei ändern, die das Konto jemals erstellt hat. Dazu musste kein Befehl für diese Dateien ausgeführt werden. Geben Sie jedem Dienst ein eigenes Benutzerkonto mit minimalen Rechten, damit diese Gruppe absichtlich eine Gruppe mit nur einem Mitglied bleibt.

Login-Shell, Nicht-Login-Shell und nicht-interaktive Shell

umask
bash -lc 'umask'
bash -c 'umask'

PAM wird beim Erstellen einer Sitzung ausgeführt: login auf der Konsole, sshd, su, sudo -i. Wenn eine Shell eine weitere Shell startet, wird PAM nicht ausgeführt. bash -l ist eine Login-Shell. Sie liest daher /etc/profile und ~/.profile, ruft pam_umask aber nie auf, weil keine Sitzung erstellt wurde. bash -c liest keine der beiden Dateien und übernimmt die Maske des Prozesses, der sie gestartet hat. Ein Git-Hook und ein von einem Service-Manager gestartetes Programm fallen in diese letzte Kategorie. Ihre Maske entspricht daher der des übergeordneten Prozesses. Auch Cron liest keine der Shell-Startdateien. Unter Debian enthält seine PAM-Datei jedoch common-session-noninteractive. Dadurch wird pam_umask geladen, und jeder Job erhält den PAM-Wert, den auch eine Sitzung erhalten würde.

Daher tritt die Meldung „Ich habe den Wert in /etc/profile gesetzt, aber der Dienst erstellt weiterhin die falschen Berechtigungen“ so häufig auf. Der Dienst hat diese Datei nie gelesen.

Wo die Einstellung dauerhaft greift

Setzen Sie die Maske dort, wo die Workload tatsächlich gestartet wird, da jeder Startpfad eine andere Datei liest.

  1. Für Konten, die sich anmelden: UMASK in /etc/login.defs, angewendet von pam_umask auf jede Sitzung des Systems. Die Einstellung gilt systemweit und ändert daher alle Konten gleichzeitig.
  2. Für ein einzelnes Konto: Das Argument umask= in der Zeile pam_umask.so gilt ebenfalls systemweit. Ein benutzerspezifischer Wert gehört daher in das GECOS-Feld des betreffenden Benutzers oder für Login-Shells in ~/.profile und für interaktive Shells in ~/.bashrc.
  3. Für einen Daemon unter systemd: UMask= im Abschnitt [Service] der Unit. Eine Unit wird vom Service-Manager gestartet. Daher wird /etc/profile nie gelesen, und pam_umask wird nie ausgeführt. Nur die Unit-Datei von diesen Optionen erreicht den Daemon.
  4. Für ein von cron oder einem Hook gestartetes Skript: ein explizites umask in der ersten Zeile, bevor das Skript Dateien oder Verzeichnisse anlegt.
[Service]
UMask=<the octal mask you chose>

Prüfen Sie die Einstellung anschließend nach einem frischen Start über denselben Pfad. Führen Sie die Prüfung nicht in der Shell aus, in der Sie die Datei bearbeitet haben. Ihre aktuelle Shell verwendet bereits ihre vorhandene Maske. Das Bearbeiten einer Konfigurationsdatei wirkt sich nicht rückwirkend auf einen laufenden Prozess aus.

bash -lc 'umask'
sudo -i umask

Warum ein nachträgliches chmod das Problem nicht behebt

chmod korrigiert vorhandene Dateien. Die Maske bestimmt den Modus von Dateien, die noch nicht existieren. Führen Sie chmod -R für ein Verzeichnis aus, wird die nächste vom Dienst geschriebene Datei wieder mit dem alten Modus angelegt. Dieser Modus stammt vom erzeugenden Prozess. Eine Änderung am Modus des Verzeichnisses ändert daran nichts.

Es gibt außerdem ein Zeitfenster. Zwischen dem Erstellen der Datei und dem Ausführen von chmod liegt die Datei mit dem weiteren Modus auf der Festplatte. Jeder Prozess, der das Verzeichnis lesen kann, kann sie in dieser Zeit öffnen. Bei einem privaten Schlüssel oder einem Backup-Archiv ist genau dieses Zeitfenster das Risiko, das Sie beseitigen wollten.

Legen Sie den Modus stattdessen beim Erstellen fest. install -m u=rw,go= newfile /etc/app/newfile schreibt das Ziel mit einem expliziten Modus, und mkdir -m macht dasselbe für ein Verzeichnis. Beide verwenden den angegebenen Modus und ignorieren die Maske. ssh-keygen setzt den Modus des privaten Schlüssels, den der Befehl schreibt. Deshalb ist diese einzelne Datei auf einem System oft korrekt, während andere Dateien es nicht sind.

Typischerweise ist SSH betroffen. Ein mit einfachem mkdir erstelltes ~/.ssh oder ein mit cat >> angehängtes authorized_keys übernimmt die Maske Ihrer Shell. Wenn StrictModes aktiviert ist, verweigert sshd das Lesen einer Schlüsseldatei aus einem für die Gruppe beschreibbaren Verzeichnis. Der Client meldet Permission denied (publickey), während das /var/log/auth.log des Servers die tatsächliche Ursache protokolliert:

Authentication refused: bad ownership or modes for directory /home/deploy/.ssh

Diese Prüfung ist beabsichtigt, und die Absicherung von SSH auf einem VPS hängt davon ab, dass sie greift. Prüfen Sie die Maske auf einem neuen Server, bevor Sie die Konten anlegen, die den Server verwenden werden, zusammen mit den ersten zehn Minuten auf einem neuen VPS. Prüfen Sie sie anschließend erneut über jeden Pfad, über den diese Konten gestartet werden. Die Maske gehört zu jedem Prozess und nicht zum Server. Daher reicht kein einzelner Messwert für alle Konten aus.

Kopien und Archive ignorieren die Maske

cp -p und rsync -a stellen die auf der Quelldatei aufgezeichneten Berechtigungen wieder her. Die Maske hat daher keinen Einfluss auf das Ergebnis. tar verhält sich beim Entpacken als root genauso oder als gewöhnlicher Benutzer mit -p. Eine aus einem Backup wiederhergestellte Datei behält die Berechtigungen bei, die sie zum Zeitpunkt der Sicherung hatte. Prüfen Sie das, bevor Sie zu dem Schluss kommen, dass eine korrekte Maske ignoriert wird: Bei wiederhergestellten Daten wurde sie nie berücksichtigt. Eine korrekte Maske hat außerdem bei einer Default-ACL im übergeordneten Verzeichnis keinen Einfluss mehr. getfacl -d für dieses Verzeichnis zeigt die ACL an.

FAQ

Warum erstellt mein Cronjob Dateien mit einem anderen Modus als meine SSH-Sitzung?

Ein Cronjob liest weder /etc/profile noch ~/.profile. Eine in einer Shell-Startdatei gesetzte Maske wird daher nicht übernommen. Unter Debian öffnet cron über common-session-noninteractive eine PAM-Sitzung. Diese enthält pam_umask, sodass der Job den PAM-Wert erhält. Enthält der PAM-Stack von cron kein pam_umask, übernimmt der Job die Maske des Cron-Daemons. Setzen Sie in der ersten Zeile des Skripts explizit umask, bevor das Skript Dateien erstellt. Geben Sie die Maske außerdem einmal innerhalb des Jobs aus. So sehen Sie den tatsächlichen Wert dieses Jobs und nicht den Wert Ihrer eigenen Shell.

Warum steht in /etc/login.defs ein anderer Wert als der von meiner Shell ausgegebene?

UMASK in /etc/login.defs ist nur ein Fallback für pam_umask. Das Modul bevorzugt einen umask=-Eintrag im GECOS-Feld des Benutzers. Danach verwendet es ein umask=-Argument in der pam_umask.so-Zeile in /etc/pam.d/. Das durch das usergroups-Argument des Moduls aktivierte Verhalten für Benutzergruppen wird auf Builds, die es auslesen können, anschließend auch durch USERGROUPS_ENAB beeinflusst. Dabei wird die Gruppen-Ziffer für jedes Konto außer root neu gesetzt, dessen primäre Gruppe nach dem Konto benannt ist. Führen Sie grep -rn pam_umask /etc/pam.d/ und id -un; id -gn aus, um zu sehen, welche dieser Einstellungen für Ihr Konto gilt.

Kann eine umask eine Datei ausführbar machen?

Nein. Eine Maske kann nur Bits aus den vom erzeugenden Programm angeforderten Rechten entfernen. touch fordert das Execute-Bit nie an. Daher erzeugt keine Maske eine ausführbare Datei. Prüfen Sie dies in einem temporären Verzeichnis mit ( umask a=rwx; touch f; stat -c '%a %A' f ). Für ein Execute-Bit benötigen Sie chmod oder ein Programm wie install -m, das dieses Bit beim Erstellen anfordert.

Wo setze ich die umask für einen systemd-Dienst?

Setzen Sie sie in der Unit mit UMask= im Abschnitt [Service]. Ein Dienst wird vom Service Manager und nicht durch eine Anmeldung gestartet. Daher werden die Shell-Startdateien nicht gelesen, und pam_umask wird für den Dienst nicht ausgeführt. Führen Sie systemctl daemon-reload aus und starten Sie die Unit neu. Prüfen Sie das Ergebnis anschließend von außen: Lassen Sie den Dienst eine Datei erstellen, und lesen Sie das Ergebnis mit stat -c '%a %n' aus.

Ist eine Standardmaske mit Schreibrechten für die Gruppe sicher?

Sie ist sicher, solange die Gruppe genau ein Mitglied hat. Das ist die Grundlage des Schemas für private Benutzergruppen. Fügen Sie dieser Gruppe ein zweites Konto hinzu, kann dieses Mitglied sofort in jede Datei schreiben, die das erste Konto erstellt hat. Dafür muss kein Befehl für diese Dateien ausgeführt werden. Führen Sie id -un und id -gn aus. Wenn derselbe Name ausgegeben wird, verwenden Sie eine private Gruppe. Wenn Sie eine Gruppe für mehrere Konten freigeben, setzen Sie eine Maske, die das Schreib-Bit der Gruppe entfernt. Erstellen Sie anschließend eine Datei, und lesen Sie stat -c '%a %n' aus, um zu bestätigen, dass die Änderung wirksam wurde.

War dieser Artikel hilfreich?

#umask#permissions#pam#login-defs#linux