حل خطأ SSH Permission denied (publickey)
تعرّف إلى الأعطال الخمسة وراء الخطأ Permission denied (publickey)، واقرأ مخرجات الأمر `ssh -v` لتصلح السبب الصحيح دون أن تفقد الوصول إلى الخادم.
ما الذي يعنيه Permission denied (publickey) فعلياً
يعني Permission denied (publickey) أن عميلك أرسل مفتاحاً عاماً واحداً أو أكثر، ولم يقبل الخادم أيّاً منها. الشبكة تعمل، وsshd قيد التشغيل؛ ويحدث الرفض في الخطوة الأخيرة من المصادقة. إذا انتهت جلستك قبل الوصول إلى هذه المرحلة، فأنت تواجه رفض الاتصال أو انتهاء مهلة الاتصال، وهذا تشخيص مختلف له اختبارات مختلفة. لا يعتمد الإصلاح على التخمين، لأن ssh -v يوضح أيّاً من خمسة أسباب ينطبق عليك.
توضح الكلمات الموجودة بين القوسين طرق المصادقة التي كان الخادم مستعداً لقبولها. يعني 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 مفقوداً من تلك القائمة الأولى، فهذا يعني أن تسجيل الدخول باستخدام المفتاح العام معطّل على الخادم، ولذلك لن يعمل أي مفتاح.
تُطبع 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، وهو daemon خادم SSH (secure shell)، أبداً بأن حساباً غير موجود. فهو ينفّذ عملية التبادل كاملةً باسم مستخدم مختلق، ثم يرفض الاتصال في النهاية بالرسالة نفسها، لأن كشف أسماء الحسابات الصحيحة يساعد المهاجم. ويبدو الخطأ المطبعي في اسم المستخدم تماماً مثل وجود مفتاح معطّل.
تحقق من سطر Authenticating to ... as قبل أي شيء آخر. إذا كان يحتوي على اسم تسجيل الدخول إلى حاسوبك المحمول بدلاً من حساب الخادم، فقد حذفت اسم المستخدم من الأمر.
ssh -v deploy@203.0.113.10
ssh -v root@203.0.113.10يعتمد الحساب الافتراضي على الصورة التي ينشئها موفّر الخدمة. اعتباراً من August 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 دعمه في April 2025، لذلك لا تتم تجربة ملف id_dsa قديم. يكون المفتاح المحفوظ باسم ~/.ssh/vps-prod غير مرئي لـ ssh حتى تسميه صراحة، ولذلك لا يعرض الخرج التفصيلي أي سطر Offering public key له.
سمِّ الملف، وأوقف مفاتيح الوكيل من الحلول محله:
ssh -i ~/.ssh/vps-prod -o IdentitiesOnly=yes deploy@203.0.113.10لا يكفي استخدام -i وحده عندما يحتفظ الوكيل بمفاتيح، لأن ssh يستمر في عرض مفاتيح الوكيل أولاً والملف المسمى أخيراً. وهذا مهم، لأن خادماً يشغّل OpenSSH أقدم من 10.6 يحتسب كل مفتاح مرفوض ضمن MaxAuthTries، التي قيمتها الافتراضية 6. يمكن لوكيل يحتفظ بسبعة مفاتيح أن يستنفد الحد قبل الوصول إلى مفتاحك الصحيح. يضيف OpenSSH 10.6، الذي صدر في 6 October 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، وامسحها باستخدام ssh-add -D إذا كان قد جمع مفاتيح قديمة على مدى سنوات. ثم دوّن الإعدادات حتى لا يعتمد تسجيل الدخول التالي على تذكّر الخيارات:
Host vps-prod
HostName 203.0.113.10
User deploy
IdentityFile ~/.ssh/vps-prod
IdentitiesOnly yesهناك مشكلة أخرى من جهة العميل. يرفض 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 أو مشاركة Windows الطريقة المعتادة لفقدان الوضع الصحيح. يشرح أساسيات إدارة مفاتيح 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 بصمة واحدة لكل إدخال:
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، أو حدث العكس. الملف خاص بكل حساب، ولا يوجد ملف مشترك. - أضافت خانة "إضافة مفتاحي" لدى مزود الخدمة المفتاح إلى المستخدم الافتراضي للصورة فقط. لذلك يحتوي دليل
.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، أو الدليل الرئيسي للحساب قابلاً للكتابة من أي شخص غير المالك، أو مملوكاً للحساب الخطأ. السبب مباشر: إذا كان بإمكان المجموعة أو جميع المستخدمين الكتابة إلى دليلك الرئيسي، فيمكن لأي حساب يملك ذلك الوصول استبدال authorized_keys والاستيلاء على تسجيل الدخول. يتعامل sshd مع المسار غير الموثوق كما لو لم يكن هناك مفتاح.
يرى العميل رسالة Permission denied العامة. ويسجل خادم SSH السبب الفعلي في السجل:
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:
- الدليل الرئيسي: يجب ألا يكون قابلاً للكتابة من المجموعة أو جميع المستخدمين. تنجح
755و750و700. وتفشل775و777. ~/.ssh: القاعدة نفسها. يوصي دليل sshd بأن يكون الوصول للمالك فقط، أي الوضع700.~/.ssh/authorized_keys: القاعدة نفسها، ويجب أن يكون ملفاً عادياً. إذا لم يكن كذلك، يذكر السجل أن المسارis not a regular file. يوصي الدليل بأن يملك المالك صلاحيات القراءة والكتابة فقط، أي الوضع600.- الملكية: يجب أن يكون كل عنصر مملوكاً للحساب الذي تسجّل الدخول به أو للحساب root. وتفشل عملية التحقق إذا كان المالك أي حساب آخر.
تكتسب الملكية أهمية مساوية للوضع. يقرأ sshd authorized_keys بصفته حساب تسجيل الدخول، لذلك يبقى الملف الذي تنشئه باستخدام sudo nano مملوكاً للحساب root وبالوضع 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يعرض الأمر الأخير النتيجة. يجب أن يكون لديك drwxr-xr-x أو وضع أكثر تقييداً على الدليل الرئيسي، وdrwx------ على .ssh. إذا لم تكن هذه السلاسل واضحة بعد، فاقرأ كيفية قراءة سلسلة أذونات مثل drwxr-xr-x قبل تغيير الأوضاع على خادم قيد التشغيل.
على Rocky Linux وAlmaLinux، أضف SELinux (Linux المحسّن للأمان) إلى قائمة الاحتمالات. قد يحمل دليل .ssh أُنشئ بطريقة غير معتادة تسمية ملف خاطئة، لذلك يُمنع sshd من الوصول إلى القراءة رغم أن الأوضاع تبدو صحيحة. يعيد 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 بأول قيمة يجدها لأي إعداد. لذلك تُقرأ ملفات الإعداد الإضافية مثل 50-cloud-init.conf قبل بقية الملف الرئيسي، وتغلب أي إعداد عام تعدّله في موضع أدنى منه. والاستثناء هو كتلة Match: يوضح دليل sshd_config أن الإعدادات داخلها تتغلب على الإعدادات المحددة في القسم العام، ولذلك فإن كتلة Match المطابقة، حتى إن كانت في نهاية الملف الرئيسي، تتغلب على الملف الإضافي بالنسبة إلى الاتصالات التي تطابقها. وتُقرأ الملفات الإضافية نفسها بالترتيب المعجمي، لذلك يُقرأ الملف المسمى 00-something.conf قبل 50-cloud-init.conf، وتفوز أول قيمة تُحدَّد. ولهذا قد يبدو التعديل صحيحاً من دون أن يغيّر شيئاً.
اطلب من sshd عرض الإعداد الفعلي الذي يبنيه من جميع هذه الملفات:
sudo sshd -T | grep -Ei 'pubkeyauth|authorizedkeysfile|permitrootlogin|allowusers|allowgroups|denyusers'تبدأ sshd -T عملية اختبار جديدة تقرأ الملفات الموجودة على القرص في تلك اللحظة. ولا تطلب الإعداد من عملية sshd قيد التشغيل، ولذلك يظهر هنا أي تعديل لم تطبّقه بعد عبر إعادة التشغيل، قبل أن يستخدمه الخادم الجاري.
تبدو النتيجة السليمة كما يلي:
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. عندها يُتجاهل ملفك الموجود في الدليل الرئيسي بالكامل، وتُطبَّق قواعد الصلاحيات من السبب 4 على المسار الجديد بدلاً منه.- وجود
allowusersأوallowgroups. يُرفض أي حساب غير مدرج بالضبط بهذا الخطأ ومن دون تفسير. ويطبّقdenyusersوdenygroupsالسلوك نفسه بالعكس. permitrootlogin noأثناء محاولتك تسجيل الدخول باستخدام root. يُعدprohibit-passwordالإعداد الوسيط المفيد: يمكن لـroot استخدام مفتاح، لكن لا يمكنه استخدام كلمة مرور.
لا تظهر كتل 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 كان يعمل لسنوات عن العمل بعد ترقية أحد الطرفين، عندما يكون الطرف الآخر قديماً جداً ولا يستطيع استخدام RSA مع SHA-256. يوضح عميل حديث يتصل بخادم قديم كهذا المشكلة صراحةً:
debug1: send_pubkey_test: no mutual signature algorithmيكون المفتاح نفسه سليماً عادةً. توضح ملاحظات إصدار OpenSSH 8.8 عدم الحاجة إلى استبدال مفاتيح ssh-rsa، لأنها تنتقل إلى RSA/SHA-256 أو RSA/SHA-512 عندما يدعم الطرفان ذلك. لذلك فإن ترقية الطرف القديم هي الحل الدائم. إذا تعذرت ترقيته، فسيعمل مفتاح جديد أيضاً ما دام الطرف القديم يشغّل OpenSSH 6.5 أو إصداراً أحدث، وهو الإصدار الذي أضاف 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 على الطرف الذي تمت ترقيته، داخل كتلة Host في ملف ~/.ssh/config الخاص بالعميل أو في إعداد sshd على الخادم، إلى إعادة تمكين التوقيعات القديمة وتمكينك من الدخول اليوم. لذلك تعامل معه كوسيلة للوصول إلى الخادم، لا كحل نهائي للمشكلة. توجد بقية إعدادات الخادم التي تستحق المراجعة في تقوية خادم SSH على VPS.
كيفية إثبات تطابق المفتاح الخاص مع المفتاح العام المثبّت
ينشأ معظم التخمين في هذا الخطأ من عدم معرفة ما إذا كان ملفان يشكّلان زوجاً. يجيب أمر واحد عن ذلك:
ssh-keygen -y -f ~/.ssh/vps-prodيطبع هذا الأمر المفتاح العام المشتق من المفتاح الخاص. ولا يقرأ ملف .pub الموجود بجانبه، لذلك يبيّن ماهية المفتاح الخاص فعلياً، وليس ما يدّعيه ملف .pub قديم. إذا كان للمفتاح عبارة مرور، يطلب الأمر إدخالها. وهذا يثبت أيضاً أنك ما زلت تعرف عبارة المرور.
ssh-keygen -lf ~/.ssh/vps-prod.pub
ssh-add -lيطبع الأمر الأول بصمة ملف مفتاح عام واحد. ويطبع الأمر الثاني البصمات التي يحتفظ بها الوكيل. قارن الآن أربع صور للسلسلة نفسها: البصمة الموجودة في سطر Offering public key من ssh -v، وبصمة ملف .pub لديك، والبصمات الموجودة في ssh-keygen -lf على authorized_keys الخاص بالخادم، والبصمة الموجودة في سجل الخادم. الموضع الذي تتوقف عنده هذه القيم عن التطابق يحدد موضع الخطأ لديك.
قراءة سجل الخادم أثناء فشل تسجيل الدخول
لا يُرسَل إلى العميل أي شيء مفيد عن قصد. يكتب الخادم السبب الحقيقي. ابدأ بمتابعة السجل في جلسة وحدة التحكم، ثم شغّل الأمر ssh الذي يفشل من حاسوبك المحمول.
sudo journalctl -u ssh -fتثبّت صورة Ubuntu 24.04 السحابية القياسية خادم rsyslog افتراضياً، وتدرجه قائمة الحزم الخاصة بها حتى 3 نوفمبر 2026، لذلك تُكتب السجلات نفسها أيضاً في /var/log/auth.log هناك. تُصدر صور Ubuntu 24.04 السحابية المصغّرة من دون rsyslog، لذلك لا يوجد فيها auth.log افتراضياً، ويكون journal هو المكان الذي يجب البحث فيه. في Rocky Linux وAlmaLinux تُسمّى الوحدة sshd، وتُكتب السجلات نفسها أيضاً في /var/log/secure.
اضبط LogLevel VERBOSE في إعدادات sshd ثم أعد تحميل الخدمة. بعد ذلك يسجّل كلٌّ من المحاولات بصمة المفتاح التي استلمها الخادم فعلياً:
Failed publickey for deploy from 198.51.100.7 port 49812 ssh2: ED25519 SHA256:0eL/8sBw...يوضح هذا السطر أي جانب يحتوي على الخلل. إذا تعرّفت على البصمة، فهذا يعني أن مفتاحك وصل ورفضه الخادم، ولذلك راجع السببين 3 و4 و5. وإذا لم تتعرّف على البصمة، فهذا يعني أن العميل أرسل مفتاحاً لم تقصده، ولذلك ارجع إلى السبب 2.
إذا ظل السجل غير واضح، شغّل نسخة ثانية من sshd على منفذ آخر في وضع تصحيح الأخطاء. تعمل هذه النسخة في الواجهة الأمامية، وتخدم اتصالاً واحداً، وتطبع تفسيرها، ثم تنتهي:
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 مع ذلك عبر مرشح الحزم في النواة، لكن قواعد ufw الافتراضية في Ubuntu تسمح بكل شيء على الواجهة lo، لذلك لا يحتاج المنفذ 2222 إلى قاعدة جدار ناري خاصة به، إلا إذا أزال أحد تلك القاعدة الافتراضية. يذكر خرج تصحيح الأخطاء الملف الذي فتحه، والبصمة التي قارنها، وسبب الرفض الدقيق، بما في ذلك أسطر مثل Authentication refused: bad ownership or modes for directory /home/deploy. اضغط Ctrl+C عندما تحصل على الإجابة. لا يتأثر sshd الفعلي على المنفذ 22 طوال هذه العملية.
كيفية تجنّب منع وصولك إلى الخادم
تحتاج كل خطوة تعدّل إعدادات الخادم إلى وسيلة دخول بديلة لا تعتمد على SSH. أعدّ هذه الوسيلة ما دام SSH يعمل، وليس بعد تعطّله.
- افتح وحدة تحكم موفّر الخدمة، عبر serial أو VNC (الحوسبة الشبكية الافتراضية)، وتأكد من قدرتك على تسجيل الدخول منها.
- تأكد من معرفتك بكلمة مرور محلية صالحة لحساب يملك صلاحية sudo. إذا لم تكن لديك كلمة مرور، أعد تعيين كلمة مرور root من وحدة تحكم موفّر الخدمة أولاً.
- أبقِ جلسة SSH الحالية مفتوحة. تستمر الجلسة المفتوحة بعد
systemctl restart ssh، ولذلك تبقى وسيلة للدخول مجدداً إذا كان الإعداد الجديد خاطئاً. - افحص الصياغة قبل إعادة التشغيل: يطبع
sudo sshd -tلا شيء عندما يكون الملف صالحاً، ويطبع اسم الملف ورقم السطر عندما يكون غير صالح. - افتح طرفية ثانية وسجّل الدخول من جديد قبل إغلاق الطرفية الأولى. يمنع الإعداد المعطّل عمليات تسجيل الدخول الجديدة ويُبقي الجلسات الحالية، لذلك لا يمكن للجلسة التي تستخدمها أن تؤكد نجاح التغيير.
أعد التشغيل باستخدام sudo systemctl restart ssh على Debian وUbuntu، أو باستخدام sudo systemctl restart sshd على Rocky Linux وAlmaLinux. في Ubuntu 24.04، يبدأ sshd من وحدة socket، ويأتي المنفذ والعنوان فيها من sshd_config عبر systemd generator. لذلك يحتاج تغيير 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: لكل مفتاح يحتفظ مسبقاً بنسخته العامة، مع نوع المفتاح وبصمة 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 أو الدليل المنزلي قابل للكتابة من المجموعة أو من الجميع، أو مملوك لحساب غير حسابك أو root. لا يثق sshd بمسار يستطيع شخص آخر تغييره، ولذلك يتصرف كما لو لم يوجد أي مفتاح. يتطلب الفحص ألا يكون أي من العناصر الثلاثة قابلاً للكتابة من المجموعة أو الآخرين، وأن يكون كل عنصر مملوكاً لحساب تسجيل الدخول أو root، وأن يكون authorized_keys ملفاً عادياً؛ لذلك لا يكفي دائماً إزالة أذونات الكتابة. استخدم 755 أو أذونات أشد تقييداً للدليل المنزلي، و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 لعرض خطأ الصياغة ورقم السطر، ثم تراجع عن التغيير وأعد تشغيل الخدمة. بعد ذلك شغّل sudo sshd -T لعرض القيم الفعلية التي تنتجها الملفات حالياً، لأن ملفاً في /etc/ssh/sshd_config.d/ قد يتجاوز إعدادات الملف الرئيسي. يقرأ هذا الأمر الملفات من جديد بدلاً من طلب القيم من sshd قيد التشغيل، لذلك أعد تشغيل الخدمة بعد أي تعديل إضافي وقبل اختبار تسجيل الدخول. إذا لم تكن لديك كلمة مرور محلية، فأعد تعيين كلمة مرور root من وحدة التحكم أولاً، ثم أصلح الملف.