S3 Channel যোগ করা

কখন সবচেয়ে উপযোগী

S3 channel ব্যবহার করুন যখন:

• Cloudflare R2, Backblaze B2, MinIO, AWS S3 বা অন্য কোনো S3-compatible object storage service connect করতে চান।
• Standard S3 configuration model পছন্দ করেন: Endpoint, Access Key এবং Secret Key।
• Native Cloudflare R2 binding channel ব্যবহার করতে চান না, বা আপনার storage provider Cloudflare R2 নয়।

শুরু করার আগে যা লাগবে

Requirement	Purpose
S3 Endpoint	Object storage service-এর S3 API endpoint।
Bucket name	যেখানে files সংরক্ষিত হবে সেই bucket।
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-এ অংশ নেবে কি না control করে।	Recommended
Endpoint	https://-সহ full S3 service endpoint।	Yes
Custom CDN domain	Optional। Set করলে generated file links এই domain prefer করবে।	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 service-এ লাগতে পারে।	No
Quota limit	Capacity অনুযায়ী এই S3 channel upload selection-এ অংশ নেবে কি না control করে।	No
Capacity limit	Quota limit enabled করার পর required, যেমন 10 GB।	Quota limit enabled হলে required
Threshold	Usage এই percentage-এ পৌঁছালে writing বন্ধ করে, যেমন 90%।	Quota limit enabled হলে required
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. Target bucket access করতে পারে এমন R2 API token তৈরি করুন।

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-এ দিন; না হলে empty রাখুন।
7. Bucket name দিন।
8. Region দিন। Cloudflare R2 example হলে auto ব্যবহার করুন।
9. Access Key ID এবং Secret Access Key দিন।
10. Provider স্পষ্টভাবে না বললে path-style access off রাখুন।
11. Capacity control চাইলে quota limit enable করে capacity limit এবং threshold দিন।
12. Save ক্লিক করুন।

কীভাবে যাচাই করবেন

Check	কীভাবে যাচাই করবেন
Channel card দেখা যায়	Save করার পর Upload Settings পেজে S3 channel card দেখা উচিত।
Channel enabled	Card-এর upper-right switch on থাকা উচিত।
Key fields save হয়েছে	Detail view-তে Endpoint, Bucket, Region, path-style access এবং related fields দেখা উচিত।
Upload কাজ করে	Test image upload করে target bucket-এ object এসেছে কি না দেখুন।
Link খোলে	Upload-এর পর পাওয়া image link normalভাবে খোলা উচিত।
Capacity display কাজ করে	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 recalculate করে।

FAQ

Path-style access enable করব?

সাধারণত না।

শুধু তখন enable করুন যখন S3-compatible provider virtual-hosted-style URLs support করে না, বা provider documentation path-style access explicitly চায়। কিছু MinIO, self-hosted S3 এবং OpenList-compatible endpoints-এ লাগতে পারে।

CDN domain কী কাজে লাগে?

Bucket-এর সামনে CDN বা custom access domain বসালে এখানে দিন।

Configure করার পর generated file links এই domain prefer করবে। CDN ব্যবহার না করলে empty রাখুন।

Upload fail হলে কী দেখব?

আগে এগুলো check করুন:

1. Endpoint full https:// URL-সহ আছে।
2. Bucket name সঠিক।
3. Region provider requirement-এর সঙ্গে match করছে।
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 করে result check করুন