SSD Nodes Learn Hosting plans →
راهنماها Matt Connorتوسط Matt Connor

رفع خطای Permission denied (publickey) در SSH

خطای Permission denied (publickey) شامل 5 علت متفاوت است. با اجرای دستور ssh -v خروجی را تحلیل کنید تا بدون مسدود شدن دسترسی، مشکل دقیق را پیدا و آن را رفع کنید.

معنای واقعی خطای Permission denied (publickey)

خطای Permission denied (publickey) به این معناست که کلاینت شما یک یا چند کلید عمومی ارسال کرده و سرور هیچ‌کدام را نپذیرفته است. شبکه مشکلی ندارد و sshd در حال اجراست: این امتناع در آخرین مرحله احراز هویت رخ می‌دهد. اگر نشست شما پیش از این مرحله قطع می‌شود، با connection refused or connection timed out مواجه هستید که تشخیص و تست‌های متفاوتی دارد. برای رفع این مشکل هرگز حدس نزنید، زیرا ssh -v به شما می‌گوید که کدام‌یک از 5 علت ممکن عامل بروز مشکل است.

عبارات داخل پرانتز، روش‌هایی هستند که سرور مایل به پذیرش آن‌هاست. عبارت Permission denied (publickey) به تنهایی به این معناست که ورود با رمز عبور در آن سرور غیرفعال شده است، بنابراین هیچ رمز عبوری برای جایگزینی وجود ندارد. عبارت Permission denied (publickey,password) به این معناست که ورود با رمز عبور مجاز بوده و شما در آن روش نیز ناموفق بوده‌اید.

یک پیام واحد، پنج خطای مجزا را پوشش می‌دهد و این ابهام عمدی است. سروری که پاسخ دهد "کاربری وجود ندارد" یا "این کلید نصب نشده است"، به هر کسی که در حال اسکن حساب‌های معتبر باشد کمک می‌کند. بنابراین شروع به تعویض کلیدها و ویرایش فایل‌های پیکربندی نکنید. یک دستور را اجرا کنید، سه خط خروجی را بخوانید تا پنج علت احتمالی به یک مورد کاهش یابد.

ابتدا ssh -v را اجرا کنید و سه خط را بخوانید

دستوری که با خطا مواجه شد را دوباره با افزودن -v اجرا کنید:

ssh -v deploy@203.0.113.10

یک خروجی خلاصه اما واقعی به این شکل است:

OpenSSH_9.6p1 Ubuntu-3ubuntu13, OpenSSL 3.0.13 30 Jan 2024
debug1: Connecting to 203.0.113.10 [203.0.113.10] port 22.
debug1: Connection established.
debug1: Authenticating to 203.0.113.10:22 as 'deploy'
debug1: Authentications that can continue: publickey
debug1: Next authentication method: publickey
debug1: Will attempt key: /home/you/.ssh/id_ed25519 ED25519 SHA256:0eL/8sBw... agent
debug1: Offering public key: /home/you/.ssh/id_ed25519 ED25519 SHA256:0eL/8sBw... agent
debug1: Authentications that can continue: publickey
debug1: No more authentication methods to try.
deploy@203.0.113.10: Permission denied (publickey).

سه خط زیر حاوی تمام اطلاعات مورد نیاز شماست.

Authenticating to 203.0.113.10:22 as 'deploy' نام کاربری است که در نهایت استفاده خواهد شد. نه آن نامی که مد نظر شما بوده است: بلکه نامی که ssh از خط فرمان، از ~/.ssh/config یا از نام کاربری محلی شما استخراج کرده است.

Authentications that can continue: publickey لیست روش‌های پذیرفته‌شده توسط سرور است که پیش از تلاش برای استفاده از هر کلیدی ارسال می‌شود. اگر publickey در آن لیست اولیه وجود نداشته باشد، سرور ورود با کلید عمومی (public key) را غیرفعال کرده است، بنابراین هیچ کلیدی کار نخواهد کرد.

Offering public key: ... برای هر کلیدی که ssh نیمه عمومی آن را در اختیار دارد، درست پیش از ارائه آن کلید چاپ می‌شود و به دنبال آن نوع کلید و اثر انگشت SHA256 آن می‌آید. کلیدی که از یک فایل خوانده می‌شود، نام آن فایل را نمایش می‌دهد. کلیدی که فقط در ssh-agent وجود دارد، به جای مسیر، توضیحی که agent برای آن ذخیره کرده است را نشان می‌دهد و کلمه agent در انتهای خط، هر کلیدی که توسط agent ارائه شده باشد را مشخص می‌کند. ssh این خط را درست پیش از بررسی اینکه آیا هر دو طرف از یک الگوریتم امضا برای کلید استفاده می‌کنند یا خیر چاپ می‌کند، بنابراین اگر خط بعدی send_pubkey_test: no mutual signature algorithm باشد، آن کلید در نهایت ارسال نشده است (علت 5 این مورد را پوشش می‌دهد). کلیدی که ssh نتوانسته نیمه عمومی آن را از قبل بخواند، هرگز خط Offering را دریافت نمی‌کند: ssh عبارت Trying private key: ... را فقط با نام فایل ثبت می‌کند، کلید خصوصی را بارگذاری کرده و بلافاصله یک درخواست امضا شده ارسال می‌کند. کلیدی که هیچ‌کدام از این دو خط را نداشته باشد، هرگز به سرور ارسال نشده است.

