SSD Nodes Learn Hosting plans →
ガイド Matt Connor著者 Matt Connor ・更新日 2026-10-13

Linuxのumaskとは?デフォルト権限の決まり方

umaskは新規ファイルのmodeからビットを取り除きます。umaskを表示し、ファイルとディレクトリを作成してstatで確認し、rootとユーザーで値が異なる理由を説明します。

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

Linux で umask が行う処理

umask は Linux 上のすべてのプロセスが持つ数値で、そのプロセスが作成する各ファイルとディレクトリのモードを決めます。プログラムは作成時に、必要な権限の組み合わせを kernel に要求します。kernel は umask で指定されたビットをすべてクリアし、残ったビットを適用します。umask がアクセス権を付与することはありません。作成元のプログラムが要求した権限から、ビットを取り除くだけです。kernel の仕様には、1 つ例外があります。親ディレクトリに default ACL がある場合、umask は無視され、継承された ACL が適用されます。

この値はディストリビューションの属性ではありません。使用している account と、shell の起動方法によって異なります。同じマシン上で、同じ時点に、標準イメージを使用していても、この 2 つの条件に対する結果は異なる場合があります。したがって、最初に行うべきことはマニュアルで調べることではありません。目の前のマシンで実際の値を確認します。

シェルで umask を表示する

umask
umask -S

1 行目はマスクを 8 進数で表示します。2 行目は、同じマスクを、そのマスクが許可する権限として、chmod が受け付ける記号形式で表示します。両方の行を画面に残してください。以下では、シェルに表示された内容と比較します。

umask はディスク上のプログラムではなく、シェルの組み込みコマンドです。type umask で確認してください。これは重要です。組み込みコマンドはシェルプロセス自体を変更するためです。別のプログラムでは自身のプロセスしか変更できず、終了すると変更も失われます。

ファイルとディレクトリを作成し、モードを読み戻す

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

%a はモードを8進数で表示し、%A は ls -l が使用する drwxr-xr-x 形式で同じモードを表示します。どちらの行も、先ほど表示したマスクと比較してください。マスクで設定されているビットはすべてモードから欠落します。マスクが行う処理は、そのビットをクリアすることだけだからです。%A 列の読み方がまだ明確でなければ、まず drwxr-xr-x の権限文字列を正しく理解してください。

ファイルとディレクトリのモードは異なりますが、その違いの原因はマスクではありません。touch は owner、group、other に read と write を要求します。mkdir は3者すべてに read、write、execute を要求します。同じマスクが、異なる2つの要求に適用されます。そのため、touch で作成したファイルは、マスクの内容に関係なく実行可能にはなりません。execute ビットが最初から要求されておらず、マスクでビットを追加することはできないためです。

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

この括弧内ではコマンドが subshell で実行されるため、変更はその subshell の終了とともに失われます。マスクは現在、クリア対象を何も指定していません。それでも stat は、ファイルに execute ビットがないことを表示します。その後で umask を再度実行すると元の値に戻ります。これは、この設定がディスク上のどこかに保存されるのではなく、プロセス内に存在し、子プロセスに継承されることを示しています。

クリアされた execute ビットの影響が現れるのは、ディレクトリです。

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

通常のユーザーとして実行すると、cd は bash: cd: noexec.dir: Permission denied で失敗します。マスクによって、mkdir が要求した execute ビットがクリアされ、execute ビットのないディレクトリには入れないためです。root はこのチェックを回避するため、この影響が現れるのは通常のアカウントだけです。

root と自分のユーザーで umask が異なる理由

別のアカウントから別の方法で同じ測定を実行し、2 つの出力を並べて確認します。

umask
sudo -i umask

sudo -i は root のログインシェルを起動し、その中で組み込みコマンドを実行します。つまり、別のアカウントが別の起動経路を経由してログインする場合に相当します。標準的な Ubuntu および Debian のサーバーイメージでは、2 行に異なる値が表示されることがあります。どちらの行も正しい値です。それぞれの起動経路で生成された値を示しています。以降では、システムのどの部分がその値を生成したのかを説明します。

