عميل Cloudflare Tunnel

يحتوي على عميل سطر الأوامر لـ Cloudflare Tunnel، وهو خادم نفق (tunneling daemon) يوجّه حركة المرور من شبكة Cloudflare إلى أصولك (origins). يجلس هذا الخادم بين شبكة Cloudflare وأصلك (مثل خادم ويب). تجذب Cloudflare طلبات العملاء وترسلها إليك عبر هذا الخادم، دون الحاجة إلى فتح ثقوب في جدار الحماية الخاص بك --- يمكن أن يبقى أصلك مغلقًا قدر الإمكان. يمكن العثور على وثائق موسّعة في قسم Cloudflare Tunnel من وثائق Cloudflare. جميع الاستخدامات المتعلقة بالتوجيه إلى أصولك متاحة تحت cloudflared tunnel help.

يمكنك أيضًا استخدام cloudflared للوصول إلى أصول Tunnel (المحمية بـ cloudflared tunnel) لحركة مرور TCP في الطبقة 4 (أي ليس HTTP/websocket)، وهو أمر ذو صلة بحالات استخدام مثل SSH وRDP وغيرها. هذه الاستخدامات متاحة تحت cloudflared access help.

يمكنك بدلاً من ذلك استخدام عميل WARP للوصول إلى الأصول الخاصة خلف Tunnels لحركة مرور الطبقة 4 دون الحاجة إلى أوامر cloudflared access على جانب العميل.

قبل أن تبدأ

قبل استخدام Cloudflare Tunnel، ستحتاج إلى إكمال بضع خطوات في لوحة تحكم Cloudflare: تحتاج إلى إضافة موقع ويب إلى حساب Cloudflare الخاص بك. لاحظ أنه اليوم من الممكن استخدام Tunnel دون موقع ويب (مثلًا للتوجيه الخاص)، ولكن لأسباب قديمة لا يزال هذا الشرط ضروريًا:

1. إضافة موقع ويب إلى Cloudflare
2. تغيير خوادم الأسماء (nameservers) لنطاقك إلى Cloudflare

تثبيت cloudflared

التنزيلات متاحة كملفات تنفيذية مستقلة، وصورة Docker، وحزم Debian وRPM وHomebrew. يمكنك أيضًا العثور على الإصدارات هنا في مستودع cloudflared على GitHub.

• يمكنك التثبيت على macOS عبر Homebrew أو بتنزيل أحدث إصدار Darwin amd64
• الملفات التنفيذية وحزم Debian وRPM لنظام Linux يمكن العثور عليها هنا
• صورة Docker لـ cloudflared متاحة على DockerHub
• يمكنك التثبيت على أجهزة Windows باتباع الخطوات هنا
• للبناء من المصدر، ثبّت الإصدار المطلوب من go، المذكور في قسم التطوير أدناه. ثم يمكنك تشغيل make cloudflared.

يمكن العثور على وثائق المستخدم الخاصة بـ Cloudflare Tunnel على https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/

إنشاء Tunnels وتوجيه حركة المرور

بمجرد التثبيت، يمكنك مصادقة cloudflared في حساب Cloudflare الخاص بك والبدء في إنشاء Tunnels لتقديم حركة المرور إلى أصولك.

• أنشئ Tunnel باتباع هذه التعليمات
• وجّه حركة المرور إلى ذلك Tunnel:
  • عبر سجلات DNS العامة في Cloudflare
  • أو عبر اسم مضيف عام موجّه بواسطة موازن تحميل Cloudflare
  • أو من حركة مرور عميل WARP الخاصة

TryCloudflare

هل تريد اختبار Cloudflare Tunnel قبل إضافة موقع ويب إلى Cloudflare؟ يمكنك القيام بذلك باستخدام TryCloudflare عبر الوثائق المتاحة هنا.

تغييرات كاسرة (Breaking Changes)

إزالة أعلام CLI أو متغيرات البيئة أو مفاتيح التكوين أو الأوامر تُعد تغييرًا كاسرًا. يجب الإعلان عن هذه الإزالات في سجل تغييرات Cloudflare Tunnel قبل الإصدار الذي يزيلها.

الإصدارات المهملة (Deprecated)

تدعم Cloudflare حاليًا إصدارات cloudflared التي تكون ضمن سنة واحدة من أحدث إصدار. قد يتم إدخال تغييرات كاسرة غير مرتبطة بتوفر الميزات والتي ستؤثر على الإصدارات الصادرة منذ أكثر من سنة. يمكنك قراءة المزيد حول ترقية cloudflared في وثائق المطورين الخاصة بنا.

على سبيل المثال، اعتبارًا من يناير 2023 ستدعم Cloudflare الإصدار cloudflared 2023.1.1 حتى cloudflared 2022.1.1.

التطوير

المتطلبات

• GNU Make
• capnp
• go >= 1.27
• أدوات اختيارية:
  • capnpc-go
  • goimports
  • golangci-lint
  • gomocks

البناء

لبناء cloudflared محليًا شغّل make cloudflared

الاختبار

لتشغيل الاختبارات محليًا شغّل make test

فحص الكود (Linting)

لتنسيق الكود والحفاظ على جودة كود جيدة استخدم make fmt وmake lint

المحاكيات (Mocks)

بعد إجراء تغييرات على الواجهات (interfaces) قد تحتاج إلى إعادة توليد المحاكيات، لذا شغّل make mocks

خطافات Git (Git Hooks)

لتجنب أخطاء CI، يمكنك تثبيت خطافات pre-push التي تشغّل فحص الكود والاختبارات قبل كل دفعة (push):

make install-hooks

سيؤدي هذا إلى تكوين git لاستخدام الخطافات في .githooks/ التي تشغّل make fmt-check lint test قبل كل دفعة.