SSD Nodes Learn Hosting plans →
راهنماها Matt Connorتوسط Matt Connor · به‌روزرسانی شده 2026-10-14

آموزش تنظیم و درک umask در لینوکس

دستور umask بیت‌های مجوز فایل‌های جدید را حذف می‌کند. با اجرای دستورات umask و ls -l تفاوت دسترسی‌های کاربر و root را بررسی کنید و نحوه محاسبه دقیق مجوزها را بیاموزید.

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

عملکرد umask در لینوکس

مقدار umask عددی است که هر پردازش در لینوکس به همراه دارد و تعیین‌کننده سطح دسترسی (mode) فایل‌ها و دایرکتوری‌هایی است که آن پردازش ایجاد می‌کند. هر برنامه هنگام ایجاد یک فایل، مجموعه‌ای از مجوزها را از هسته (kernel) درخواست می‌کند. هسته تمام بیت‌هایی که در mask نام برده شده‌اند را پاک کرده و باقی‌مانده را اعمال می‌کند. umask هرگز دسترسی جدیدی اعطا نمی‌کند؛ بلکه تنها بیت‌هایی را از درخواست برنامه حذف می‌کند. هسته یک استثنا را مستند کرده است: اگر دایرکتوری والد دارای یک ACL پیش‌فرض باشد، mask نادیده گرفته شده و ACL به ارث رسیده اعمال می‌شود.

این مقدار ویژگی توزیع (distribution) شما نیست. این مقدار به حسابی که با آن وارد شده‌اید و نحوه شروع shell بستگی دارد. این دو پاسخ می‌توانند روی یک ماشین، در یک لحظه و روی یک image استاندارد متفاوت باشند. بنابراین گام نخست، جستجو در دفترچه راهنما نیست؛ بلکه اندازه‌گیری آن روی سیستمی است که در مقابل شما قرار دارد.

نمایش umask در شل فعلی

umask
umask -S

شکل اول، ماسک را به صورت اکتال (octal) نمایش می‌دهد. شکل دوم، همان ماسک را به صورت مجوزهای مجاز و با فرمت نمادینی که chmod می‌پذیرد، چاپ می‌کند. هر دو خط را روی صفحه نگه دارید. تمام موارد زیر، مقایسه‌ای با خروجی شل شماست.

umask یک دستور داخلی (builtin) شل است و یک برنامه روی دیسک نیست. این موضوع را با type umask تأیید کنید. این نکته اهمیت دارد، زیرا یک دستور داخلی، خودِ پردازش شل را تغییر می‌دهد. یک برنامه مجزا فقط می‌تواند پردازش خودش را تغییر دهد و پس از خروج، آن تغییرات نیز از بین می‌روند.

ایجاد یک فایل و یک دایرکتوری، سپس خواندن مجوزها

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

%a مجوز را به صورت اکتال چاپ می‌کند و %A همان مجوز را در قالب drwxr-xr-x که ls -l از آن استفاده می‌کند، نمایش می‌دهد. هر دو خروجی را با ماسکی که لحظاتی پیش چاپ کردید مقایسه کنید. هر بیتی که در ماسک تنظیم شده باشد، در مجوزها وجود ندارد، زیرا تنها کار ماسک، حذف کردن آن بیت‌ها است. اگر خواندن ستون %A هنوز دشوار است، ابتدا رشته مجوز drwxr-xr-x را به درستی درک کنید.

فایل و دایرکتوری با یکدیگر تفاوت دارند و دلیل این تفاوت، ماسک نیست. touch از هسته درخواست دسترسی خواندن و نوشتن برای مالک، گروه و دیگران می‌کند. mkdir درخواست خواندن، نوشتن و اجرا برای هر سه گروه را دارد. همان ماسک از دو درخواست متفاوت کسر می‌شود. بنابراین فایلی که با touch ایجاد شده است، هرگز قابل اجرا نیست، صرف‌نظر از اینکه ماسک چه مقداری دارد: بیت اجرا هرگز درخواست نشده است و ماسک نمی‌تواند بیتی را اضافه کند.

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

آن پرانتزها دستورات را در یک subshell اجرا می‌کنند، بنابراین تغییرات پس از پایان آن از بین می‌روند. ماسک اکنون درخواست می‌کند که هیچ بیتی حذف نشود، اما stat همچنان گزارش می‌دهد که بیت اجرا روی فایل وجود ندارد. پس از آن دوباره umask را اجرا کنید تا مقدار اصلی بازگردد؛ این نشان می‌دهد که این تنظیمات درون یک پردازش (process) قرار دارد و توسط فرزندان به ارث می‌رسد، نه اینکه در جایی روی دیسک ذخیره شود.