イメージ上のどのファイルが値を決めていたか

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'

最初の grep で何も表示されない場合は、^ アンカーを付けずにもう一度実行します。行がコメントアウトされている可能性があり、コメント行は設定ではなくドキュメントだからです。3 番目の grep が、意外な結果になる箇所です。Debian と Ubuntu では、同梱の /etc/profile は自身でマスクを設定せず、主に PAM を参照します。そのため、設定を担っていると思っていたファイルが、実際には該当しないことがよくあります。grep は一致するものがない場合にゼロ以外の終了ステータスを返します。これが、その行が || echo で終わっている理由です。起動時に読み込まれるファイルのどれにもマスクの指定がないイメージでは、何も表示されない代わりにメッセージが表示されます。そのメッセージ自体が調査結果です。

/etc/login.defs は値を示し、PAM がその値を適用する

/etc/login.defs の UMASK 行が、多くのガイドで引用されている値です。kernel も shell もこのファイルを読みません。セッション作成時に実行される PAM(pluggable authentication modules)モジュールの pam_umask が読み取ります。pam_umask は、最初に見つかった値を使用します。順序は、ユーザーの GECOS フィールドにある umask= エントリ、pam_umask.so 行自体に記述された umask= 引数、/etc/login.defs の UMASK、最後に /etc/default/login の UMASK= エントリです。ディストリビューションはこのモジュールにパッチを適用しているため、自分のイメージ上で man pam_umask を実行し、表示された順序を確認してください。

この仕組みにより、/etc/login.defs がある値を示していても、セッションには別の値が適用されます。どちらの側にも警告は表示されません。grep の結果から、どのケースに該当するかを確認できます。pam_umask.so 行に独自の umask= 引数がある場合、login.defs の行は無効になります。

USERGROUPS_ENAB と root の例外

id -un
id -gn

この 2 つが同じ名前を出力する場合、ユーザー専用グループが設定されています。アカウントの作成時に、そのアカウント名を付けた専用グループが作成されています。/etc/login.defs の USERGROUPS_ENAB が、useradd にこのグループをデフォルトで作成させます。pam_umask にも対応する usergroups 動作があります。上流のモジュールでは、pam_umask.so 行の usergroups 引数、またはビルド時のデフォルトによって有効になります。nousergroups によって無効になります。Ubuntu は 2011 年にモジュールへパッチを適用し、代わりに USERGROUPS_ENAB を読み取るようにしました。そのため、その行の上にあるコメントを読み、自分のイメージで man pam_umask を確認してください。動作が有効で、アカウントが root ではなく、プライマリグループ名がユーザー名と一致する場合、モジュールはマスクの所有者用の数字をグループ用の数字にコピーします。その結果、セッション終了時のマスクでは、そのアカウントが作成するすべてのファイルでグループ用ビットが開いた状態になります。root はモジュール自体によって除外されます。この除外が、同じサーバー上の 2 つのシェルで異なるマスクが出力される最も一般的な単一の理由です。

この規則の背景には、専用グループのメンバーが 1 人だけであるという前提があります。そのため、グループによる書き込みが可能であっても、実質的には所有者による書き込みと変わりません。誰かがそのグループに 2 人目のメンバーを追加するまでは、この前提が成り立ちます。その時点から、そのアカウントが過去に作成したすべてのファイルを新しいメンバーが書き換えられるようになります。しかも、その状態にするために各ファイルでコマンドを実行する必要はありません。各サービスに 最小権限の専用ユーザーアカウントを割り当てれば、そのグループを意図的に 1 人だけのグループとして維持できます。

ログインシェル、非ログインシェル、非対話シェル

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

