Before you startশুরুর আগে

You only need two free accounts:

শুধু দুটি ফ্রি অ্যাকাউন্ট লাগবে:

1Create a Google Cloud projectGoogle Cloud project তৈরি করুন

1. Open console.cloud.google.com/projectcreate.
2. Type any name (for example my-mirror) and click Create.
3. Make sure the new project is selected at the top, then open the Google Drive API page and click Enable.

1. console.cloud.google.com/projectcreate খুলুন।
2. যেকোনো নাম দিন (যেমন my-mirror), তারপর Create চাপুন।
3. উপরে নতুন project সিলেক্ট আছে কিনা দেখে নিন। তারপর Google Drive API পেজে গিয়ে Enable চাপুন।

2Set up the consent screenConsent screen সেটআপ করুন

1. After Enable, Google opens the Google Drive API details page (it has a Create credentials button). Don't use that button. Click OAuth consent screen in the left menu, or open Google Auth Platform.
2. If you see Get started: enter an app name (anything), pick your email as User support email, choose External, add your email as contact, accept the policy and click Create.
   If you see an Overview page instead, the app is already set up. Go on to the next step.
3. Open Branding and fill in the App domain links below. Leave App logo empty: a logo forces Google's verification review.

4. Click Save at the bottom of Branding.
5. Open Audience, click Publish app, then Confirm. Publishing status must say In production. You don't need to add test users.

1. Enable চাপার পর Google Google Drive API-এর details পেজ খোলে (সেখানে Create credentials বাটন থাকে)। ওই বাটন চাপবেন না। বাম মেনুতে OAuth consent screen চাপুন, অথবা Google Auth Platform খুলুন।
2. Get started দেখালে: একটি app name (যেকোনো) দিন, User support email-এ আপনার email বেছে নিন, External বেছে নিন, contact হিসেবে আপনার email দিন, policy মেনে Create চাপুন।
   Get started-এর বদলে Overview পেজ দেখালে app আগেই সেটআপ হয়ে গেছে। পরের ধাপে যান।
3. Branding খুলে নিচের App domain লিংকগুলো দিন। App logo খালি রাখুন: logo দিলে Google-এর verification review লাগে।

4. Branding-এর নিচে Save চাপুন।
5. Audience খুলে Publish app, তারপর Confirm চাপুন। Publishing status-এ অবশ্যই In production দেখাতে হবে। Test user যোগ করার দরকার নেই।

3Create the OAuth clientOAuth client তৈরি করুন

1. In Google Auth Platform open Clients → Create client (or click Create OAuth client on the Overview page).
2. Application type: Web application.
3. Under Authorized redirect URIs click Add URI and paste exactly:

1. Google Auth Platform-এ Clients → Create client খুলুন (অথবা Overview পেজের Create OAuth client চাপুন)।
2. Application type: Web application।
3. Authorized redirect URIs-এ Add URI চাপুন এবং হুবহু এটি পেস্ট করুন:

https://gmirror.xkaf.org/

4. Click Create. Copy the Client ID and Client secret right away (or click Download JSON). You will paste them into the generator. Google shows the secret only in this dialog; if you lose it, open the client and click Add secret.

4. Create চাপুন। সাথে সাথে Client ID আর Client secret কপি করুন (অথবা Download JSON চাপুন), জেনারেটরে লাগবে। Secret শুধু এই dialog-এ একবার দেখায়; হারিয়ে গেলে client খুলে Add secret চাপুন।

4Build your worker.jsworker.js তৈরি করুন

Open the generator and go through the five steps:

জেনারেটর খুলে পাঁচটি ধাপ পূরণ করুন:

1. Google login: paste the Client ID and secret, keep Read-only, click Sign in with Google and allow access. Google may show “Google hasn't verified this app”: click Advanced → Go to … (unsafe). That is normal, because it is your own app.
2. Drives: click Load my Shared Drives, or add My Drive, or paste any folder link. Give each a name. A password is optional.
3. Site look: title, description and colors. You can change them later.
4. Security: set an admin password so you can use /admin later. Leave the rest as it is if unsure.
5. Download: click Generate worker.js and download the file.

1. Google লগইন: Client ID আর secret বসান, Read-only রাখুন, Google দিয়ে সাইন ইন চেপে অনুমতি দিন। Google “Google hasn't verified this app” দেখাতে পারে: Advanced → Go to … (unsafe) চাপুন। এটা স্বাভাবিক, কারণ app-টা আপনার নিজের।
2. ড্রাইভ: Shared Drive লোড করুন চাপুন, অথবা My Drive বা যেকোনো ফোল্ডার লিংক যোগ করুন। প্রতিটির নাম দিন। পাসওয়ার্ড ঐচ্ছিক।
3. সাইটের রূপ: নাম, বিবরণ আর রং। পরে বদলানো যাবে।
4. নিরাপত্তা: একটি admin পাসওয়ার্ড দিন, যাতে পরে /admin ব্যবহার করতে পারেন। নিশ্চিত না হলে বাকি সব যেমন আছে রাখুন।
5. ডাউনলোড: worker.js তৈরি করুন চেপে ফাইলটি ডাউনলোড করুন।

5Deploy on Cloudflare WorkersCloudflare Workers-এ deploy করুন