دایرکتوری‌ها جایی هستند که حذف بیت اجرا در آن‌ها محسوس است.

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

به عنوان یک کاربر عادی، دستور cd با خطای bash: cd: noexec.dir: Permission denied مواجه می‌شود، زیرا ماسک، بیت اجرایی که mkdir درخواست کرده بود را حذف کرده است و دایرکتوری بدون بیت اجرا قابل ورود نیست. کاربر root این بررسی را نادیده می‌گیرد، بنابراین این مورد فقط در حساب‌های کاربری عادی خود را نشان می‌دهد.

چرا root و کاربر شما umask متفاوتی می‌بینند

همان اندازه‌گیری را با یک حساب کاربری دیگر که به روش متفاوتی شروع شده است اجرا کنید و خروجی هر دو را کنار هم قرار دهید.

umask
sudo -i umask

sudo -i شل ورود (login shell) کاربر root را شروع کرده و دستور داخلی را درون آن اجرا می‌کند، بنابراین این یک حساب کاربری متفاوت است که از مسیر راه‌اندازی متفاوتی وارد شده است. در ایمیج‌های پیش‌فرض سرور Ubuntu و Debian، این دو خط ممکن است مقادیر متفاوتی را چاپ کنند. هر دو خط صحیح هستند. هر کدام نشان می‌دهد که مسیر راه‌اندازی مربوط به خودش چه مقداری تولید کرده است، و ادامه این مطلب درباره این است که کدام بخش از سیستم این مقدار را تولید کرده است.

کدام فایل در image شما مقدار را تعیین کرده است

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 ختم می‌شود: در imageای که هیچ فایل startupای به mask اشاره نمی‌کند، به جای سکوت، پیام دریافت می‌کنید و همان پیام، یافتهٔ شماست.

فایل /etc/login.defs یک مقدار را تبلیغ می‌کند و PAM مقدار دیگری را اعمال می‌نماید

خط UMASK در /etc/login.defs مقداری است که اکثر راهنماها به آن استناد می‌کنند. نه هسته و نه shell، این فایل را نمی‌خوانند. این فایل توسط pam_umask خوانده می‌شود؛ یک ماژول PAM (ماژول‌های احراز هویت قابل اتصال) که هنگام ایجاد نشست (session) اجرا می‌گردد. ماژول pam_umask اولین مقداری را که پیدا کند اعمال می‌کند: ابتدا ورودی umask= در فیلد GECOS کاربر، سپس آرگومان umask= که مستقیماً در خط pam_umask.so نوشته شده، سپس UMASK از /etc/login.defs، و در نهایت ورودی UMASK= در /etc/default/login. توزیع‌های مختلف این ماژول را وصله (patch) می‌کنند، بنابراین دستور man pam_umask را روی ایمیج خود اجرا کنید و ترتیب چاپ‌شده در آن را بخوانید.

به همین دلیل است که /etc/login.defs می‌تواند یک مقدار را تبلیغ کند در حالی که نشست شما با مقدار دیگری پایان می‌یابد، بدون آنکه هشداری در هیچ‌کدام از طرفین چاپ شود. دستورات grep به شما می‌گویند در کدام حالت قرار دارید. اگر خط pam_umask.so دارای آرگومان umask= اختصاصی خود باشد، مقدار موجود در login.defs نادیده گرفته می‌شود.

USERGROUPS_ENAB و استثنای root

id -un
id -gn

اگر این دو دستور نام یکسانی را چاپ کنند، شما یک گروه خصوصی کاربری (user private group) دارید: حساب کاربری با گروهی مختص به خود ایجاد شده است که نام آن با نام حساب یکی است. مقدار USERGROUPS_ENAB در فایل /etc/login.defs همان چیزی است که باعث می‌شود useradd به‌طور پیش‌فرض آن گروه را ایجاد کند. ماژول pam_umask نیز رفتار مشابهی برای usergroups دارد. در ماژول اصلی (upstream)، این قابلیت با آرگومان usergroups در خط pam_umask.so یا از طریق تنظیمات پیش‌فرض زمان کامپایل فعال می‌شود و nousergroups آن را غیرفعال می‌کند. اوبونتو در سال 2011 این ماژول را پچ کرد تا به‌جای آن USERGROUPS_ENAB را بخواند؛ بنابراین توضیحات بالای آن خط را بخوانید و man pam_umask را در ایمیج خود بررسی کنید. هنگامی که این رفتار فعال است و حساب کاربری root نیست و نام گروه اصلی با نام کاربر مطابقت دارد، ماژول رقم مالک (owner digit) را از mask کپی کرده و در رقم گروه (group digit) قرار می‌دهد. در نتیجه، نشست (session) با maskای پایان می‌یابد که بیت‌های گروه را برای هر فایلی که آن حساب ایجاد می‌کند، باز می‌گذارد. حساب root توسط خود ماژول مستثنی شده است و همین استثنا، رایج‌ترین دلیل برای این است که دو shell روی یک سرور، maskهای متفاوتی را چاپ کنند.