PAM はセッションの作成時に実行されます。login コンソール上、sshd、su、sudo -i などが該当します。あるシェルが別のシェルを起動しても、PAM は実行されません。bash -l はログインシェルであるため、/etc/profile と ~/.profile を読み込みます。ただし、セッションは作成されていないため、pam_umask は呼び出しません。bash -c はどちらのファイルも読み込まず、起動元プロセスのマスクを継承します。git hook とサービスマネージャーが起動したプログラムはこのケースに該当するため、使用するマスクは親プロセスの値になります。cron もシェルの起動ファイルを読み込みません。ただし、Debian では PAM ファイルに common-session-noninteractive が含まれており、pam_umask が読み込まれます。そのため、各ジョブにはセッションで設定される値と同じ PAM の値が適用されます。

このため、「/etc/profile に設定したのに、サービスがまだ誤ったモードで書き込む」という報告がよくあります。そのサービスは、そもそもそのファイルを読み込んでいません。

設定をどこに置けば再起動後も維持されるか

ワークロードが実際に起動する場所でマスクを設定します。起動経路ごとに読み込むファイルが異なるためです。

  1. ログインするアカウントの場合: UMASK を /etc/login.defs に設定します。pam_umask がマシン上のすべてのセッションに適用します。マシン全体の設定であるため、すべてのアカウントに一括で反映されます。
  2. 1 つのアカウントだけに設定する場合: pam_umask.so 行の umask= 引数もマシン全体に適用されます。そのため、ユーザー単位の値はそのユーザーの GECOS フィールド、またはログインシェル用の ~/.profile、対話シェル用の ~/.bashrc に設定します。
  3. systemd 配下のデーモンの場合: unit の [Service] セクションに UMask= を設定します。unit はサービスマネージャーによって起動されるため、/etc/profile は読み込まれず、pam_umask も実行されません。これらの設定のうち、デーモンに到達するのは unit ファイルだけです。
  4. cron またはフックから起動するスクリプトの場合: スクリプトが何かを作成する前に、1 行目で明示的に umask を設定します。
[Service]
UMask=<the octal mask you chose>

その後、同じ起動経路を新しく開始して確認します。ファイルを編集したシェルから確認してはいけません。現在のシェルはすでに自身のマスクを保持しており、設定ファイルを編集しても実行中のプロセスには反映されないためです。

bash -lc 'umask'
sudo -i umask

後から chmod しても同じ修正にはならない理由

chmodは、すでに存在するファイルを修正します。mask は、まだ存在しないファイルの mode を決めます。ディレクトリに対して chmod -R を実行しても、次にサービスが作成するファイルには再び以前の mode が設定されます。その mode はファイルを作成したプロセスに由来するため、ディレクトリの mode を変更しても影響しません。

また、時間差も生じます。ファイルの作成から chmod の実行までの間、ファイルはより広い mode のままディスク上に存在します。そのディレクトリを読み取れるプロセスは、期間中にファイルを開けます。秘密鍵やバックアップアーカイブでは、この期間が取り除こうとしていたリスクになります。

作成時に mode を設定してください。install -m u=rw,go= newfile /etc/app/newfile は明示した mode で保存先を作成し、mkdir -m もディレクトリに対して同じ動作をします。どちらも指定した mode を使用し、mask を無視します。ssh-keygen は書き込む秘密鍵の mode を設定します。そのため、ほかのファイルが正しくないマシンでも、このファイルだけは適切な mode になっていることがよくあります。

通常、影響を受けるのは SSH です。単純な mkdir で作成した ~/.ssh や、cat >> で追加した authorized_keys には、shell の mask が適用されます。StrictModes が有効な場合、sshd は group-writable なディレクトリ内の鍵ファイルを読み取りません。クライアントには Permission denied (publickey) が表示されますが、サーバー側の /var/log/auth.log には実際の原因が記録されます。

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

