استكشاف الأخطاء وإصلاحها

"spawn tmux ENOENT"

إما أن tmux غير مثبت أو غير موجود في PATH. يطبع Termbridge هذا الخطأ لكنه يواصل العمل حاليًا دون توفير طرفية (#4)؛ اضغط Ctrl+C، وثبّت tmux، ثم أعد تشغيله.

# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

"spawn cloudflared ENOENT"

إما أن عميل نفق Cloudflare غير مثبت أو غير موجود في PATH. لا يلزم إلا في وضع النفق؛ أما --no-tunnel والوضع المباشر في Daytona فلا يحتاجان إلى cloudflared.

# macOS
brew install cloudflared

بالنسبة إلى Linux، نزّل من cloudflare.com/downloads.

تعذر بدء النفق

تحقق من الأمور التالية (تجاوز هذا إذا كنت تستخدم وضع البيئة المعزولة المباشر):

1. تحقق من عمل cloudflared: cloudflared --version
2. تأكد من إمكانية الوصول إلى https://trycloudflare.com
3. تحقق مما إذا كان جدار الحماية يحظر الاتصالات الصادرة

إذا تعذر بدء النفق، يطبع Termbridge الخطأ ويوقف خادمه ويخرج بالحالة 1. لا ينتقل إلى وضع محلي فقط، ولا يستمع الخادم إلا على 127.0.0.1 افتراضيًا، لذلك لا يمكن للأجهزة الأخرى على شبكتك الوصول إليه أيضًا. وتظل جلسات tmux التي أُنشئت لهذا التشغيل قيد العمل (#4).

لاستخدام Termbridge دون نفق Cloudflare، شغّله مع --no-tunnel --public-url <url> خلف وكيل عكسي أو نفق خاص بك.

"429 Too Many Requests" من trycloudflare

تفرض Cloudflare حدودًا للمعدل على الأنفاق التي لا ترتبط بحساب. إذا ظهرت أخطاء مثل 429 Too Many Requests، فجرّب ما يلي:

1. انتظر بضع دقائق ثم أعد المحاولة
2. تأكد من عدم استمرار تشغيل عمليات cloudflared قديمة
3. استخدم رمزًا مميزًا لنفق مسمى (موصى به للاستخدام المتكرر)

شاشة فارغة أو "Unable to load terminals"

يعني هذا عادةً أن المتصفح لا يملك ملف تعريف ارتباط صالحًا للجلسة، مثلًا لأنه فُتح دون استرداد رابط مشاركة، أو لأن URL النفق قد تغير:

1. تحقق مما إذا كان الخادم المحلي لا يزال يعمل
2. افحص وحدة تحكم المتصفح بحثًا عن أخطاء 401/403
3. أعد تشغيل Termbridge للحصول على رمز URL وQR جديدين

لا يوجد مخرج في الطرفية

قد لا تكون جلسة tmux قيد التشغيل:

# Check if sessions exist
tmux ls

إذا ظهرت الجلسات لكن الطرفية فارغة، فجرّب:

• إعادة تحميل الصفحة
• التحقق من أن الصدفة تدعم TERM=xterm-256color

يمسح رمز QR لكن الصفحة فارغة

يحتوي رمز QR على رمز مميز يُستخدم مرة واحدة. يعمل مرة واحدة فقط وخلال 90 ثانية من بدء Termbridge. ويؤدي الرابط المستخدم أو المنتهي الصلاحية إلى invalid token.

الحل: أعد تشغيل Termbridge لإنشاء رمز QR جديد، ثم امسحه فورًا.

أخطاء node-pty المتعلقة بـ spawn-helper

يحاول Termbridge إصلاح ذلك تلقائيًا، ولكن إذا ظهرت أخطاء أذونات:

chmod +x node_modules/node-pty/prebuilds/**/spawn-helper

ما زلت عالقًا؟

أرسل بلاغًا على github.com/inline0/termbridge يتضمن:

• نظام التشغيل وإصدار Node.js لديك
• رسالة الخطأ
• خطوات إعادة إنتاج المشكلة