دلیل این قاعده آن است که یک گروه خصوصی دقیقاً یک عضو دارد، بنابراین «قابل‌نوشتن توسط گروه» به معنای «قابل‌نوشتن توسط مالک» است و چیزی فراتر از آن نیست. این وضعیت تا زمانی برقرار است که فردی عضو دومی به گروه اضافه کند. از آن لحظه به بعد، هر فایلی که آن حساب تا به حال ایجاد کرده است، توسط عضو جدید قابل‌نوشتن خواهد بود، بدون اینکه دستوری روی آن فایل‌ها برای ایجاد این دسترسی اجرا شده باشد. برای هر سرویس حساب کاربری اختصاصی با حداقل دسترسی در نظر بگیرید تا آن گروه به‌صورت هدفمند، گروهی تک‌عضو باقی بماند.

Login shell، non-login shell و non-interactive shell

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

ماژول PAM زمانی اجرا می‌شود که یک نشست (session) ایجاد شود: login در کنسول، sshd، su، sudo -i. این ماژول هنگام اجرای یک shell توسط shell دیگر اجرا نمی‌شود. bash -l یک login shell است، بنابراین فایل‌های /etc/profile و ~/.profile را می‌خواند، اما هرگز pam_umask را فراخوانی نمی‌کند، زیرا نشستی ایجاد نشده است. bash -c هیچ‌کدام از این فایل‌ها را نمی‌خواند و mask فرآیندی که آن را شروع کرده است، به ارث می‌برد. یک git hook و برنامه‌ای که توسط یک service manager شروع شده باشد، در این دسته آخر قرار می‌گیرند، بنابراین mask آن‌ها همان مقداری است که فرآیند والدشان داشته است. Cron نیز هیچ‌کدام از فایل‌های startup مربوط به shell را نمی‌خواند، اما در Debian فایل PAM آن شامل common-session-noninteractive است که pam_umask را بارگذاری می‌کند، بنابراین هر job مقداری را دریافت می‌کند که یک نشست (session) از PAM می‌گرفت.

به همین دلیل است که گزارش «من آن را در /etc/profile تنظیم کردم اما سرویس همچنان با دسترسی اشتباه می‌نویسد» بسیار رایج است. سرویس هرگز آن فایل را نخوانده است.

کجا تنظیم کنیم تا پس از راه‌اندازی مجدد باقی بماند

mask را در جایی تنظیم کنید که workload واقعاً شروع می‌شود، زیرا هر مسیر شروع، فایل متفاوتی را می‌خواند.

  1. برای حساب‌هایی که وارد سیستم می‌شوند: UMASK در /etc/login.defs، که توسط pam_umask برای هر نشست روی دستگاه اعمال می‌شود. این تنظیم در سطح کل دستگاه است، بنابراین تمام حساب‌ها را هم‌زمان تغییر می‌دهد.
  2. برای یک حساب کاربری: آرگومان umask= در خط pam_umask.so نیز در سطح کل دستگاه است، بنابراین مقدار مختص به یک کاربر باید در فیلد GECOS همان کاربر، یا در ~/.profile برای shellهای ورود و ~/.bashrc برای shellهای تعاملی قرار گیرد.
  3. برای یک daemon تحت systemd: UMask= در بخش [Service] مربوط به unit. یک unit توسط service manager شروع می‌شود، بنابراین /etc/profile هرگز خوانده نمی‌شود و pam_umask هرگز اجرا نمی‌گردد. فایل unit تنها موردی از این فهرست است که بر daemon تأثیر می‌گذارد.
  4. برای اسکریپتی که توسط cron یا یک hook شروع می‌شود: یک دستور umask صریح در خط اول، پیش از آنکه اسکریپت فایلی ایجاد کند.