اکنون مشکل را به دو بخش تقسیم کنید:

  • هیچ خط Offering public key یا Trying private key برای کلیدی که انتظار دارید وجود ندارد. خطا در دستگاه شماست، زیرا سرور کلید شما را اصلاً دریافت نکرده است.
  • کلید ارائه می‌شود و دوباره Authentications that can continue: publickey بازمی‌گردد. سرور آن کلید را دریافت کرده و رد کرده است، بنابراین خطا در سمت سرور است.

علل ذکر شده در ادامه، بر اساس میزان تکرار و احتمال وقوع مرتب شده‌اند.

دلیل 1: اتصال با نام کاربری اشتباه

رایج‌ترین دلیل، کم‌اهمیت‌ترین آن‌ها نیز هست. سرویس sshd (دیمون SSH)، هرگز به شما نمی‌گوید که یک حساب کاربری وجود ندارد. این سرویس کل فرآیند تبادل را برای یک نام کاربری ساختگی انجام می‌دهد و در نهایت با همان پیام خطا درخواست را رد می‌کند، زیرا افشای نام‌های کاربری معتبر به مهاجم کمک می‌کند. یک غلط تایپی در نام کاربری، دقیقاً مشابه یک کلید خراب به نظر می‌رسد.

پیش از هر چیز، خط Authenticating to ... as را بررسی کنید. اگر این خط به جای حساب کاربری سرور، نام کاربری لپ‌تاپ شما را نشان می‌دهد، یعنی نام کاربری را در دستور وارد نکرده‌اید.

ssh -v deploy@203.0.113.10
ssh -v root@203.0.113.10

حساب کاربری پیش‌فرض به ایمیجی بستگی دارد که ارائه‌دهندهٔ شما می‌سازد. تا اوت 2026، ایمیج‌های ابری Ubuntu معمولاً با حساب ubuntu عرضه می‌شوند، ایمیج‌های Debian با debian یا admin، ایمیج‌های Rocky Linux و AlmaLinux با rocky و almalinux، و بسیاری از ارائه‌دهندگان VPS کلید شما را مستقیماً در root نصب می‌کنند. کنترل پنل ارائه‌دهندهٔ شما ثبت می‌کند که کدام حساب را ایجاد کرده است. هیچ دستوری که از خارج سرور اجرا شود نمی‌تواند این موضوع را بپرسد.

یک بلوک Host در ~/.ssh/config نیز نام کاربری را تعیین می‌کند و اولویت آن از نام کاربری محلی شما بالاتر است:

Host vps-prod
  HostName 203.0.113.10
  User deploy

اگر حساب کاربری را خودتان ایجاد کرده‌اید و سپس نتوانستید با آن وارد شوید، احتمالاً کلید برای کاربر پیش‌فرض ایمیج نصب شده و هرگز به حساب جدید منتقل نشده است. این مرحله بخشی از ده دقیقه اول در یک VPS جدید است و به‌راحتی ممکن است فراموش شود.

دلیل 2: کلیدی که فکر می‌کنید در حال ارسال آن هستید، همان کلیدی نیست که ارسال می‌شود

به‌صورت پیش‌فرض، ssh فقط کلیدهای موجود در ssh-agent و مجموعه‌ای ثابت از نام‌فایل‌ها در ~/.ssh را ارائه می‌دهد: id_rsa، id_ecdsa، id_ed25519، انواع کلیدهای سخت‌افزاری id_ecdsa_sk و id_ed25519_sk، و کلیدهای ترکیبی پساکوانتومی id_mldsa44_ed25519. نسخه‌های فعلی OpenSSH هیچ پشتیبانی از DSA ندارند (OpenSSH 10.0 در آوریل 2025 آن را حذف کرد)، بنابراین یک فایل قدیمی id_dsa هرگز امتحان نمی‌شود. کلیدی که با نام ~/.ssh/vps-prod ذخیره شده باشد تا زمانی که آن را نام‌گذاری نکنید برای ssh نامرئی است؛ به همین دلیل است که خروجی verbose هیچ خط Offering public key برای آن نشان نمی‌دهد.

فایل را نام‌گذاری کنید و از جایگزینی آن توسط کلیدهای agent جلوگیری کنید:

ssh -i ~/.ssh/vps-prod -o IdentitiesOnly=yes deploy@203.0.113.10

استفاده از -i به‌تنهایی کافی نیست، زیرا وقتی agent کلیدهایی را در اختیار دارد، ssh همچنان کلیدهای agent را در اولویت قرار داده و فایل نام‌گذاری‌شده را در آخر ارسال می‌کند. این موضوع اهمیت دارد، زیرا سروری که OpenSSH قدیمی‌تر از 10.6 را اجرا می‌کند، هر کلید ردشده را در شمارش MaxAuthTries لحاظ می‌کند که مقدار پیش‌فرض آن 6 است. یک agent که هفت کلید در خود دارد، می‌تواند پیش از رسیدن به کلید صحیح شما، این حد مجاز را پر کند. OpenSSH 10.6 که در 6 اکتبر 2026 منتشر شد، کلمه کلیدی max-pk-ok را به گزینه موجود در sshd یعنی PubkeyAuthOptions اضافه کرد که به‌صورت PubkeyAuthOptions max-pk-ok:6 نوشته می‌شود. این قابلیت به سرور اجازه می‌دهد تا تعداد مشخصی از کلیدهای ارائه‌شده (به‌صورت پیش‌فرض 6 عدد) را بررسی کند، پیش از آنکه کلیدهای بعدی در شمارش MaxAuthTries لحاظ شوند. این کار سقف مجاز را بالا می‌برد اما آن را حذف نمی‌کند. وقتی به این حد برسید، پیام خطا به شکل زیر تغییر می‌کند:

