دليل النشر

انتهاء مهلة مصافحة TLS: تشخيص ClientHello ما بعد الكم

انشر على VPS Cloud ←

انتهاء مهلة مصافحة TLS: تشخيص ClientHello ما بعد الكم

منذ أواخر أكتوبر 2026، تفشل أدوات مثل `ollama pull` برسالة `net/http: TLS handshake timeout` على خوادم ما زالت تستجيب لـ curl. الخادم ليس معطلاً: العملاء الحديثون يعلنون افتراضياً تبادل مفاتيح ما بعد الكم، ورسالته الأولى أكبر بكثير، وجهاز على المسار يُسقطها. يشرح هذا الدليل الآلية، ويقدّم أمرَي openssl يُثبتانها في دقائق، ثم يرتّب الحلول: إصلاح المسار أولاً، وتعطيل ما بعد الكم في عملية واحدة كملاذ أخير.

10 دقائق للقراءةعدد الخطوات: 16
المحتويات· العَرَض: curl يجيب والأداة تنتهي مهلتها1/12
  1. 01العَرَض: curl يجيب والأداة تنتهي مهلتها
  2. 02لماذا قد تعطّل ClientHello أكبر كل شيء
  3. 03العَرَض والسبب المحتمل والاختبار الحاسم
  4. 04التشخيص في عشر دقائق
  5. 05من الذي يحجب: الخادم البعيد أم الجهاز الوسيط أم مسار الوصول
  6. 06أصلِح، أو تجاوز عند الضرورة
  7. 07Ollama على VPS: حالة النقاش #19430
  8. 08ما تكلّفه الحيلة GODEBUG=tlsmlkem=0
  9. 09أثبت قبل أن تتجاوز
  10. 10استكشاف الأخطاء: الرسائل التي ستصادفها
  11. 11احتفظ بالدليل لا بالحل المؤقت فقط
  12. 12للمزيد

العَرَض: curl يجيب والأداة تنتهي مهلتها

السيناريو المعتاد يتسع لثلاثة أسطر. تنزيل تطلقه أداة مكتوبة بلغة Go يتوقف عند Error: pull model manifest: Get "https://registry.ollama.ai/...": net/http: TLS handshake timeout. أما الخادم نفسه، إذا سألتَه بنسخة أقدم من curl، فيجيب في جزء من الثانية. وإعادة المحاولة لا تغيّر شيئاً: ثلاث محاولات من ثلاث تفشل بالطريقة نفسها.

هذا هو نمط النقاش ollama/ollama#19430 الذي فُتح في 31 أكتوبر 2026. المهم هو عدم التماثل: اتصال TCP يُقام، ثم لا تكتمل مصافحة TLS أبداً. ليس هذا DNS معطلاً ولا منفذاً مغلقاً ولا شهادة منتهية، فهذه كلها تعطي رسائل مختلفة. حين يعمل TCP ولا يبقى دون جواب إلا أول رسالة TLS، يُنظر في حجم هذه الرسالة وشكلها، أي ClientHello.

لماذا قد تعطّل ClientHello أكبر كل شيء

ClientHello هي أول رسالة في اتصال TLS: يسرد فيها العميل خوارزمياته ويرسل حصص تبادل المفاتيح. منذ Go 1.24 تفعّل المكتبة القياسية افتراضياً التبادل الهجين لما بعد الكم X25519MLKEM768 عندما يكون Config.CurvePreferences يساوي nil. وتفعل OpenSSL 3.5.0، الصادرة في 8 أبريل 2025، الشيء نفسه: قائمة المجموعات الافتراضية فيها تضع X25519MLKEM768 أولاً وترسل حصتَي مفتاح، X25519MLKEM768 وX25519.

حصة ML-KEM كبيرة. في النقاش #19430 تزن رسالة ClientHello لما بعد الكم 1573 بايت، مقابل 512 للرسالة الكلاسيكية: لم تعد تتسع في حزمة واحدة. غير أن بعض الخوادم والأجهزة تفترض أن ClientHello تصل في قراءة TCP واحدة. يصف موقع tldr.fail هذا الخلل: يقرأ الخادم الجزء الأول، ويحكم أن المصافحة غير صالحة، ويقطع الاتصال، بينما كان الخادم السليم سيتجاهل الخيار المجهول. الخلل أقدم من ما بعد الكم، والحجم لا يفعل سوى كشفه. وتعرضه وثائق Go سبباً لاستخدام GODEBUG=tlsmlkem=0.