[Service]
UMask=<the octal mask you chose>

سپس از یک شروع تازه در همان مسیر تأیید کنید، و هرگز از shellای که فایل را در آن ویرایش کرده‌اید، تست نگیرید. shell فعلی شما mask خود را از قبل در حافظه دارد و ویرایش یک فایل پیکربندی، تأثیری بر پردازش‌های در حال اجرا نمی‌گذارد.

bash -lc 'umask'
sudo -i umask

چرا اجرای chmod پس از ایجاد فایل، راه‌حل یکسانی نیست

chmod فایل‌های موجود را اصلاح می‌کند. اما umask تعیین‌کننده سطح دسترسی فایل‌هایی است که هنوز ایجاد نشده‌اند. اگر chmod -R را روی یک دایرکتوری اجرا کنید، فایل بعدی که سرویس می‌نویسد دوباره با همان سطح دسترسی قدیمی ایجاد می‌شود؛ زیرا آن سطح دسترسی از فرآیند ایجادکننده فایل نشأت می‌گیرد و تغییر سطح دسترسی دایرکتوری تأثیری بر آن ندارد.

علاوه بر این، یک بازه زمانی آسیب‌پذیر وجود دارد. از لحظه ایجاد فایل تا لحظه‌ای که chmod اجرا می‌شود، فایل با سطح دسترسی بازتر روی دیسک قرار دارد و هر فرآیندی که به دایرکتوری دسترسی خواندن داشته باشد، می‌تواند آن را باز کند. برای یک کلید خصوصی یا آرشیو پشتیبان، این بازه زمانی همان ریسکی است که قصد حذف آن را داشتید.

سطح دسترسی را در زمان ایجاد فایل تعیین کنید. install -m u=rw,go= newfile /etc/app/newfile فایل مقصد را با سطح دسترسی صریح می‌نویسد و mkdir -m همین کار را برای دایرکتوری انجام می‌دهد. هر دو دستور، سطح دسترسی تعیین‌شده توسط شما را اعمال کرده و umask را نادیده می‌گیرند. ssh-keygen سطح دسترسی را روی کلید خصوصی که می‌نویسد تنظیم می‌کند؛ به همین دلیل است که آن فایل خاص اغلب روی ماشینی که سایر فایل‌هایش مشکل دارند، درست عمل می‌کند.

قربانی معمول در این موارد SSH است. یک ~/.ssh که با یک mkdir ساده ساخته شده، یا یک authorized_keys که با cat >> به آن اضافه شده، از umask شل شما پیروی می‌کند. با فعال بودن StrictModes، سرویس sshd از خواندن فایل کلید از دایرکتوری که برای گروه قابل نوشتن است، خودداری می‌کند. به کلاینت پیام Permission denied (publickey) نمایش داده می‌شود، در حالی که /var/log/auth.log سرور علت واقعی را ثبت می‌کند:

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

این بررسی عمدی است و ایمن‌سازی SSH روی یک VPS به پایداری آن وابسته است. پیش از ایجاد حساب‌های کاربری که از آن استفاده می‌کنند، umask را روی سرور جدید اندازه بگیرید؛ این کار را در کنار ده دقیقه اول روی یک VPS جدید انجام دهید و سپس آن را در هر مسیری که آن حساب‌ها از آن شروع به کار می‌کنند، دوباره بررسی کنید. umask متعلق به هر فرآیند است، نه کل سرور؛ بنابراین یک بار خواندن آن برای همه حساب‌ها کافی نیست.

کپی‌ها و آرشیوها ماسک را نادیده می‌گیرند

cp -p و rsync -a همان حالتی (mode) را بازیابی می‌کنند که روی فایل مبدأ ثبت شده است، بنابراین ماسک هیچ تأثیری بر نتیجه ندارد. tar نیز هنگام استخراج به عنوان root، یا به عنوان یک کاربر عادی با استفاده از -p، همین کار را انجام می‌دهد. فایلی که از نسخه پشتیبان بازیابی می‌شود، حالتی را حفظ می‌کند که در زمان تهیه نسخه پشتیبان داشته است. پیش از آنکه نتیجه بگیرید ماسک صحیح نادیده گرفته شده است، این موضوع را بررسی کنید: برای داده‌های بازیابی‌شده، ماسک هرگز در نظر گرفته نشده است. جای دیگری که ماسک صحیح دیگر محاسبه نمی‌شود، وجود یک ACL پیش‌فرض روی دایرکتوری والد است که دستور getfacl -d روی آن دایرکتوری، آن را نمایش می‌دهد.

