Cloudflare R2 Channel شامل کریں

کب استعمال کریں

Cloudflare R2 اس وقت مناسب ہے جب:

• آپ کی ImgHost site پہلے ہی Cloudflare پر deployed ہے اور آپ اسی Cloudflare account کے R2 bucket میں files رکھنا چاہتے ہیں۔
• آپ الگ S3 endpoint، access key، اور secret key configure نہیں کرنا چاہتے۔
• آپ چاہتے ہیں کہ reads اور writes کم setup کے ساتھ Worker یا Pages R2 binding کے ذریعے چلیں۔

مختصر بات:

R2 چینل ImgHost ایڈمن پینل کے اندر دستی طور پر نہیں بنایا جاتا۔ پہلے Cloudflare project کے ساتھ R2 bucket bind کریں، اور binding variable name لازماً img_r2 ہونا چاہیے۔

شروع کرنے سے پہلے کیا چاہیے

• Cloudflare account۔
• پہلے سے موجود R2 bucket۔
• اس Cloudflare project کو manage کرنے کی permission جہاں ImgHost deployed ہے۔

Cloudflare میں Configure کریں

1. R2 Bucket بنائیں

1. Cloudflare Dashboard میں log in کریں۔
2. R2 Object Storage کھولیں۔
3. bucket بنائیں پر کلک کریں۔
4. bucket name منتخب کریں، مثلاً imgbed۔

uploaded files اسی bucket میں محفوظ ہوں گی۔

2. Bucket کو ImgHost Project سے Bind کریں

اپنی deployment type کے مطابق binding location منتخب کریں:

Deployment Type	Binding Location
Pages	Current Pages project -> Settings -> Functions -> R2 bucket bindings
Worker	Current Worker -> Settings -> Bindings -> R2 bucket bindings

binding شامل کرتے وقت اہم فیلڈز یہ ہیں:

فیلڈ	قدر
Variable name	img_r2
R2 bucket	جو bucket آپ نے بنایا ہے اسے منتخب کریں۔

Variable name بالکل img_r2 ہونا چاہیے۔ R2 files کا upload، read، اور delete سب اسی binding name پر depend کرتا ہے۔

3. Project دوبارہ Deploy کریں

binding save کرنے کے بعد ImgHost کو redeploy کریں تاکہ Worker یا Pages runtime img_r2 تک access حاصل کر سکے۔

ImgHost میں کیا نظر آئے گا

R2 binding دستیاب ہونے کے بعد کھولیں:

1. سسٹم سیٹنگز۔
2. اپ لوڈ سیٹنگز۔
3. Cloudflare R2 channel۔

نظام خود ایک فکسڈ چینل بناتا ہے:

فیلڈ	حلed قدر
Channel name	Cloudflare R2
Channel type	cfr2
Storage mode	binding
Configuration source	Environment binding

یہ فکسڈ binding چینل ہے۔ اسے بنانے کے لیے چینل شامل کریں پر کلک کرنے کی ضرورت نہیں، اور اسے عام channel کی طرح delete بھی نہیں کیا جا سکتا۔

Admin Panel میں Editable فیلڈs

فیلڈ	کام	ضروری
Enable channel	یہ کنٹرول کرتا ہے کہ R2 upload selection میں شامل ہو یا نہیں۔	ہاں
Account ID	صرف اس وقت استعمال ہوتا ہے جب quota limits فعال ہوں اور official R2 usage query کرنا ہو۔	quota limits فعال ہوں تو تجویز کردہ
Bucket name	صرف اس وقت استعمال ہوتا ہے جب quota limits فعال ہوں اور official R2 usage query کرنا ہو۔	quota limits فعال ہوں تو تجویز کردہ
Quota limit	یہ کنٹرول کرتا ہے کہ capacity کی بنیاد پر R2 چینل upload selection میں شامل ہو یا نہیں۔	نہیں
Threshold	usage مخصوص percentage تک پہنچنے کے بعد اس channel پر لکھنا روک دیتا ہے۔	quota limits فعال ہوں تو ضروری

Account ID Cloudflare dashboard کے account information panel سے کاپی کیا جا سکتا ہے۔ اسے صرف اس وقت بھریں جب آپ چاہتے ہوں کہ ImgHost R2 quota usage query اور enforce کرے۔

سیٹ اپ کے مراحل

1. Cloudflare میں R2 bucket بنائیں۔
2. ImgHost project کی Cloudflare settings کھولیں۔
3. R2 bucket binding شامل کریں۔
4. Variable name کو img_r2 رکھیں۔
5. بنایا ہوا R2 bucket منتخب کریں۔
6. binding save کریں اور ImgHost redeploy کریں۔
7. واپس ImgHost -> سسٹم سیٹنگز -> اپ لوڈ سیٹنگز میں جائیں۔
8. تصدیق کریں کہ Cloudflare R2 channel نظر آ رہا ہے اور فعال ہے۔

اگر آپ چاہتے ہیں کہ R2 capacity کی بنیاد پر upload selection میں حصہ لے، quota limit فعال کریں، پھر Account ID، bucket name، quota limit، اور threshold درج کر کے save کریں۔

Verify کیسے کریں

• fixed Cloudflare R2 channel اپ لوڈ سیٹنگز میں دکھائی دے۔
• چینل card پر فعال status دکھے۔
• چھوٹی test file کامیابی سے upload ہو اور returned link عام طور پر کھل جائے۔
• اگر file کھولنے پر R2 database binding is not configured آئے، runtime کو img_r2 binding نہیں ملی۔ Cloudflare میں binding name چیک کریں اور project redeploy کریں۔