Received disconnect from 203.0.113.10 port 22:2: Too many authentication failures

اگر پیامی که مشاهده می‌کنید این است، سرور نشست را پیش از رسیدن به کلید صحیح شما قطع کرده است که موضوع تعداد بیش از حد خطاهای احراز هویت به آن می‌پردازد. IdentitiesOnly=yes تلاش را فقط به فایلی که مشخص کرده‌اید محدود می‌کند. با استفاده از ssh-add -l لیست کلیدهای موجود در agent را ببینید و اگر سال‌ها کلید قدیمی در آن جمع شده است، با ssh-add -D آن را پاک‌سازی کنید. سپس تنظیمات را یادداشت کنید تا ورود بعدی وابسته به به‌خاطر سپردن فلگ‌ها نباشد:

Host vps-prod
  HostName 203.0.113.10
  User deploy
  IdentityFile ~/.ssh/vps-prod
  IdentitiesOnly yes

یک تله دیگر در سمت کلاینت وجود دارد. ssh از استفاده از کلید خصوصی که سایر حساب‌های کاربری روی ماشین شما قادر به خواندن آن باشند، خودداری می‌کند. ssh یک هشدار چاپ کرده و از بارگذاری کلید امتناع می‌کند، بنابراین کلید هرگز برای ورود استفاده نخواهد شد. انتظار نداشته باشید که خط Offering غایب باشد: وقتی ssh نیمه عمومی کلید را در اختیار دارد (مثلاً از فایل .pub در کنار آن)، آن را ارائه می‌دهد، سرور ممکن است پاسخ Server accepts key بدهد، و تنها در آن لحظه است که ssh کلید خصوصی را برای امضا بارگذاری می‌کند، با این هشدار مواجه شده و از آن کلید صرف‌نظر می‌کند:

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@         WARNING: UNPROTECTED PRIVATE KEY FILE!          @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Permissions 0644 for '/home/you/.ssh/vps-prod' are too open.

chmod 600 ~/.ssh/vps-prod این مشکل را حل می‌کند. انتقال کلید از طریق حافظه USB یا اشتراک‌گذاری ویندوزی، روش معمول از دست رفتن مجوزهای دسترسی (mode) است. محل نگهداری کلیدها و نحوه نام‌گذاری آن‌ها در اصول مدیریت کلید SSH پوشش داده شده است.

دلیل 3: کلید عمومی هرگز به فایل authorized_keys نرسیده است

اگر ssh -v نشان می‌دهد که کلید ارسال شده اما سرور همچنان دسترسی نمی‌دهد، پرسش بعدی این است که آیا آن کلید در فایل authorized_keys حساب کاربری قرار دارد یا خیر. از آنجا که نمی‌توانید از طریق SSH برای بررسی وارد شوید، کنسول ارائه‌دهندهٔ خدمات خود را باز کنید.

sudo ls -l /home/deploy/.ssh/
sudo ssh-keygen -lf /home/deploy/.ssh/authorized_keys

دستور ssh-keygen -lf روی یک فایل authorized_keys، برای هر ورودی یک اثر انگشت (fingerprint) چاپ می‌کند:

256 SHA256:0eL/8sBw... you@laptop (ED25519)
3072 SHA256:9Tq2yZk... old-laptop (RSA)

آن‌ها را با اثر انگشت موجود در خط Offering public key خود مقایسه کنید. اگر کلید شما به‌جای آن از طریق یک خط Trying private key ارسال شده است، آن خط فقط نام فایل را مشخص می‌کند؛ بنابراین اثر انگشت آن را با استفاده از ssh-keygen -lf روی فایل .pub مربوطه به دست آورید. اگر کلید در لیست نیست، فارغ از آنچه به یاد دارید، کلید روی آن حساب نصب نشده است.

چهار مورد رایج که باعث بروز مشکل می‌شوند:

  • به‌جای فایل .pub، کلید خصوصی را کپی کرده‌اید. یک خط کلید عمومی شامل نوع کلید مانند ssh-ed25519، ecdsa-sha2-nistp256 یا ssh-rsa، سپس یک رشته طولانی base64 و یک توضیح اختیاری است؛ همچنین گزینه‌هایی مانند restrict ممکن است پیش از نوع کلید قرار بگیرند. کلید خصوصی با -----BEGIN OPENSSH PRIVATE KEY----- شروع می‌شود.
  • متن کپی‌شده در چند خط شکسته شده است. هر ورودی باید دقیقاً در یک خط قرار گیرد؛ بنابراین کلیدی که شکسته شده باشد، به عنوان چندین ورودی ناقص خوانده می‌شود و با هیچ‌چیز مطابقت پیدا نمی‌کند.
  • کلید در /root/.ssh/authorized_keys قرار گرفته در حالی که شما با نام deploy وارد می‌شوید، یا برعکس. این فایل مختص هر حساب کاربری است و فایل مشترکی وجود ندارد.
  • کادر "add my key" در پنل ارائه‌دهنده، کلید را فقط برای کاربر پیش‌فرض ایمیج ثبت کرده است، بنابراین حسابی که بعداً ایجاد کرده‌اید دارای دایرکتوری .ssh خالی است.

