S3 Channel شامل کریں

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

S3 channel اس وقت استعمال کریں جب:

• آپ کوئی بھی S3-compatible object storage service connect کرنا چاہتے ہیں، جیسے Cloudflare R2، Backblaze B2، MinIO، AWS S3، یا کوئی اور compatible provider۔
• آپ standard S3 configuration model پسند کرتے ہیں: Endpoint، Access Key، اور Secret Key۔
• آپ native Cloudflare R2 binding channel استعمال نہیں کرنا چاہتے، یا آپ کا storage provider Cloudflare R2 نہیں ہے۔

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

ضرورت	مقصد
S3 Endpoint	object storage service کا S3 API endpoint۔
Bucket name	وہ bucket جہاں files محفوظ ہوں گی۔
Region	storage region۔ Cloudflare R2 کے لیے عموماً auto ہوتا ہے۔
Access Key ID	S3 access key ID۔
Secret Access Key	S3 secret access key۔
CDN domain	file access کے لیے optional custom domain۔

Cloudflare R2 کو S3 API کے ذریعے استعمال کرنے کی مثال:

Endpoint: https://your-account-id.r2.cloudflarestorage.com
Bucket: your-r2-bucket-name
Region: auto
Access Key ID: copied from the Cloudflare R2 API token
Secret Access Key: copied from the Cloudflare R2 API token

کہاں شامل کریں

1. System Settings کھولیں۔
2. Upload Settings میں جائیں۔
3. اوپر دائیں طرف Add Channel پر کلک کریں۔
4. S3 منتخب کریں۔

Field Reference

Field	کام	Required
Channel name	اس S3 channel کا واضح نام، مثلاً s3test یا R2-S3۔	Yes
Enable channel	یہ کنٹرول کرتا ہے کہ channel upload selection میں شامل ہو یا نہیں۔	Recommended
Endpoint	مکمل S3 service endpoint، https:// سمیت۔	Yes
Custom CDN domain	Optional۔ set ہونے پر generated file links اس domain کو ترجیح دیتے ہیں۔	No
Bucket name	bucket name، مثلاً s3test یا img-r2۔	Yes
Bucket region	Region۔ Cloudflare R2 کے لیے عموماً auto۔	Yes
Access Key ID	S3 access key ID۔	Yes
Secret Access Key	S3 secret access key۔	Yes
Path-style access	compatibility switch۔ default off ہے۔ کچھ MinIO، OpenList، یا self-hosted S3 services کو اس کی ضرورت ہو سکتی ہے۔	No
Quota limit	capacity کی بنیاد پر S3 channel کو upload selection میں شامل یا خارج کرنے کے لیے۔	No
Capacity limit	quota limit enabled ہونے کے بعد required، مثلاً 10 GB۔	Required when quota limit is enabled
Threshold	usage اس percentage تک پہنچنے کے بعد لکھنا روک دیتا ہے، مثلاً 90%۔	Required when quota limit is enabled
Remark	اپنی maintenance کے لیے notes۔	No

Cloudflare R2 S3 API Keys بنائیں

1. Cloudflare Dashboard کھولیں۔
2. R2 Object Storage میں جائیں۔
3. Manage R2 API Tokens یا API token management entry تلاش کریں۔


4. ایسا R2 API token بنائیں جو target bucket تک access رکھتا ہو۔

5. generated Access Key ID اور Secret Access Key copy کریں۔

6. R2 bucket page پر واپس جا کر bucket name confirm کریں۔
7. account کا S3 API endpoint note کریں۔ یہ عموماً ایسا ہوتا ہے:

https://your-account-id.r2.cloudflarestorage.com

Setup Steps

1. Upload Settings کھولیں۔
2. Add Channel پر کلک کریں۔
3. S3 منتخب کریں۔
4. قابل شناخت channel name درج کریں، مثلاً s3test۔
5. Endpoint میں S3 API endpoint درج کریں۔
6. اگر custom CDN استعمال کرتے ہیں تو Custom CDN domain میں درج کریں، ورنہ خالی چھوڑ دیں۔
7. bucket name درج کریں۔
8. region درج کریں۔ Cloudflare R2 example کے لیے auto استعمال کریں۔
9. Access Key ID اور Secret Access Key درج کریں۔
10. path-style access کو off رہنے دیں، جب تک provider واضح طور پر require نہ کرے۔
11. capacity control چاہیے تو quota limit enable کریں اور capacity limit / threshold درج کریں۔
12. Save پر کلک کریں۔

Verify کیسے کریں

Check	Verify کرنے کا طریقہ
Channel card appears	Save کے بعد Upload Settings میں S3 channel card دکھائی دینا چاہیے۔
Channel is enabled	card کے اوپر دائیں switch کو on رہنا چاہیے۔
Key fields are saved	detail view میں Endpoint، Bucket، Region، path-style access، اور متعلقہ fields دکھنے چاہئیں۔
Upload works	test image upload کریں اور confirm کریں کہ object target bucket میں آیا ہے۔
Link opens	upload کے بعد returned image link عام طور پر کھلنا چاہیے۔
Capacity display works	quota limit enabled ہو تو card used capacity اور configured limit دکھائے۔

S3 capacity statistics provider bucket کو real time query کر کے نہیں بلکہ ImgBed کے local file records سے calculate ہوتے ہیں۔ S3 configuration save کرنے کے بعد system current D1 records سے quota ledger دوبارہ calculate کرتا ہے۔

FAQ

کیا path-style access enable کرنا چاہیے؟

عام طور پر نہیں۔

صرف اس وقت enable کریں جب آپ کا S3-compatible provider virtual-hosted-style URLs support نہ کرے، یا provider documentation واضح طور پر path-style access require کرے۔ کچھ MinIO، self-hosted S3، اور OpenList-compatible endpoints کو یہ چاہیے ہو سکتا ہے۔

CDN domain کس لیے ہے؟

اگر آپ bucket کے آگے CDN یا custom access domain رکھتے ہیں تو اسے یہاں درج کریں۔

configuration کے بعد generated file links اس domain کو ترجیح دیں گے۔ اگر CDN استعمال نہیں کر رہے تو field خالی چھوڑ دیں۔

upload کیوں fail ہوتا ہے؟

سب سے پہلے یہ items چیک کریں:

1. Endpoint مکمل https:// URL کے ساتھ ہے۔
2. bucket name درست ہے۔
3. Region provider requirement کے مطابق ہے۔
4. Access Key ID اور Secret Access Key مکمل copy کیے گئے ہیں۔
5. key کو target bucket پر write permission ہے۔
6. provider کو path-style access کی ضرورت نہیں، یا ضرورت ہو تو path-style access enabled ہے۔

Quick Checklist

S3 Endpoint, Bucket, Region, Access Key, اور Secret Key تیار کریں
-> Upload Settings کھولیں
-> Add Channel
-> S3 منتخب کریں
-> Endpoint / Bucket / Region / Access Key / Secret Key درج کریں
-> ضرورت ہو تو CDN domain درج کریں
-> default طور پر path-style access off رہنے دیں
-> ضرورت ہو تو quota limit enable کریں
-> Save کریں
-> test image upload کر کے نتیجہ چیک کریں