منصوبے کے بارے میں

# Cloudflare Tunnel کلائنٹ (cloudflared) `cloudflared` Cloudflare Tunnel کا سرکاری کمانڈ لائن کلائنٹ ہے۔ یہ Cloudflare نیٹ ورک اور آپ کے اوریجن (مثلاً، ویب سرور) کے درمیان ایک ڈیمن کے طور پر چلتا ہے، جس سے Cloudflare کلائنٹ کی درخواستوں کو آپ کے اوریجن تک روٹ کر سکتا ہے بغیر آپ کو اپنے فائر وال پر ان باؤنڈ پورٹس کھولنے کی ضرورت کے۔ آپ کا اوریجن جتنا ممکن ہو بند رہ سکتا ہے۔ ## اہم خصوصیات - **محفوظ ٹنلنگ**: Cloudflare کے ایج سے آپ کے اوریجن تک HTTP/ویب ساکٹ ٹریفک کو صرف آؤٹ باؤنڈ کنکشن کے ذریعے پراکسی کرتا ہے۔ - **لیئر 4 تک رسائی**: `cloudflared access` کمانڈز کے ذریعے، یا WARP کلائنٹ کے ذریعے پرائیویٹ اوریجنز کے لیے، ٹنل سے محفوظ اوریجنز تک TCP ٹریفک (مثلاً، SSH، RDP) کو سپورٹ کرتا ہے۔ - **لچکدار روٹنگ**: عوامی DNS ریکارڈز، Cloudflare لوڈ بیلنسرز، یا WARP کلائنٹس کے لیے پرائیویٹ نیٹ ورک روٹس کے ذریعے ٹنل تک ٹریفک روٹ کریں۔ - **TryCloudflare**: عارضی کوئیک ٹنل کا استعمال کرکے Cloudflare میں ویب سائٹ شامل کیے بغیر ٹنلز کی جانچ کریں۔ ## انسٹالیشن ڈاؤن لوڈ اسٹینڈ اکیلے بائنریز، Docker امیجز، اور Debian/RPM/Homebrew پیکجز کے طور پر دستیاب ہیں۔ پلیٹ فارم کے مخصوص ہدایات (macOS، Linux، Windows، Docker) کے لیے [ریلیز پیج](https://github.com/cloudflare/cloudflared/releases) اور [سرکاری دستاویزات](https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/downloads/) دیکھیں۔ سورس سے بنانے کے لیے، Go (>= 1.26) انسٹال کریں اور `make cloudflared` چلائیں۔ ## شروع کرنا 1. اپنے Cloudflare اکاؤنٹ میں ایک ویب سائٹ شامل کریں اور اس کے نام سرورز کو Cloudflare میں تبدیل کریں۔ 2. `cloudflared` انسٹال کریں۔ 3. اپنے Cloudflare اکاؤنٹ کے ساتھ تصدیق کریں۔ 4. ایک ٹنل بنائیں اور اس میں ٹریفک روٹ کریں (DNS، لوڈ بیلنسر، یا پرائیویٹ نیٹ ورک)۔ مکمل صارف دستاویزات [Cloudflare Tunnel docs](https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/) پر دستیاب ہیں۔ ## ڈیولپمنٹ - **ضروریات**: GNU Make، capnp، Go >= 1.26۔ اختیاری: capnpc-go، goimports، golangci-lint، gomocks۔ - **بلڈ**: `make cloudflared` - **ٹیسٹ**: `make test` - **لنٹ/فارمیٹ**: `make fmt` اور `make lint` - **موکس**: انٹرفیس تبدیلیوں کے بعد `make mocks`۔ - **Git ہکس**: ہر پش سے پہلے fmt-check، lint، اور ٹیسٹ چلانے کے لیے `make install-hooks`۔ ## سپورٹ اور ورژننگ Cloudflare حالیہ ریلیز کے ایک سال کے اندر کے ورژنز کو سپورٹ کرتا ہے۔ بریکنگ تبدیلیاں (CLI فلیگز، env vars، config keys، یا کمانڈز کا ہٹانا) [Cloudflare Tunnel changelog](https://developers.cloudflare.com/changelog/product/tunnel/) میں اعلان کی جاتی ہیں۔