الأنفاق المسماة
يستخدم Termbridge افتراضيًا أنفاق Quick Tunnels من Cloudflare التي لا تتطلب حسابًا (trycloudflare.com). وهي مريحة، لكن قد تُفرض عليها حدود للمعدل عند الاستخدام المكثف.
إذا كنت تستخدم Termbridge كثيرًا، فأعدّ نفقًا مسمى باستخدام حسابك على Cloudflare.
لماذا تستخدم نفقًا مسمى؟
- بلا حدود للمعدل: قد تُرجع Quick Tunnels أخطاء 429 عند الاستخدام المكثف
- URL ثابت: احصل على نطاق فرعي ثابت بدلًا من سلاسل عشوائية
- نطاق مخصص: استخدم نطاقك مثل
term.example.com - موثوقية أفضل: الأنفاق المسماة أكثر استقرارًا للجلسات الطويلة
الإعداد
1. أنشئ حسابًا على Cloudflare
سجّل في cloudflare.com إذا لم يكن لديك حساب.
2. أنشئ نفقًا في Zero Trust
- انتقل إلى Cloudflare Zero Trust
- انتقل إلى Networks → Tunnels
- انقر Create a tunnel
- اختر Cloudflared كموصل
- سمّ النفق (مثل e.g أو
termbridge) - انسخ رمز النفق
3. أضف اسم مضيف عام
- في إعدادات النفق، انتقل إلى Public Hostname
- أضف اسم مضيف يشير إلى
http://localhost:8080(أو المنفذ الذي تختاره) - استخدم نطاقًا فرعيًا مثل
term.example.com
4. شغّل Termbridge باستخدام الرمز
سطر الأوامر
termbridge --port 8080 --tunnel-token <TOKEN> --tunnel-url https://term.example.com
أو استخدم متغيرات البيئة:
سطر الأوامر
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 عام:
سطر الأوامر
termbridge --no-tunnel --public-url https://your-server.com
أو:
سطر الأوامر
export TERMBRIDGE_TUNNEL=none
export TERMBRIDGE_PUBLIC_URL=https://your-server.com
termbridge
سيتخطى Termbridge بدء نفق، وسيستخدم URL الذي توفره لرمز QR.
استكشاف الأخطاء وإصلاحها
"429 طلبات كثيرة جدًا"
يعني هذا أن Quick Tunnels تفرض حدودًا على المعدل. الحلول:
- انتظر بضع دقائق ثم أعد المحاولة
- أنهِ أي عمليات
cloudflaredقديمة:pkill cloudflared - انتقل إلى نفق مسمى (موصى به)
بدأ النفق لكن URL لا يعمل
- تحقق من أن اسم المضيف في Cloudflare يطابق
--tunnel-url - تحقق من أن المنفذ في Cloudflare يطابق
--port - تأكد من تحديث cloudflared:
cloudflared update
النفق المسمى لا يتصل
- تحقق من صحة الرمز
- افحص لوحة معلومات Cloudflare Zero Trust بحثًا عن أخطاء
- حاول تشغيل
cloudflared tunnel run <TOKEN>مباشرةً للاطلاع على رسائل الخطأ