このチェックは意図的なものです。VPS の SSH を強化する方法も、このチェックが機能することを前提としています。新しいサーバーでは、新しい VPS で最初の 10 分間に行うことと同時に、利用するアカウントを作成する前の mask を確認してください。その後、それらのアカウントが開始する各経路でも再度確認します。mask はサーバーではなく各プロセスに属するため、1 回の確認だけで全アカウントの状態を判断することはできません。

コピーとアーカイブではマスクが無視される

cp -p と rsync -a は、コピー元ファイルに記録されたモードを復元するため、結果に対してマスクは影響しません。tar も、root として展開する場合、または -p を使用して一般ユーザーとして展開する場合は同じ動作になります。バックアップから復元したファイルは、バックアップ作成時のモードを保持します。正しいマスクが無視されていると判断する前に、この点を確認してください。復元されたデータでは、マスクは最初から参照されていません。正しいマスクが影響しなくなるもう 1 つのケースは、親ディレクトリの default ACL です。その設定は、そのディレクトリで getfacl -d を実行すると確認できます。

FAQ

cron ジョブが ssh セッションと異なるモードでファイルを作成するのはなぜですか?

cron ジョブは /etc/profile も ~/.profile も読み込まないため、shell の起動ファイルで設定したマスクは cron ジョブに引き継がれません。Debian では、cron は common-session-noninteractive を通じて PAM セッションを開始します。ここには pam_umask が含まれるため、ジョブには PAM の値が適用されます。cron の PAM スタックに pam_umask がない場合、ジョブは cron デーモンのマスクを継承します。スクリプトが何かを作成する前に、先頭行へ明示的な umask を記述してください。さらに、ジョブ内部でマスクを 1 回出力し、自分の shell の値ではなく、そのジョブに実際に適用された値を確認します。

/etc/login.defs の内容と shell が出力する値が異なるのはなぜですか?

/etc/login.defs にある UMASK は、pam_umask のフォールバックにすぎません。モジュールはまずユーザーの GECOS フィールドにある umask= エントリを優先し、次に /etc/pam.d/ の pam_umask.so 行にある umask= 引数を参照します。モジュールの usergroups 引数で有効にした usergroups の動作は、これを読み取るようパッチが適用されたビルドでは USERGROUPS_ENAB によっても有効になります。その場合、primary group の名前がユーザー名と同じである root 以外のアカウントについて、group の桁が書き換えられます。grep -rn pam_umask /etc/pam.d/ と id -un; id -gn を実行すると、これらのどれが自分のアカウントに適用されるかを確認できます。

umask によってファイルを実行可能にできますか?

いいえ。マスクができるのは、作成元のプログラムが要求したビットをクリアすることだけです。touch は execute ビットを要求しないため、どのマスクを指定しても実行可能ファイルにはなりません。使い捨てのディレクトリで ( umask a=rwx; touch f; stat -c '%a %A' f ) を実行して確認できます。execute ビットを付けるには chmod が必要です。または、作成時にそのビットを要求する install -m などのプログラムを使用します。

systemd サービスの umask はどこで設定しますか?

unit の [Service] セクションで UMask= を指定します。サービスは login ではなく service manager によって起動されるため、shell の起動ファイルは読み込まれず、pam_umask も実行されません。systemctl daemon-reload を実行して unit を再起動した後、外部から確認します。サービスにファイルを作成させ、その結果を stat -c '%a %n' で読み取ります。

group write を許可するデフォルトマスクは安全ですか?

group のメンバーがちょうど 1 人である間は安全です。これは user private group 方式の前提です。その group に 2 人目のアカウントを追加すると、最初のアカウントが作成したすべてのファイルが、ファイルに対してコマンドを実行しなくても、追加したメンバーによって直ちに書き込み可能になります。id -un と id -gn を実行してください。同じ名前が表示されれば、private group を使用しています。複数のアカウントで group を共有する場合は、group write ビットをクリアするマスクを設定します。その後ファイルを作成し、stat -c '%a %n' を読み取って変更が反映されたことを確認します。

この記事は役に立ちましたか?

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