FAQ

چرا کرون‌جاب من فایل‌هایی با مجوز متفاوت نسبت به نشست ssh من ایجاد می‌کند؟

یک کرون‌جاب نه /etc/profile را می‌خواند و نه ~/.profile را، بنابراین mask تنظیم‌شده در فایل‌های راه‌انداز شل هرگز به آن نمی‌رسد. در دبیان، cron یک نشست PAM را از طریق common-session-noninteractive باز می‌کند که شامل pam_umask است، بنابراین جاب مقدار PAM را دریافت می‌کند. در مواردی که استک PAM مربوط به cron فاقد pam_umask باشد، جاب مقدار mask دیمون cron را به ارث می‌برد. یک دستور umask صریح در خط اول اسکریپت خود، پیش از ایجاد هر فایلی قرار دهید و mask را یک‌بار از داخل جاب چاپ کنید تا ببینید آن جاب واقعاً چه مقداری دارد، نه آنچه شل خودتان دارد.

چرا فایل /etc/login.defs یک چیز می‌گوید و شل من چیز دیگری چاپ می‌کند؟

مقدار UMASK در /etc/login.defs تنها یک جایگزین (fallback) برای pam_umask است. این ماژول ابتدا ورودی umask= در فیلد GECOS کاربر، سپس آرگومان umask= در خط pam_umask.so در فایل /etc/pam.d/ را اولویت می‌دهد. رفتار usergroups که توسط آرگومان usergroups ماژول یا در بیلد‌های پچ‌شده توسط USERGROUPS_ENAB فعال می‌شود، رقم گروه را برای هر حساب غیر-root که نام گروه اصلی‌اش با نام کاربری یکی است، بازنویسی می‌کند. دستورات grep -rn pam_umask /etc/pam.d/ و id -un; id -gn را اجرا کنید تا ببینید کدام‌یک از این موارد برای حساب شما اعمال می‌شود.

آیا umask می‌تواند یک فایل را قابل‌اجرا (executable) کند؟

خیر. mask فقط می‌تواند بیت‌ها را از آنچه برنامهٔ ایجادکننده درخواست کرده، حذف کند. دستور touch هرگز بیت اجرا را درخواست نمی‌کند، بنابراین هیچ maskای فایل قابل‌اجرا تولید نمی‌کند. این موضوع را در یک دایرکتوری موقت با ( umask a=rwx; touch f; stat -c '%a %A' f ) تأیید کنید. برای داشتن بیت اجرا، به chmod یا برنامه‌ای مانند install -m نیاز دارید که در زمان ایجاد فایل، آن را درخواست کند.

umask را برای یک سرویس systemd کجا تنظیم کنم؟

در فایل unit، با استفاده از UMask= در بخش [Service]. یک سرویس توسط مدیر سرویس (service manager) شروع می‌شود و نه توسط یک نشست ورود (login)، بنابراین فایل‌های راه‌انداز شل هرگز خوانده نمی‌شوند و pam_umask برای آن اجرا نمی‌شود. پس از systemctl daemon-reload و راه‌اندازی مجدد سرویس، از بیرون تأیید کنید: اجازه دهید سرویس فایلی ایجاد کند، سپس نتیجه را با stat -c '%a %n' بخوانید.

آیا mask پیش‌فرض با قابلیت نوشتن برای گروه (group-writable) امن است؟

این حالت تا زمانی که گروه دقیقاً یک عضو داشته باشد امن است؛ این همان فرضی است که پشت طرح «گروه خصوصی کاربر» (user private group) قرار دارد. اگر حساب دومی به آن گروه اضافه کنید، تمام فایل‌هایی که حساب اول ایجاد کرده، بلافاصله برای عضو جدید قابل‌نوشتن می‌شوند، بدون اینکه دستوری روی آن فایل‌ها اجرا شود. دستورات id -un و id -gn را اجرا کنید: چاپ شدن یک نام مشابه به این معنی است که شما در یک گروه خصوصی هستید. اگر گروهی را بین چند حساب به اشتراک می‌گذارید، maskای تنظیم کنید که بیت نوشتن گروه را حذف کند، سپس یک فایل ایجاد کرده و stat -c '%a %n' را بخوانید تا اثبات کنید تغییر اعمال شده است.

آیا این مقاله مفید بود؟

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