البدء

تثبيت المتطلبات الأساسية

لإعداد النفق المحلي الافتراضي، ثبّت هذه الأدوات على حاسوبك:

Node.js 20+

نزّل من nodejs.org أو استخدم مدير الحزم.

# Check if installed
node --version

tmux

مضاعف طرفية يدير جلسات Termbridge.

# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

cloudflared

ينشئ نفقًا آمنًا إلى طرفيتك (لا حاجة إليه في الوضع المباشر للبيئة المعزولة).

# macOS
brew install cloudflared

# Linux - see cloudflare.com/downloads

تنزيل cloudflared

تشغيل Termbridge

npx termbridge

ستظهر لك مخرجات شبيهة بالتالي:

┌─────────────────────────────────────────┐
│  Termbridge                             │
│                                         │
│  Local:   http://127.0.0.1:51234        │
│  Public:  https://abc123.trycloudflare.com │
│                                         │
│  ██████████████                         │
│  ██          ██  <- Scan this QR code   │
│  ██████████████                         │
│                                         │
└─────────────────────────────────────────┘

ملاحظة يُعد trycloudflare.com URL نفقًا سريعًا لا يتطلب حسابًا. إذا كنت تستخدم Termbridge كثيرًا، فأعدّ رمز نفق Cloudflare مُسمّى لتجنب حدود المعدل.

الاتصال من هاتفك

1. افتح كاميرا هاتفك
2. وجّهها إلى رمز QR
3. اضغط على الرابط الذي يظهر
4. ستُحمّل الطرفية في المتصفح

هذا كل شيء؛ تم الاتصال!

ماذا حدث للتو؟

1. شغّل Termbridge خادمًا محليًا على جهازك
2. أنشأ جلسة tmux لطرفيتك
3. أنشأت Cloudflare نفقًا آمنًا (trycloudflare.com URL)
4. يحتوي رمز QR على رمز لمرة واحدة للوصول الآمن. يعمل مرة واحدة وتنتهي صلاحيته بعد 90 ثانية من بدء التشغيل، لذا امسحه سريعًا؛ وإذا انتهت صلاحيته، فأعد تشغيل Termbridge للحصول على رمز جديد
5. عند مسحه، حصلت على ملف تعريف ارتباط للجلسة واتصلت

جرّبه

بعد الاتصال، جرّب بعض الأوامر:

# See system info
htop

# Check a git repo
cd ~/your-project && git status

# Run any CLI tool

تدعم الطرفية الألوان الكاملة وواجهات TUI وجميع المفاتيح المتوقعة.

إبقاؤه قيد التشغيل

يجب أن يظل Termbridge قيد التشغيل حتى يعمل الاتصال. عند الانتهاء:

• اضغط على Ctrl+C في الطرفية التي يعمل فيها Termbridge
• يُغلق النفق وينتهي الاتصال
• تظل جلسة tmux قيد التشغيل (إلا إذا استخدمت --kill-on-exit)

سلوك الجلسة الأولى

• ينشئ Termbridge جلسة tmux (يُشتق الاسم الافتراضي من المنفذ)
• تُحمّل الطرفية الأولى في القائمة تلقائيًا
• يمكنك إنشاء جلسات متعددة عند بدء التشغيل عبر ضبط TERMBRIDGE_SESSIONS=2

استخدام جلسة tmux موجودة

إذا مررت --session <name> وكانت تلك الجلسة موجودة بالفعل، فسيتصل بها Termbridge بدلًا من إنشاء جلسة جديدة. يفيد ذلك في مراقبة العمليات طويلة التشغيل التي بدأت تشغيلها مسبقًا.

الخطوات التالية

عناصر التحكم على الهاتف

نصائح لاستخدام Termbridge على الهواتف والأجهزة اللوحية

طرفيات متعددة

شغّل عدة جلسات وتنقّل بينها

معاينة خادم التطوير

عاين تطبيق Vite بجانب الطرفية

مرجع CLI

اطّلع على جميع الأعلام والخيارات المتاحة