روش ایمن برای افزودن کلید از طریق کنسول، با دسترسی root:

sudo install -d -m 700 -o deploy -g deploy /home/deploy/.ssh
sudo tee -a /home/deploy/.ssh/authorized_keys >/dev/null <<'EOF'
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIExampleKeyDataHere you@laptop
EOF
sudo chown deploy:deploy /home/deploy/.ssh/authorized_keys
sudo chmod 600 /home/deploy/.ssh/authorized_keys

پس از آن، دوباره sudo ssh-keygen -lf /home/deploy/.ssh/authorized_keys را اجرا کنید. اثر انگشت جدید اکنون باید در لیست باشد. از دستگاهی که هنوز امکان ورود با رمز عبور را دارد، ssh-copy-id -i ~/.ssh/vps-prod.pub deploy@203.0.113.10 کلید را برای شما اضافه می‌کند و در صورت عدم وجود، .ssh و authorized_keys را با مجوزهای خصوصی ایجاد می‌نماید. این دستور مجوزهای دایرکتوری .ssh یا فایل authorized_keys که از قبل وجود دارند را تغییر نمی‌دهد، بنابراین آن‌ها را همان‌طور که در دلیل 4 توضیح داده شده، بررسی کنید.

علت 4: چرا sshd وقتی مجوزها بیش از حد باز هستند، authorized_keys را نادیده می‌گیرد

StrictModes yes تنظیم پیش‌فرض sshd است. در این حالت، sshd اگر فایل authorized_keys، دایرکتوری .ssh یا دایرکتوری home حساب توسط فردی غیر از مالک قابل نوشتن باشد، یا مالک آن حساب اشتباه باشد، از خواندن آن خودداری می‌کند. دلیل روشن است: اگر گروه یا سایر کاربران بتوانند در دایرکتوری home شما بنویسند، هر حسابی که چنین دسترسی داشته باشد می‌تواند authorized_keys را جایگزین کند و کنترل ورود را به دست بگیرد. sshd با مسیری که قابل اعتماد نیست، مانند حالتی برخورد می‌کند که هیچ کلیدی وجود ندارد.

کاربر پیام ساده Permission denied را می‌بیند. لاگ سرور دلیل واقعی را ثبت می‌کند:

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

یا اگر خود فایل مشکل داشته باشد:

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

مواردی که sshd می‌پذیرد:

  • دایرکتوری home: نباید برای گروه یا سایر کاربران قابل نوشتن باشد. 755، 750 و 700 پذیرفته می‌شوند. 775 و 777 رد می‌شوند.
  • ~/.ssh: همین قانون برقرار است. راهنمای sshd دسترسی فقط برای مالک را توصیه می‌کند که mode آن 700 است.
  • ~/.ssh/authorized_keys: همین قانون برقرار است و این مسیر باید یک فایل معمولی باشد. اگر چنین نباشد، لاگ اعلام می‌کند که مسیر is not a regular file. راهنما خواندن و نوشتن فقط برای مالک را توصیه می‌کند که mode آن 600 است.
  • مالکیت: مالک هر مورد باید حسابی باشد که با آن وارد می‌شوید یا root. هر مالک دیگری باعث ردشدن بررسی می‌شود.

مالکیت به اندازه mode اهمیت دارد. sshd فایل authorized_keys را با حسابی که با آن وارد شده‌اید می‌خواند؛ بنابراین اگر فایل را با sudo nano ایجاد کنید و فراموش کنید مالکیت آن را برگردانید، فایل همچنان متعلق به root و دارای mode 600 می‌ماند. فایل بررسی مالکیت را با موفقیت پشت سر می‌گذارد، اما sshd نمی‌تواند آن را باز کند و لاگ نیز به‌جای آن گزارش می‌کند که نتوانسته فایل را باز کند. هر دو مورد را هم‌زمان اصلاح کنید:

sudo chown -R deploy:deploy /home/deploy/.ssh
sudo chmod 700 /home/deploy/.ssh
sudo chmod 600 /home/deploy/.ssh/authorized_keys
sudo chmod go-w /home/deploy
ls -ld /home/deploy /home/deploy/.ssh

آخرین دستور نتیجه را نمایش می‌دهد. در دایرکتوری home باید drwxr-xr-x یا محدودتر داشته باشید و drwx------ روی .ssh تنظیم شده باشد. اگر هنوز معنی این رشته‌ها روشن نیست، پیش از تغییر modeها روی یک سرور فعال، نحوه خواندن رشته مجوزی مانند drwxr-xr-x را بخوانید.

