عميل نفق Cloudflare

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

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

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

قبل البدء

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

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

تثبيت cloudflared

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

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

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

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

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

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

جرب Cloudflare

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

الإصدارات المهملة

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

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

التطوير

المتطلبات

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

البناء

لبناء cloudflared محليًا، قم بتشغيل make cloudflared

الاختبار

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

التدقيق

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

النماذج الوهمية

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

خطافات Git

لتجنب أخطاء CI، يمكنك تثبيت خطافات pre-push التي تقوم بتشغيل التدقيق والاختبارات قبل كل push:

make install-hooks

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