العَرَض والسبب المحتمل والاختبار الحاسم

مرّر الجدول أفقيًا

العَرَضالسبب المحتملالاختبار الحاسم
المجموعة الهجينة وحدها تنتهي مهلتها مع `openssl s_client`ClientHello لما بعد الكم مرشّحة أو مقروءة خطأً`-groups X25519MLKEM768` ثم `-groups X25519`
curl ينجح مع `--curves X25519:P-256` وعميل Go تنتهي مهلتهعميل Go يعلن المجموعة الهجينة افتراضياً`GODEBUG=tlsmlkem=0` على تلك العملية وحدها
كل شيء تنتهي مهلته حتى مع X25519 وحدهاجدار حماية أو توجيه: الحجم ليس السبب`curl -v` نحو خادم آخر ومنفذ آخر
الطلبات الصغيرة تمر والتبادلات الكبيرة تتجمدMTU أو MSS، ثقب أسود لـ ICMP`ping -M do -s 1472` ثم `tcp_mtu_probing`
خادم واحد يفشل من جميع شبكاتكخادم يقرأ ClientHello مجزأة قراءة خاطئةالاختبار نفسه من شبكة ثانية
فشل على شبكة ونجاح على أخرىترشيح عند الوصول: مزوّد أو شركة أو جهاز وسيطمسار ثانٍ: VPS أو نقطة اتصال الهاتف
قطع فوري (reset) بعد ClientHelloجهاز يقطع عند رسالة غير متوقعة`tcpdump`: رسالة RST بعد ClientHello مباشرة

التشخيص في عشر دقائق

  1. أعد الإنتاج باستخدام curl

    قِس الزمن ورمز الاستجابة: curl -sS -o /dev/null -w '%{http_code} %{time_total}\n' https://example.com/. إذا أجاب curl بسرعة وانتهت مهلة أداتك، فالخادم قابل للوصول والخلل في مكان آخر.

  2. افرض ClientHello كلاسيكية

    أعد التشغيل بـ curl --curves X25519:P-256 -sS -o /dev/null -w '%{http_code} %{time_total}\n' https://example.com/. في النقاش #19430 تحصل هذه الرسالة ذات 512 بايت على جواب خلال 0.32 ثانية. وبحسب مكتبة TLS التي يعمل بها curl عندك قد يُرفض الخيار: اقرأ الرسالة قبل أن تستنتج.

  3. قارن المجموعتين باستخدام openssl

    تحتاج إلى OpenSSL 3.5 أو أحدث للاختبار الأول. شغّل timeout 10 openssl s_client -connect example.com:443 -servername example.com -tls1_3 -groups X25519MLKEM768 </dev/null، ثم الأمر نفسه مع -groups X25519.

  4. اقرأ الحكم

    إذا اكتملت المصافحة مع X25519 وحدها وبقيت المجموعة الهجينة بلا جواب حتى انقضاء المهلة، فإن ClientHello لما بعد الكم كبيرة جداً أو مرشّحة. في النقاش تنتهي مهلة الهجينة بعد 8 ثوانٍ. وإذا فشلتا معاً فليس هذا هو الخلل.

  5. استبعد MTU

    اختبر ping -M do -s 1472 example.com: يجب أن تمر الحزمة ذات 1500 بايت دون تجزئة. واقرأ أيضاً sysctl net.ipv4.tcp_mtu_probing: القيمة 0 تعطّل الكشف، و1 تفعّله عند اكتشاف ثقب أسود لـ ICMP، و2 تُبقيه مفعّلاً دائماً.

  6. التقط الحوار، اختياري

    باستخدام sudo tcpdump -ni any host HOST_IP and tcp port 443 انظر إلى ما يلي ClientHello: إعادات إرسال بلا جواب تدل على حزمة مسقطة، ورسالة RST تدل على قطع فعلي.

  7. غيّر مسار الشبكة

    أعد أمرَي openssl من اتصال آخر: نقطة اتصال الهاتف أو VPS. النتيجة نفسها في كل مكان تعني أن الخلل عند الخادم البعيد. نتيجة مختلفة تعني أنه عند وصولك أنت.

من الذي يحجب: الخادم البعيد أم الجهاز الوسيط أم مسار الوصول