در Rocky Linux و AlmaLinux، SELinux (security-enhanced Linux) را نیز در فهرست موارد مشکوک قرار دهید. یک دایرکتوری .ssh که از مسیری غیرمعمول ایجاد شده باشد ممکن است برچسب فایل نادرستی داشته باشد؛ در نتیجه sshd حتی با درست‌بودن modeها، از خواندن آن منع می‌شود. sudo restorecon -Rv /home/deploy/.ssh برچسب‌ها را اصلاح می‌کند و sudo ausearch -m avc -ts recent نشان می‌دهد که آیا SELinux مؤلفه‌ای بوده است که دسترسی را رد کرده است.

علت 5: sshd طوری پیکربندی شده است که اتصال شما را رد کند

خواندن /etc/ssh/sshd_config در سیستم‌های فعلی Ubuntu یا Debian کافی نیست. این فایل با Include /etc/ssh/sshd_config.d/*.conf شروع می‌شود و OpenSSH برای هر تنظیم، اولین مقداری را که پیدا کند نگه می‌دارد. بنابراین، فایل drop-in مانند 50-cloud-init.conf پیش از ادامه فایل اصلی خوانده می‌شود و بر هر تنظیم سراسری که پایین‌تر ویرایش کنید غلبه می‌کند. استثنا، بلوک Match است: طبق راهنمای sshd_config، تنظیمات داخل این بلوک بر تنظیمات بخش سراسری اولویت دارند. بنابراین، بلوک Match منطبق، حتی اگر در انتهای فایل اصلی باشد، برای اتصال‌هایی که با آن منطبق می‌شوند بر drop-in غلبه می‌کند. خود فایل‌های drop-in به ترتیب واژگانی خوانده می‌شوند؛ بنابراین فایلی با نام 00-something.conf پیش از 50-cloud-init.conf خوانده می‌شود و هر فایلی که یک مقدار را زودتر تنظیم کند، برنده است. به همین دلیل ممکن است ویرایش شما درست به نظر برسد، اما هیچ تغییری ایجاد نکند.

از sshd بخواهید پیکربندی مؤثری را که از همه این فایل‌ها می‌سازد نمایش دهد:

sudo sshd -T | grep -Ei 'pubkeyauth|authorizedkeysfile|permitrootlogin|allowusers|allowgroups|denyusers'

sshd -T یک فرایند آزمون جدید اجرا می‌کند که فایل‌های موجود روی دیسک را در همین لحظه می‌خواند. این دستور از sshd در حال اجرا سؤال نمی‌کند؛ بنابراین ویرایشی که هنوز با restart اعمال نکرده‌اید، پیش از آن‌که سرور در حال اجرا آن را اعمال کند، در این خروجی دیده می‌شود.

خروجی سالم معمولاً شبیه این است:

permitrootlogin prohibit-password
pubkeyauthentication yes
authorizedkeysfile .ssh/authorized_keys .ssh/authorized_keys2

در خروجی خود، موارد زیر را بررسی کنید:

  • pubkeyauthentication no. هیچ کلیدی پذیرفته نمی‌شود. این وضعیت در ssh -v نیز به‌صورت یک فهرست Authentications that can continue: اولیه، بدون publickey، دیده می‌شود.
  • authorizedkeysfile که به مسیر دیگری اشاره می‌کند؛ برای مثال /etc/ssh/authorized_keys/%u. در این حالت، فایل موجود در home directory کاملاً نادیده گرفته می‌شود و قواعد مجوز علت 4 به مسیر جدید اعمال می‌شوند.
  • وجود allowusers یا allowgroups. هر حسابی که در فهرست نباشد، دقیقاً با همین خطا و بدون توضیح رد می‌شود. denyusers و denygroups برعکس همین کار را انجام می‌دهند.
  • وجود permitrootlogin no هنگام تلاش برای ورود با حساب root. prohibit-password تنظیم میانی مفید است: root می‌تواند با کلید وارد شود، اما با password نه.

بلوک‌های Match در خروجی ساده sshd -T ظاهر نمی‌شوند، زیرا نتیجه آن‌ها به هویت اتصال‌دهنده بستگی دارد. درباره یک اتصال مشخص سؤال کنید:

sudo sshd -T -C user=deploy,host=vps.example.com,addr=198.51.100.7

یک تنظیم دیگر بر کلیدهای قدیمی اثر می‌گذارد. OpenSSH 8.8 به‌طور پیش‌فرض پذیرش امضاهای SHA-1 (ssh-rsa) را متوقف کرد. بنابراین، ممکن است یک کلید RSA که سال‌ها کار می‌کرد، پس از upgrade در یکی از دو سمت از کار بیفتد؛ اگر سمت دیگر آن‌قدر قدیمی باشد که نتواند از RSA با SHA-256 استفاده کند. یک client فعلی هنگام ارتباط با چنین server قدیمی، این موضوع را به‌روشنی اعلام می‌کند:

debug1: send_pubkey_test: no mutual signature algorithm

خود کلید معمولاً مشکلی ندارد. در release notes مربوط به OpenSSH 8.8 آمده است که نیازی به تعویض کلیدهای ssh-rsa نیست، زیرا هرگاه هر دو سمت از آن پشتیبانی کنند، این کلیدها به RSA/SHA-256 یا RSA/SHA-512 تبدیل می‌شوند. بنابراین، upgrade کردن سمت قدیمی راه‌حل پایدار است. اگر امکان upgrade آن را ندارید، کلید جدید نیز کار می‌کند؛ مشروط بر این‌که سمت قدیمی OpenSSH 6.5 یا جدیدتر داشته باشد. این همان releaseای است که Ed25519 را اضافه کرد؛ RSA با SHA-256 در 7.2 اضافه شد: ssh-keygen -t ed25519 -C "deploy@vps-prod"، سپس فایل .pub را همان‌طور که بالا نشان داده شد نصب کنید. سمتی که قدیمی‌تر از 6.5 باشد، نه از Ed25519 و نه از RSA با SHA-256 پشتیبانی می‌کند؛ بنابراین، کلید جدید Ed25519 در آنجا کمکی نمی‌کند. تنظیم PubkeyAcceptedAlgorithms +ssh-rsa در سمت upgraded‌شده، در یک بلوک Host از ~/.ssh/config مربوط به client یا در پیکربندی sshd مربوط به server، امضاهای قدیمی را دوباره فعال می‌کند و امکان ورود را فعلاً فراهم می‌سازد. بنابراین، آن را راهی برای دسترسی به server بدانید، نه پایان کار. سایر تنظیمات سمت server که ارزش بازبینی دارند، در سخت‌سازی SSH server روی یک VPS آمده‌اند.

چگونه اثبات کنیم یک کلید خصوصی با کلید عمومی نصب‌شده مطابقت دارد

بخش بزرگی از حدس و گمان‌ها در این خطا ناشی از این است که نمی‌دانید آیا دو فایل با هم یک جفت هستند یا خیر. یک دستور پاسخ این پرسش را می‌دهد:

ssh-keygen -y -f ~/.ssh/vps-prod

این دستور کلید عمومی استخراج‌شده از کلید خصوصی را چاپ می‌کند. این دستور هرگز فایل .pub کنار آن را نمی‌خواند، بنابراین به شما نشان می‌دهد که کلید خصوصی واقعاً چیست، نه آنچه یک فایل قدیمی .pub ادعا می‌کند. اگر کلید دارای passphrase باشد، دستور آن را از شما می‌پرسد که این خود اثبات می‌کند شما هنوز passphrase را در اختیار دارید.

ssh-keygen -lf ~/.ssh/vps-prod.pub
ssh-add -l

دستور اول اثر انگشت (fingerprint) یک فایل کلید عمومی را چاپ می‌کند. دستور دوم اثر انگشت‌هایی که در agent شما نگهداری می‌شوند را نمایش می‌دهد. حالا چهار نمای مختلف از یک رشته را با هم مقایسه کنید: اثر انگشت موجود در خط Offering public key از خروجی ssh -v، اثر انگشت فایل .pub خودتان، اثر انگشت‌های موجود در ssh-keygen -lf در فایل authorized_keys سرور، و اثر انگشت موجود در لاگ سرور. نقطه‌ای که در آن این موارد دیگر با هم مطابقت ندارند، همان جایی است که مشکل از سمت شماست.

هنگام ناموفق‌بودن ورود، لاگ سرور را بخوانید

عمداً هیچ اطلاعات مفیدی به client داده نمی‌شود. سرور دلیل واقعی را ثبت می‌کند. در نشست کنسول، دنبال‌کردن لاگ را شروع کنید و سپس فرمان ناموفق ssh را از لپ‌تاپ خود اجرا کنید.

sudo journalctl -u ssh -f

تصویر ابری استاندارد سرور Ubuntu 24.04 به‌صورت پیش‌فرض rsyslog را نصب می‌کند (فهرست package آن در 3 November 2026 شامل این بسته است)، بنابراین همین رکوردها در آنجا در /var/log/auth.log نیز ثبت می‌شوند. تصاویر ابری minimal مربوط به Ubuntu 24.04 بدون rsyslog عرضه می‌شوند؛ بنابراین در آن‌ها به‌صورت پیش‌فرض auth.log وجود ندارد و باید به journal مراجعه کنید. در Rocky Linux و AlmaLinux نام unit برابر با sshd است و همین رکوردها در /var/log/secure نیز ثبت می‌شوند.

LogLevel VERBOSE را در پیکربندی sshd تنظیم و سرویس را reload کنید. پس از آن، اثرانگشت کلیدی را که سرور واقعاً دریافت کرده است در هر تلاش ثبت می‌کند:

Failed publickey for deploy from 198.51.100.7 port 49812 ssh2: ED25519 SHA256:0eL/8sBw...

این خط مشخص می‌کند مشکل از کدام سمت است. اگر اثرانگشت را می‌شناسید، یعنی کلید شما به سرور رسیده و سرور آن را رد کرده است؛ بنابراین علت‌های 3، 4 و 5 را بررسی کنید. اگر اثرانگشت را نمی‌شناسید، یعنی client کلیدی را ارسال کرده است که قصد استفاده از آن را نداشتید؛ بنابراین به علت 2 برگردید.

اگر لاگ همچنان واضح نیست، یک sshd دوم را روی پورتی دیگر و در حالت debug اجرا کنید. این فرایند در foreground باقی می‌ماند، به یک connection سرویس می‌دهد، منطق تصمیم‌گیری خود را چاپ می‌کند و سپس خارج می‌شود:

sudo /usr/sbin/sshd -ddd -p 2222

از نشست کنسول روی همان سرور، از طریق نشانی loopback به آن متصل شوید:

ssh -p 2222 -i ~/.ssh/vps-prod -o IdentitiesOnly=yes deploy@127.0.0.1

استفاده از 127.0.0.1 باعث می‌شود شبکه بین شما و سرور از آزمون خارج شود. ترافیک loopback همچنان از packet filter کرنل عبور می‌کند، اما در Ubuntu، ruleهای پیش‌فرض ufw همه‌چیز را روی interface مربوط به lo قبول می‌کنند؛ بنابراین port 2222 به rule جداگانه‌ای در firewall نیاز ندارد، مگر آن‌که کسی آن مقدار پیش‌فرض را حذف کرده باشد. خروجی debug فایلی را که باز کرده، اثرانگشتی را که مقایسه کرده و دلیل دقیق ردکردن connection را نشان می‌دهد؛ این خروجی شامل خط‌هایی مانند Authentication refused: bad ownership or modes for directory /home/deploy نیز می‌شود. پس از یافتن پاسخ، Ctrl+C را فشار دهید. sshd اصلی روی port 22 در تمام این مدت بدون تغییر باقی می‌ماند.

چگونه از مسدود شدن دسترسی خود جلوگیری کنیم

هر مرحله‌ای که پیکربندی سرور را تغییر می‌دهد، نیازمند راهی برای بازگشت است که به SSH وابسته نباشد. این راهکار را زمانی که SSH هنوز کار می‌کند تنظیم کنید، نه پس از آنکه دسترسی قطع شد.

  1. کنسول ارائه‌دهندهٔ سرویس خود را از طریق سریال یا VNC (مخفف virtual network computing) باز کنید و مطمئن شوید که می‌توانید از آن طریق وارد شوید.
  2. اطمینان حاصل کنید که رمز عبور محلی معتبری برای یک حساب کاربری با دسترسی sudo دارید. اگر ندارید، ابتدا رمز عبور root را از طریق کنسول ارائه‌دهنده بازنشانی کنید.
  3. نشست SSH فعلی خود را باز نگه دارید. یک نشست باز، systemctl restart ssh را تاب می‌آورد؛ بنابراین اگر پیکربندی جدید اشتباه باشد، همچنان راهی برای بازگشت باقی می‌ماند.
  4. پیش از راه‌اندازی مجدد، نحو (syntax) را بررسی کنید: sudo sshd -t در صورت معتبر بودن فایل، خروجی نمی‌دهد و در صورت نامعتبر بودن، فایل و شماره خط خطا را چاپ می‌کند.
  5. پیش از بستن ترمینال اول، یک ترمینال دوم باز کنید و یک نشست جدید ایجاد کنید. پیکربندی خراب مانع از ورودهای جدید می‌شود اما نشست‌های موجود را قطع نمی‌کند؛ بنابراین نشستی که در آن هستید نمی‌تواند به شما بگوید که آیا تغییرات اعمال‌شده کار می‌کنند یا خیر.

سرویس را با sudo systemctl restart ssh در Debian و Ubuntu، یا با sudo systemctl restart sshd در Rocky Linux و AlmaLinux راه‌اندازی مجدد کنید. در Ubuntu 24.04، سرویس sshd از یک socket unit شروع می‌شود که پورت و آدرس آن از طریق یک systemd generator از sshd_config دریافت می‌شود؛ بنابراین تغییر در Port یا ListenAddress، پیش از اعمال شدن، نیازمند sudo systemctl daemon-reload و سپس sudo systemctl restart ssh.socket است.

FAQ

چرا با وجود اینکه همان کلید روی سرور دیگری کار می‌کند، خطای Permission denied (publickey) دریافت می‌کنم؟

زیرا کلید شما مشکلی ندارد و مسئله مربوط به محیط اطراف آن است. دستور ssh -v را اجرا کنید و خط Offering public key یا Trying private key مربوط به کلید خود را بیابید. اگر کلید شما در هیچ‌کدام فهرست نشده است، ssh هرگز آن را ارسال نکرده است: فایل در ~/.ssh با نام پیش‌فرض وجود ندارد و در agent نیز بارگذاری نشده است، پس -i /path/to/key -o IdentitiesOnly=yes را اضافه کنید. اگر کلید فهرست شده است و سرور همچنان دسترسی را رد می‌کند، آن کلید در فایل authorized_keys حساب کاربری وجود ندارد، مسیر آن برای گروه قابل نوشتن است، یا پیکربندی sshd کاربر را مسدود کرده است. لاگ سرور این موارد را از هم تفکیک می‌کند.

چگونه ببینم SSH واقعاً در حال ارسال کدام کلید است؟

دستور ssh -v host برای هر کلیدی که نیمه عمومی آن را از قبل در اختیار دارد، یک خط debug1: Offering public key: شامل نوع کلید و اثر انگشت (fingerprint) SHA256 چاپ می‌کند. کلیدی که از فایل خوانده شده نام همان فایل را دارد، در حالی که کلیدی که فقط در agent نگهداری می‌شود، کامنت agent خود را نشان می‌دهد و agent در انتهای خط، کلیدهایی که توسط agent تأمین شده‌اند را مشخص می‌کند. اگر خط بعدی send_pubkey_test: no mutual signature algorithm باشد، آن کلید در نهایت ارسال نشده است. کلیدی که ssh نتواند نیمه عمومی آن را از قبل بخواند، هیچ خط Offering نخواهد داشت: ssh عبارت Trying private key: را به همراه نام فایل چاپ می‌کند، کلید خصوصی را بارگذاری کرده و یک درخواست امضا شده مستقیماً ارسال می‌کند. ssh-add -l اثر انگشت‌های موجود در agent را فهرست می‌کند. ssh-keygen -lf ~/.ssh/id_ed25519.pub اثر انگشت یک فایل کلید تکی را چاپ می‌کند و ssh-keygen -y -f ~/.ssh/id_ed25519 کلید عمومی که از یک کلید خصوصی مشتق شده است را نمایش می‌دهد. برای موفقیت در ورود، اثر انگشت کلیدی که ارسال کرده‌اید باید در خروجی ssh-keygen -lf که روی authorized_keys سرور اجرا شده نیز ظاهر شود.

چرا sshd فایل authorized_keys مرا نادیده می‌گیرد؟

زیرا StrictModes به‌طور پیش‌فرض فعال است و فایل، دایرکتوری .ssh یا دایرکتوری home توسط گروه یا سایر کاربران قابل نوشتن است، یا مالکیت آن متعلق به حسابی غیر از شما یا root است. sshd به مسیری که شخص دیگری بتواند آن را تغییر دهد اعتماد نمی‌کند، بنابراین طوری رفتار می‌کند که گویی هیچ کلیدی وجود ندارد. این بررسی ایجاب می‌کند که هیچ‌کدام از این سه مورد برای گروه یا دیگران قابل نوشتن نباشد، هر کدام متعلق به حساب کاربری ورود یا root باشند، و authorized_keys یک فایل معمولی باشد؛ بنابراین حذف مجوز نوشتن به تنهایی همیشه کافی نیست. تنظیم 755 یا محدودتر برای دایرکتوری home، 700 برای .ssh و 600 برای authorized_keys، که همگی متعلق به حساب کاربری ورود باشند، تنظیمات امنی است. با LogLevel VERBOSE سرور Authentication refused: bad ownership or modes for directory /home/deploy/.ssh را ثبت می‌کند.

کلید من بلافاصله پس از ارتقای سرور از کار افتاد. چه چیزی تغییر کرده است؟

اگر کلید از نوع RSA باشد، این به احتمال زیاد به تغییرات SHA-1 مربوط است. OpenSSH 8.8 امضاهای ssh-rsa SHA-1 را به‌طور پیش‌فرض غیرفعال کرده است، بنابراین وقتی طرف مقابل فقط می‌تواند از آن روش استفاده کند، کلید RSA رد می‌شود. کلاینت‌های جدید عبارت debug1: send_pubkey_test: no mutual signature algorithm را نشان می‌دهند. اگر بتوانید سمت قدیمی را ارتقا دهید، نیازی به جایگزینی کلید نیست، زیرا کلیدهای RSA در هر جایی که هر دو طرف پشتیبانی کنند از SHA-256 یا SHA-512 استفاده می‌کنند. اگر نمی‌توانید و سمت قدیمی از OpenSSH 6.5 یا جدیدتر استفاده می‌کند، یک کلید مدرن با ssh-keygen -t ed25519 تولید کرده و فایل .pub آن را نصب کنید. نسخه‌های قدیمی‌تر از 6.5 نه از Ed25519 و نه از RSA با SHA-256 پشتیبانی نمی‌کنند، بنابراین کلید جدید این مورد را حل نمی‌کند. اگر فوراً به دسترسی نیاز دارید، PubkeyAcceptedAlgorithms +ssh-rsa در سمت ارتقا یافته امضاهای قدیمی را دوباره فعال می‌کند و پس از اعمال اصلاح دائمی، باید آن خط را حذف کنید.

فایل sshd_config را ویرایش کردم و حالا اصلاً نمی‌توانم وارد شوم. چگونه دوباره دسترسی پیدا کنم؟

از کنسول ارائه‌دهنده خدمات خود استفاده کنید که از مسیر SSH عبور نمی‌کند. با رمز عبور محلی وارد شوید، sudo sshd -t را اجرا کنید تا خطای نحوی و شماره خط آن را ببینید، تغییر را لغو کنید و سرویس را restart کنید. سپس sudo sshd -T را اجرا کنید تا مقادیر مؤثری که فایل‌ها اکنون تولید می‌کنند را ببینید، زیرا ممکن است فایلی در /etc/ssh/sshd_config.d/ پیکربندی اصلی را بازنویسی کند. این دستور فایل‌ها را تازه می‌خواند و از sshd در حال اجرا سؤال نمی‌کند، بنابراین پس از هر ویرایش بعدی و قبل از تست ورود، سرویس را restart کنید. اگر رمز عبور محلی ندارید، ابتدا رمز عبور root را از طریق کنسول بازنشانی کنید و سپس فایل را تعمیر کنید.

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