# البدء

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

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

### Node.js 20+

نزّل من [nodejs.org](https://nodejs.org) أو استخدم مدير الحزم.

```bash
# Check if installed
node --version
```

### tmux

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

```bash
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux
```

### cloudflared

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

```bash
# macOS
brew install cloudflared

# Linux - see cloudflare.com/downloads
```

[تنزيل cloudflared](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/)


## تشغيل Termbridge

```bash
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. عند مسحه، حصلت على ملف تعريف ارتباط للجلسة واتصلت

## جرّبه

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

```bash
# 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 بدلًا من إنشاء جلسة جديدة. يفيد ذلك في مراقبة العمليات طويلة التشغيل التي بدأت تشغيلها مسبقًا.

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

### [عناصر التحكم على الهاتف](https://termbridge.inline0.dev/ar/docs/usage/mobile-controls)

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

### [طرفيات متعددة](https://termbridge.inline0.dev/ar/docs/usage/multiple-terminals)

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

### [معاينة خادم التطوير](https://termbridge.inline0.dev/ar/docs/usage/dev-server-preview)

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

### [مرجع CLI](https://termbridge.inline0.dev/ar/docs/cli)

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