الاختبار من شبكة ثانية يدل على المتسبب. إذا فشل الخادم من كل مكان فالمسؤول خادم أو جهاز أمامه: وكيل عكسي قديم، أو جدار حماية للتطبيقات، أو موزّع أحمال يقرأ ClientHello المجزأة قراءة خاطئة. لا تستطيع إصلاح ذلك، لكن يمكنك تنبيه المشغّل بإرفاق أمرَي openssl ونتيجتهما، فتوفّر المراسلات المعتادة ذهاباً وإياباً.

إذا أجاب الخادم من شبكة ولم يجب من الأخرى، فالخلل في مسار وصولك: جهاز فحص TLS في الشركة، أو جدار حماية لا يعرف رمز المجموعة الهجينة، أو ترشيح من مزوّد الوصول. هذه هي الحالة الموصوفة في النقاش #19430، حيث صاحب البلاغ على مزوّد إنترنت يُسقط هذه الرسائل بصمت. وفي ذلك النقاش يتبع الحجب عنوان IP الوجهة لا اسم SNI، ويمر اختبار MTU: استُبعدت فرضية MTU.

أصلِح، أو تجاوز عند الضرورة

  1. أصلح المسار حين يكون مسارك

    حدّث الوكيل العكسي أو جدار الحماية أو جهاز الفحص الذي يرفض ClientHello. هذا هو الإصلاح الوحيد الذي يحتفظ بما بعد الكم.

  2. عالج MTU إن أظهرها الاختبار

    إذا فشل ping -M do -s 1472 فعّل الكشف بالأمر sudo sysctl -w net.ipv4.tcp_mtu_probing=1، ثم ثبّت القيمة في ملف ضمن /etc/sysctl.d/. هذه فرضية مستقلة تُختبر بعد المجموعة الهجينة.

  3. عطّل ما بعد الكم في عميل Go

    شغّل الأمر مع GODEBUG=tlsmlkem=0، مثل GODEBUG=tlsmlkem=0 ./my-tool. لن يعلن العميل بعدها إلا المجموعات الكلاسيكية، وتعود ClientHello إلى حجم عادي.

  4. ضعها في خدمة systemd

    أنشئ ملف drop-in بالأمر sudo systemctl edit my-service، وأضف تحت [Service] السطر Environment="GODEBUG=tlsmlkem=0"، ثم نفّذ sudo systemctl restart my-service.

  5. ضعها في حاوية

    مع Docker أضف -e GODEBUG=tlsmlkem=0 إلى docker run. ومع Compose أضف - GODEBUG=tlsmlkem=0 تحت environment: في الخدمة المعنية، ثم نفّذ docker compose up -d.

  6. أزل الحل المؤقت بمجرد إصلاح المسار

    دوّن في مستودع الإعدادات سبب وجود المتغير. وحين يُصلَح الجهاز الوسيط أو الخادم، احذفه وأعد اختبار openssl للتأكد من مرور المجموعة الهجينة.

Ollama على VPS: حالة النقاش #19430

يبلّغ النقاش عن هذا السلوك مع Ollama 0.40.13، في الصورة الرسمية ollama/ollama:latest تحت Docker، على اتصال لدى مزوّد وصول دون VPN أو وكيل. الخطأ هو المذكور أعلاه، على registry.ollama.ai. قاس صاحب البلاغ 1573 بايت لـ ClientHello ما بعد الكم، وهي التي تنتهي مهلتها، و512 للكلاسيكية التي تتلقى جواب 404 خلال 0.32 ثانية. ومع GODEBUG=tlsmlkem=0 على العملية التي تنزّل، تنجح ثلاث محاولات من ثلاث، مقابل ثلاثة إخفاقات من ثلاث بدونه.

وقت الكتابة، هذا النقاش مفتوح ولا يذكر أي إصلاح رسمي: الحل المؤقت هو حل صاحب البلاغ، ويُعرض على أنه مؤقت. وبالنسبة إلى Ollama على VPS فالنتيجة عملية. إذا انتهت مهلة ollama pull بينما يصل curl إلى السجل، فطبّق التشخيص أعلاه من الـ VPS، ثم ضع المتغير على حاوية ollama، بالأمر docker run -e GODEBUG=tlsmlkem=0 ... أو تحت environment: في Compose، وأعد docker exec ollama ollama pull the-model. كما يمنحك الـ VPS مسار شبكة مختلفاً عن مسارك: إذا نزّل النموذج دون المتغير فالترشيح عند وصولك.