1. Log in to Cloudflare → Workers & Pages → Create.
2. Choose Create Worker (Start with Hello World), give it a name like my-mirror, click Deploy.
3. Click Edit code. Select all the sample code, delete it, paste your whole worker.js.
4. Click Deploy. Open the ….workers.dev link. Your mirror is live!

1. Cloudflare → Workers & Pages → Create-এ লগইন করুন।
2. Create Worker (Start with Hello World) বেছে নিন, my-mirror-এর মতো একটি নাম দিয়ে Deploy চাপুন।
3. Edit code চাপুন। নমুনা কোড সব সিলেক্ট করে মুছে দিন, তারপর পুরো worker.js পেস্ট করুন।
4. Deploy চাপুন। ….workers.dev লিংকটি খুলুন। আপনার মিরর চালু!

Prefer the command line? (Wrangler)

কমান্ড লাইন পছন্দ? (Wrangler)

Put worker.js in a folder with this wrangler.toml:

worker.js-এর পাশে এই wrangler.toml ফাইলটি রাখুন:

name = "my-mirror"
main = "worker.js"
compatibility_date = "2025-06-01"

[[kv_namespaces]]
binding = "XKAF_KV"
id = "PASTE_KV_ID_HERE"

npm i -g wrangler
wrangler login
wrangler kv namespace create XKAF_KV   # paste the id into wrangler.toml
wrangler deploy

6Add KV storage (recommended)KV storage যোগ করুন (প্রস্তাবিত)

KV lets you edit settings live from /admin and see download statistics.

KV থাকলে /admin থেকে সরাসরি সেটিং বদলানো যায় আর ডাউনলোড পরিসংখ্যান দেখা যায়।

1. In Cloudflare go to Storage & Databases → KV → Create. Any name is fine.
2. Open your Worker → Settings → Bindings → Add → KV namespace.
3. Variable name: XKAF_KV (exactly). Pick the namespace you just made. Deploy.

1. Cloudflare-এ Storage & Databases → KV → Create-এ যান। যেকোনো নাম দিন।
2. আপনার Worker খুলে Settings → Bindings → Add → KV namespace-এ যান।
3. Variable name হুবহু XKAF_KV দিন। এইমাত্র বানানো namespace বেছে নিয়ে Deploy চাপুন।

7Use your own domain (optional)নিজের ডোমেইন ব্যবহার (ঐচ্ছিক)

1. Your domain must be added to the same Cloudflare account.
2. Open your Worker → Settings → Domains & Routes → Add → Custom domain.
3. Type e.g. files.example.com and click Add domain. DNS and SSL are set up for you within a few minutes.

1. আপনার ডোমেইন একই Cloudflare অ্যাকাউন্টে যুক্ত থাকতে হবে।
2. Worker খুলে Settings → Domains & Routes → Add → Custom domain-এ যান।
3. যেমন files.example.com লিখে Add domain চাপুন। কয়েক মিনিটে DNS আর SSL নিজে থেকেই সেট হয়ে যাবে।

8Manage it from /admin/admin থেকে পরিচালনা

Open https://your-mirror/admin and log in with your admin password. From there you can:

https://your-mirror/admin খুলে admin পাসওয়ার্ড দিয়ে লগইন করুন। সেখান থেকে আপনি পারবেন:

• Add, rename, hide or password-protect drives
• Change title, colors, logo, announcement banner and homepage text
• Turn features on or off (search, video player, previews…)
• See download statistics, purge the cache, back up settings

• ড্রাইভ যোগ, নাম বদল, লুকানো বা পাসওয়ার্ড দেওয়া
• নাম, রং, লোগো, ঘোষণা ব্যানার আর হোমপেজ লেখা বদলানো
• ফিচার চালু/বন্ধ করা (সার্চ, ভিডিও প্লেয়ার, প্রিভিউ…)
• ডাউনলোড পরিসংখ্যান দেখা, cache purge করা, সেটিং ব্যাকআপ নেওয়া

Advanced: keep secrets out of the codeঅ্যাডভান্সড: কোডের বাইরে secret রাখা

Tick Keep secrets out of the code in step 4 if you store worker.js in Git. The generator then shows values to add in your Worker under Settings → Variables and Secrets → Add → Secret:

worker.js Git-এ রাখলে ধাপ ৪-এ কোডের বাইরে secret রাখুন টিক দিন। জেনারেটর তখন কিছু মান দেখাবে, যেগুলো Worker-এর Settings → Variables and Secrets → Add → Secret-এ যোগ করবেন:

Updating to a new versionনতুন ভার্সনে আপডেট

Settings saved in /admin live in KV and survive updates. The easiest way:

/admin-এ সেভ করা সেটিং KV-তে থাকে, আপডেটে মুছে যায় না। সবচেয়ে সহজ উপায়:

1. In /admin → Backup, click Download settings.json.
2. Generate a fresh worker.js here and paste it into your Worker (Edit code → Deploy).
3. If anything is missing, use Import JSON in /admin → Backup and press Save.

1. /admin → Backup-এ Download settings.json চাপুন।
2. এখানে নতুন করে worker.js তৈরি করে Worker-এ পেস্ট করুন (Edit code → Deploy)।
3. কিছু হারিয়ে গেলে /admin → Backup-এ Import JSON দিয়ে ফাইলটি দিন, তারপর Save চাপুন।

Cloudflare free plan limitsCloudflare ফ্রি প্ল্যানের সীমা