# الأنفاق المسماة

يستخدم Termbridge افتراضيًا أنفاق Quick Tunnels من Cloudflare التي لا تتطلب حسابًا (`trycloudflare.com`). وهي مريحة، لكن قد تُفرض عليها حدود للمعدل عند الاستخدام المكثف.

إذا كنت تستخدم Termbridge كثيرًا، فأعدّ نفقًا مسمى باستخدام حسابك على Cloudflare.

## لماذا تستخدم نفقًا مسمى؟

- **بلا حدود للمعدل**: قد تُرجع Quick Tunnels أخطاء 429 عند الاستخدام المكثف
- **URL ثابت**: احصل على نطاق فرعي ثابت بدلًا من سلاسل عشوائية
- **نطاق مخصص**: استخدم نطاقك مثل `term.example.com`
- **موثوقية أفضل**: الأنفاق المسماة أكثر استقرارًا للجلسات الطويلة

## الإعداد

### 1. أنشئ حسابًا على Cloudflare

سجّل في [cloudflare.com](https://cloudflare.com) إذا لم يكن لديك حساب.

### 2. أنشئ نفقًا في Zero Trust

1. انتقل إلى [Cloudflare Zero Trust](https://one.dash.cloudflare.com/)
2. انتقل إلى **Networks** → **Tunnels**
3. انقر **Create a tunnel**
4. اختر **Cloudflared** كموصل
5. سمّ النفق (مثل e.g أو `termbridge`)
6. انسخ رمز النفق

### 3. أضف اسم مضيف عام

1. في إعدادات النفق، انتقل إلى **Public Hostname**
2. أضف اسم مضيف يشير إلى `http://localhost:8080` (أو المنفذ الذي تختاره)
3. استخدم نطاقًا فرعيًا مثل `term.example.com`

### 4. شغّل Termbridge باستخدام الرمز

```bash
termbridge --port 8080 --tunnel-token <TOKEN> --tunnel-url https://term.example.com
```

أو استخدم متغيرات البيئة:

```bash
export TERMBRIDGE_TUNNEL_TOKEN=<TOKEN>
export TERMBRIDGE_TUNNEL_URL=https://term.example.com

termbridge --port 8080
```

> **ملاحظة**
> يلزم استخدام الخيار `--port` مع الأنفاق المسماة، لأن اسم المضيف مضبوط للإشارة إلى منفذ محدد.


## خيارات الإعداد

| الخيار | متغير البيئة | الوصف |
|------|---------------------|-------------|
| `--port <port>` | - | المنفذ المحلي (مطلوب مع الأنفاق المسماة) |
| `--tunnel-token <token>` | `TERMBRIDGE_TUNNEL_TOKEN` | رمز النفق الخاص بك |
| `--tunnel-url <url>` | `TERMBRIDGE_TUNNEL_URL` | اسم المضيف العام الخاص بك URL |

## تعطيل النفق بالكامل

إذا كان لديك وكيل عكسي خاص أو URL عام:

```bash
termbridge --no-tunnel --public-url https://your-server.com
```

أو:

```bash
export TERMBRIDGE_TUNNEL=none
export TERMBRIDGE_PUBLIC_URL=https://your-server.com

termbridge
```

سيتخطى Termbridge بدء نفق، وسيستخدم URL الذي توفره لرمز QR.

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

### "429 طلبات كثيرة جدًا"

يعني هذا أن Quick Tunnels تفرض حدودًا على المعدل. الحلول:

1. انتظر بضع دقائق ثم أعد المحاولة
2. أنهِ أي عمليات `cloudflared` قديمة: `pkill cloudflared`
3. انتقل إلى نفق مسمى (موصى به)

### بدأ النفق لكن URL لا يعمل

- تحقق من أن اسم المضيف في Cloudflare يطابق `--tunnel-url`
- تحقق من أن المنفذ في Cloudflare يطابق `--port`
- تأكد من تحديث cloudflared: `cloudflared update`

### النفق المسمى لا يتصل

- تحقق من صحة الرمز
- افحص لوحة معلومات Cloudflare Zero Trust بحثًا عن أخطاء
- حاول تشغيل `cloudflared tunnel run <TOKEN>` مباشرةً للاطلاع على رسائل الخطأ