ما تكلّفه الحيلة GODEBUG=tlsmlkem=0

  • لا ما بعد الكم بعد الآن — لم تعد العملية تعلن X25519MLKEM768: تفقد اتصالاتها الحماية من حركة مرور تُلتقط اليوم وتُفك لاحقاً.
  • نطاق واسع — يسري المتغير على العملية كلها، أي على كل اتصالاتها الصادرة، لا على الخادم المسبب للمشكلة وحده.
  • ضبط مؤقت — هو حل مؤقت لا إصلاح: يُخفي عيباً في مسار الشبكة يبقى قائماً.
  • دَين يجب توثيقه — دون تعليق في الإعدادات يعيش المتغير سنوات ولا يعرف أحد لماذا.
  • لا ضمان شاملاً — إذا لم يأتِ الترشيح من ClientHello فلن يغيّر المتغير شيئاً: أعد اختبار openssl لتعرف.

أثبت قبل أن تتجاوز

احتفظ بمخرجات أمرَي openssl s_client (مع المجموعة الهجينة وبدونها) مؤرَّخةً، في تذكرتك أو في الرسالة إلى المشغّل. تكفي لإظهار أن الخادم يجيب بالكلاسيكية لا بالهجينة، وتجنّبك تركيب حل مؤقت على تشخيص خاطئ.

استكشاف الأخطاء: الرسائل التي ستصادفها

يظهر الخلل نفسه بصور مختلفة بحسب الأداة. هذه أكثر الصور شيوعاً وما تقوله كل منها عن العطل.

  • net/http: TLS handshake timeout — أقام عميل Go اتصال TCP ثم لم يتلقّ جواباً عن ClientHello. شغّل اختبار openssl مع المجموعة الهجينة وبدونها.
  • curl: (28) SSL connection timeout — العَرَض نفسه في curl: لا تكتمل المصافحة ضمن المهلة. قارن مع --curves X25519:P-256.
  • timeout 10 openssl s_client ... بلا مخرجات ورمز عودة 124 — لم تكتمل المصافحة خلال عشر ثوانٍ. وهذه النتيجة المتوقعة لمجموعة هجينة مرشّحة.
  • read: connection reset by peer — الطرف الآخر أو جهاز ما يقطع فعلياً. ابحث عن RST بعد ClientHello مباشرة باستخدام tcpdump.
  • connect:errno=110 في مخرجات openssl — TCP نفسه تنتهي مهلته قبل أي ClientHello: جدار حماية أو توجيه، لا هذا الخلل.

احتفظ بالدليل لا بالحل المؤقت فقط

انتهاء مهلة مصافحة TLS الذي يصيب أداة واحدة يبدو خللاً في البرنامج. أما مقارنة مجموعتين باستخدام openssl فتعيد السؤال إلى ترتيبه الصحيح: هل يجيب الخادم عن ClientHello كلاسيكية، وعن أخرى هجينة؟ وبحسب الجواب يقع الإصلاح على الخادم، أو على الجهاز الوسيط، أو على وصولك، أو كملاذ أخير في متغير بيئة يوضع على عملية.

المؤكد اليوم أن Go وOpenSSL تعلنان المجموعة الهجينة افتراضياً، وأن بعض الأجهزة تتعامل معها بسوء. وغير المؤكد هو وجود إصلاح رسمي من جهة Ollama، وهو غائب عن النقاش حتى الآن. عامِل GODEBUG=tlsmlkem=0 على أنه رقعة مؤرَّخة، وأعد الاختبار بعد كل تغيير في المسار.

للمزيد

  1. أقم خادم Ollama على VPS

    التثبيت والنماذج وفتح الواجهة: كيفية استضافة Ollama على خادم VPS.

  2. أغلق محاولات الوصول المتكررة إلى هذا الخادم

    لحجب المحاولات التي تطرق الخدمة نفسها، انظر Fail2Ban Enhanced على خادم VPS.

  3. اختر الوكيل العكسي الذي ينهي TLS

    Caddy وTraefik وNginx Proxy Manager يتعامل كل منها مع TLS بطريقته: المقارنة.

شارك هذا المقالservorbit.com/ma-ar/المدونة/انتهاء-مهلة-مصافحة-tls-تشخيص-clienthello-ما-بعد-الكم