umask 如何決定 Linux 新檔案的預設權限
umask 只會清除新檔案的權限位元,不會授予權限。使用 umask、touch、mkdir 與 stat 實測,了解檔案與目錄模式為何不同,以及 root 與一般使用者為何可能不同。
Linux 上 umask 的作用
umask 是 Linux 中每個程序都帶有的數值,用來決定該程序建立的每個檔案與目錄的模式。程式在建立物件時,會向核心要求一組權限。核心會清除遮罩所指定的每個位元,並套用剩餘的權限。umask 絕不會授予存取權限,只會從建立程式要求的權限中移除位元。核心文件說明了一項例外:如果父目錄具有預設 ACL,核心會忽略 umask,改套用繼承的 ACL。
這個值不是發行版的屬性,而取決於目前使用的帳號以及 shell 的啟動方式。在同一台機器、同一時間,使用標準映像時,這兩項條件仍可能產生不同結果。因此,第一步不是查閱手冊,而是在目前這台主機上直接測量。
在目前所在的 shell 中顯示 umask
umask
umask -S第一種形式會以八進位顯示遮罩。第二種形式會以該遮罩允許的權限顯示,格式與 chmod 接受的符號表示法相同。保留這兩行在畫面上。以下內容都會與 shell 剛才顯示的結果比較。
umask 是 shell builtin,不是磁碟上的程式。使用 type umask 確認這點。這一點很重要,因為 builtin 會直接變更 shell 程序本身。獨立程式只能變更自己的程序,之後結束並帶走該變更。
建立檔案與目錄,然後讀回其模式
cd "$(mktemp -d)"
touch probe.file
mkdir probe.dir
stat -c '%a %A %n' probe.file probe.dir%a 會以八進位格式輸出模式,而 %A 會以 ls -l 所使用的 drwxr-xr-x 格式輸出相同模式。將這兩行分別與剛才輸出的遮罩比較。遮罩中設定的每個位元都會從模式中缺少,因為遮罩唯一會做的事就是清除這些位元。若 %A 欄位目前仍不易讀懂,請先弄清楚 drwxr-xr-x 權限字串 的意義。
檔案與目錄彼此不同,而這項差異不是由遮罩造成的。touch 向 kernel 要求 owner、group 與 other 的讀取和寫入權限。mkdir 則向三者要求讀取、寫入與執行權限。相同的遮罩會從兩個不同的要求中扣除。因此,touch 建立的檔案永遠不會具備可執行權限,不論遮罩的內容為何:因為從未要求執行位元,而遮罩無法把位元加回去。
( umask a=rwx; touch open.file; stat -c '%a %A %n' open.file )這些括號會在 subshell 中執行命令,因此變更會隨 subshell 結束而消失。現在遮罩不要求清除任何位元,而 stat 仍會回報檔案沒有執行位元。之後再次執行 umask,原始值就會恢復,這表示此設定存在於 process 內,並由子 process 繼承,而不是儲存在磁碟上。
執行位元遭清除時,目錄最能明顯看出影響。
( umask a=rw; mkdir noexec.dir; cd noexec.dir )以一般使用者身分執行時,cd 會因 bash: cd: noexec.dir: Permission denied 而失敗,因為遮罩清除了 mkdir 所要求的執行位元,而沒有執行位元的目錄無法進入。root 會略過這項檢查,因此這個問題只會在一般帳號上顯現。
為什麼 root 與你自己的使用者看到不同的 umask
透過另一個帳號,並以不同方式啟動相同的測量,然後將兩個輸出並列比較。
umask
sudo -i umasksudo -i 會啟動 root 的登入 shell,並在其中執行內建指令。因此,這是另一個帳號透過不同啟動路徑進入系統。在原始的 Ubuntu 與 Debian server 映像檔上,這兩行可能會輸出不同值。兩行都正確。每一行都顯示其自身啟動路徑產生的結果;本文接下來將說明這個結果是由系統的哪個部分產生。
哪個映像檔中的檔案決定了這個值
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 沒有輸出,請移除 ^ anchor 後再執行一次:該行可能被註解掉,而註解行屬於說明文件,不是設定。第三個 grep 才是最容易讓人意外的部分。在 Debian 和 Ubuntu 中,隨附的 /etc/profile 通常會指向 PAM,而不是自行設定 mask,因此你原本以為負責此設定的檔案,往往並不是實際來源。grep 找不到相符內容時會以非零狀態結束,這就是該行最後加上 || echo 的原因:如果映像檔中的啟動檔案都沒有提及 mask,你會看到訊息而不是沒有任何輸出,而這則訊息就是要找的結果。
/etc/login.defs 宣告一個值,PAM 套用另一個值
/etc/login.defs 中的 UMASK 行是多數指南引用的值。kernel 和 shell 都不會讀取該檔案。該檔案由 pam_umask 讀取;這是一個在建立 session 時執行的 PAM(可插拔驗證模組)模組。pam_umask 會採用找到的第一個值:使用者 GECOS 欄位中的 umask= 項目、直接寫在 pam_umask.so 行上的 umask= 引數、/etc/login.defs 中的 UMASK,最後是 /etc/default/login 中的 UMASK= 項目。各發行版可能會修補此模組,因此請在自己的 image 上執行 man pam_umask,並查看其中列出的順序。
因此,/etc/login.defs 可以宣告一個值,但你的 session 最後套用另一個值,兩邊都不會顯示警告。這些 grep 結果會告訴你目前屬於哪種情況。如果 pam_umask.so 行本身帶有 umask= 引數,login.defs 行中的設定就不會生效。
USERGROUPS_ENAB 與 root 例外
id -un
id -gn如果這兩個指令輸出相同的名稱,表示你使用的是使用者私有群組:建立該帳號時,同時建立了以帳號名稱命名的專屬群組。USERGROUPS_ENAB 在 /etc/login.defs 中的設定,會讓 useradd 預設建立該群組。pam_umask 也有對應的 usergroups 行為。在上游模組中,可在 pam_umask.so 行加入 usergroups 引數啟用,或由建置時的預設值啟用;nousergroups 則會將其關閉。Ubuntu 在 2011 年修補該模組,改為讀取 USERGROUPS_ENAB,因此請先閱讀該行上方的註解,並在自己的映像檔中確認 man pam_umask。啟用此行為時,只要帳號不是 root,且主要群組名稱與使用者名稱相同,模組就會將遮罩中的擁有者位元複製到群組位元。工作階段結束時,遮罩會讓該帳號建立的所有項目保留開放的群組位元。模組本身會排除 root;這項排除是同一台伺服器上兩個 shell 輸出不同遮罩時,最常見的單一原因。
這項規則的理由是,私有群組只有一名成員,因此群組可寫入就等同於擁有者可寫入,除此之外沒有其他差異。只要有人將第二名成員加入該群組,這項假設就不再成立。從那一刻起,該帳號過去建立的每個檔案都能由新成員寫入,而且不需要對這些檔案執行任何命令即可生效。請為每項服務指定 專用的最小權限使用者帳號,讓該群組刻意維持只有一名成員。
登入 shell、非登入 shell 與非互動式 shell
umask
bash -lc 'umask'
bash -c 'umask'建立工作階段時,PAM 會執行:在主控台上執行 login、sshd、su、sudo -i。一個 shell 啟動另一個 shell 時,PAM 不會執行。bash -l 是登入 shell,因此會讀取 /etc/profile 與 ~/.profile,但不會呼叫 pam_umask,因為這次沒有建立工作階段。bash -c 不會讀取這兩個檔案,而是繼承啟動它的程序所使用的 mask。git hook 與服務管理器啟動的程式都屬於最後一種情況,因此它們使用的 mask 取決於父程序。Cron 同樣不會讀取任何 shell 啟動檔案;但在 Debian 上,其 PAM 設定檔包含 common-session-noninteractive,會載入 pam_umask,因此每個工作都會取得工作階段原本會取得的 PAM 值。
因此,「我已在 /etc/profile 中設定,但服務寫入的 mode 仍然錯誤」是很常見的問題回報。這個服務根本沒有讀取該檔案。
設定位置:確保設定在重新啟動後仍然生效
請在工作負載實際啟動的位置設定 umask,因為每個啟動途徑讀取的檔案不同。
- 對於登入系統的帳戶:在
/etc/login.defs中設定UMASK,由 pam_umask 套用至機器上的每個工作階段。這是整台機器的設定,因此會同時影響所有帳戶。 - 對於單一帳戶:
pam_umask.so行中的umask=引數同樣是整台機器的設定,因此個別使用者的值應放在該使用者的 GECOS 欄位中;登入 shell 使用~/.profile,互動式 shell 使用~/.bashrc。 - 對於由 systemd 管理的 daemon:在 unit 的
[Service]區段中設定UMask=。unit 由 service manager 啟動,因此不會讀取/etc/profile,pam_umask 也不會執行。在這些設定中,只有 unit file 的設定會套用至 daemon。 - 對於由 cron 或 hook 啟動的 script:在第一行明確設定
umask,而且要先於 script 建立任何檔案。
[Service]
UMask=<the octal mask you chose>接著,從相同啟動途徑重新啟動後進行驗證,不要使用編輯檔案時所在的 shell。當前 shell 已經保存自己的 umask;編輯設定檔不會回溯套用至正在執行的 process。
bash -lc 'umask'
sudo -i umask為何事後執行 chmod 並不能解決相同問題
chmod會修正已存在的檔案。mask 會決定尚未建立之檔案的模式。對目錄執行 chmod -R 後,服務下次寫入的檔案仍會再次使用舊模式,因為該模式來自建立檔案的程序;修改目錄模式並不會改變這一點。
此外,中間還存在一段時間窗口。檔案建立後、chmod 執行前,檔案會以較寬鬆的模式留在磁碟上,任何能讀取該目錄的程序都可以開啟它。對私密金鑰或備份封存檔而言,這段時間正是你試圖消除的風險。
應改為在建立時設定模式。install -m u=rw,go= newfile /etc/app/newfile 會以明確模式建立目的地,mkdir -m 對目錄也採用相同方式。兩者都會使用你指定的模式,並忽略 mask。ssh-keygen 會設定它寫入之私密金鑰的模式,因此在其他檔案都不正確的主機上,該檔案通常仍會符合要求。
SSH 通常最容易受到影響。使用普通的 mkdir 建立的 ~/.ssh,或使用 cat >> 附加的 authorized_keys,會採用 shell 的 mask。啟用 StrictModes 後,sshd 會拒絕從群組可寫入的目錄讀取金鑰檔案。用戶端會收到 Permission denied (publickey),而伺服器的 /var/log/auth.log 則會記錄實際原因:
Authentication refused: bad ownership or modes for directory /home/deploy/.ssh這項檢查是刻意設計的,而 強化 VPS 上的 SSH 安全性 取決於它正常運作。在新伺服器上建立將使用 SSH 的帳戶前,應先測量 mask,並一併參考 新 VPS 上線後的前 10 分鐘;之後,再透過這些帳戶會使用的每條路徑重新測量。mask 隸屬於各個程序,而不是伺服器,因此單次讀值無法代表所有帳戶。
複製與封存作業會忽略遮罩
cp -p 和 rsync -a 會還原來源檔案所記錄的模式,因此遮罩不會影響結果。tar 在以 root 身分解壓縮時也會採用相同方式;一般使用者搭配 -p 時亦然。從備份還原的檔案會保留建立備份時的模式。下結論認為正確的遮罩遭到忽略前,請先確認這點:對於還原的資料,系統從未查詢遮罩。另一種情況是父目錄上的預設 ACL 會使正確的遮罩不再生效;在該目錄上執行 getfacl -d 即可查看預設 ACL。
FAQ
為什麼 cron 工作建立的檔案模式,與我的 ssh 工作階段不同?
cron 不會讀取 /etc/profile 或 ~/.profile,因此,若遮罩設定在 shell 啟動檔中,該設定不會套用到 cron。Debian 上的 cron 會透過 common-session-noninteractive 開啟 PAM 工作階段,其中包含 pam_umask,因此工作會取得 PAM 的值。如果 cron 的 PAM 堆疊沒有 pam_umask,工作就會繼承 cron daemon 的遮罩。在指令碼第一行加入明確的 umask,並且要放在建立任何檔案之前;再從工作內部輸出一次遮罩值,這樣才能確認該工作實際取得的設定,而不是目前 shell 的設定。
為什麼 /etc/login.defs 的設定與 shell 輸出的結果不同?
UMASK 位於 /etc/login.defs 中時,只是 pam_umask 的後援設定。該模組會優先使用使用者 GECOS 欄位中的 umask= 設定,接著使用 umask= 在 pam_umask.so 行的參數,而該行位於 /etc/pam.d/。之後,模組的 usergroups 參數,或是在經過修補、可讀取該設定的版本中由 USERGROUPS_ENAB 啟用的 usergroups 行為,會改寫所有非 root 帳戶的群組位元;條件是其主要群組名稱與該帳戶相同。執行 grep -rn pam_umask /etc/pam.d/ 和 id -un; id -gn,即可確認哪些設定套用到您的帳戶。
umask 能讓檔案具備執行權限嗎?
不能。遮罩只能清除建立程式要求的權限位元。touch 從不要求執行位元,因此任何遮罩都無法產生可執行檔案。請在暫存目錄中使用 ( umask a=rwx; touch f; stat -c '%a %A' f ) 進行確認。若要加入執行位元,必須使用 chmod,或使用建立檔案時會要求該權限的程式,例如 install -m。
systemd 服務的 umask 應在哪裡設定?
在 unit 的 [Service] 區段中設定 UMask=。服務是由服務管理器啟動,而不是由登入程序啟動,因此不會讀取 shell 啟動檔,也不會執行 pam_umask。執行 systemctl daemon-reload 並重新啟動該 unit 後,從外部確認結果:讓服務建立檔案,再使用 stat -c '%a %n' 讀取結果。
預設遮罩允許群組寫入,是否安全?
當群組只有一名成員時是安全的,這也是 user private group 配置的前提。若將第二個帳戶加入該群組,第一個帳戶建立的每個檔案會立即對新成員開放寫入權限,而且不需要對這些檔案執行任何指令。執行 id -un 和 id -gn:若兩者輸出相同名稱,表示您使用的是 private group。如果多個帳戶共用同一個群組,請設定會清除群組寫入位元的遮罩,然後建立檔案並讀取 stat -c '%a %n',以確認變更已生效。