၀။ ကြိုတင်ပြင်ဆင်မှု
1 D1 Database ဖန်တီးခြင်း
- Cloudflare ဘယ်ဘက် menu တွင် Storage & Databases → D1 SQL Database သို့ ဝင်ပါ။
- Create Database ကို click ပြီး အမည် ဥပမာ
appstoy2ပေးပါ။ - Project ထဲရှိ
db/schema.sqlဖိုင်ကို ဖွင့်ပြီး SQL အားလုံးကို copy ကူးပါ။ - Database စာမျက်နှာရှိ Console tab သို့ ပြောင်းပြီး paste လုပ်ကာ Execute ကို click ပါ။
- Refresh လုပ်ပြီး table အရေအတွက် 11 ခန့် ဖြစ်နေပါက အောင်မြင်ပါသည်။
2 KV Namespace ဖန်တီးခြင်း
- ဘယ်ဘက် menu တွင် Workers & Pages → KV သို့ ဝင်ပါ။
- Create Namespace ကို click ပါ။
- အမည် ဥပမာ
appstoy2ပေးပြီး Save လုပ်ပါ။
3 Backend Worker Service Deploy လုပ်ခြင်း
3.1 Worker အသစ်ဖန်တီးခြင်း
- Compute → Workers & Pages သို့ ဝင်ပါ။
- Create Application → Worker ကို ရွေးပါ။
- Hello World template မှ စတင်ပြီး Deploy လုပ်ပါ။
3.2 D1 နှင့် KV ချိတ်ဆက်ခြင်း
- D1 Binding — Variable name ကို အတိအကျ
DBဟု ထားပါ။ - KV Binding — Variable name ကို အတိအကျ
KVဟု ထားပါ။ - Compatibility Flag — Settings ထဲတွင်
nodejs_compatကို ရွေးပါ။
" ကို သုံးရပါမည်။
တရုတ် double quote “ ” သုံးမိပါက Worker သည် error ဖြစ်ပြီး မစတင်နိုင်ပါ။
3.3 Backend Code Deploy လုပ်ခြင်း
GitHub Releases မှ နောက်ဆုံး worker.js ကို download လုပ်ပါ။
Worker ၏ Edit Code ထဲတွင် code အားလုံးကို အစားထိုး paste ပြီး
Save and Deploy လုပ်ပါ။ ညာဘက် test window တွင် ok ပြပါက အောင်မြင်ပါသည်။
3.4 Custom API Domain ချိတ်ဆက်ခြင်း
Worker ၏ Triggers → Custom Domains သို့ ဝင်ပြီး
ဥပမာ mail-api.yourdomain.com ကို ချိတ်ပါ။
Browser တွင် ဖွင့်ကြည့်၍ ok ထွက်ပါက API အလုပ်လုပ်နေပါပြီ။
4 Environment Variables ပြင်ဆင်ခြင်း
Worker စာမျက်နှာရှိ Settings → Variables and Secrets တွင် အောက်ပါတို့ကို ထည့်ပါ။ ဥပမာတန်ဖိုးများကို သင့် domain နှင့် စကားဝှက်ဖြင့် အစားထိုးပါ။
| Variable Name | Type | ဥပမာ / ရှင်းလင်းချက် |
|---|---|---|
ADMIN_PASSWORDS |
JSON | ["သင့် admin စကားဝှက်"] |
DOMAINS |
JSON | ["yourdomain.com"] |
DEFAULT_DOMAINS |
JSON | [] — ဧည့်သည်များ မူလအသုံးပြုနိုင်သော domain |
USER_ROLES |
JSON | [{"domains":["yourdomain.com"],"prefix":"","role":"admin"}] |
JWT_SECRET |
Plain text | ကျပန်း စာလုံးရှည်တစ်ခု |
ADMIN_USER_ROLE |
Plain text | admin |
ENABLE_USER_CREATE_EMAIL |
Plain text | true |
ENABLE_ADDRESS_PASSWORD |
Plain text | true |
ADMIN_PASSWORDS, DOMAINS, USER_ROLES စသည့်
JSON တန်ဖိုးများကို copy ကူးသည့်အခါ quote များ မှန်ကန်ကြောင်း စစ်ပါ။
5 Email Routing ပြင်ဆင်ခြင်း — Catch-all Rule
- Cloudflare console တွင် သင့် domain ကို click ပါ။
- Email → Email Routing သို့ ဝင်ပါ။
- ပထမဆုံးအကြိမ်ဖြစ်ပါက wizard အတိုင်း DNS record များ ထည့်ပါ။
- Routing Rules သို့ သွားပြီး Catch-all rule ကို Edit လုပ်ပါ။
- Action — Send to Worker ကို ရွေးပါ။
- Destination — သင့် Worker ကို ရွေးပါ။
- Save လုပ်ပြီး rule ကို Active ဖြစ်အောင် ဖွင့်ထားပါ။
6 Frontend Web Interface ကို Pages ဖြင့် Deploy လုပ်ခြင်း
- Project ၏ တရားဝင် frontend online packaging စာမျက်နှာကို ဖွင့်ပါ။
- Backend API လိပ်စာ ဥပမာ
https://mail-api.yourdomain.comကို ဖြည့်ပါ။ - အဆုံးတွင် slash
/မပါစေရန် သေချာပါ။ - Generate လုပ်ပြီး Download ကို click ကာ zip ရယူပါ။
- Cloudflare တွင် Compute → Workers & Pages → Create Application → Pages သို့ ဝင်ပါ။
- Direct Upload ကို ရွေးပြီး ဖြည်ထားသော static folder ကို drag ဆွဲထည့်ပါ။
- Deploy မလုပ်မီ Advanced Settings → 404 Handling → Single Page Application (SPA) ကို ရွေးပါ။
- Deploy လုပ်ပြီး Custom Domain တွင် ဥပမာ
mail.yourdomain.comကို ချိတ်ပါ။
7 လက်တွေ့စမ်းသပ်ခြင်း
Frontend မှ email လက်ခံခြင်း
mail.yourdomain.com ကို ဖွင့်ပါ။ ကျပန်း prefix ဖန်တီးနိုင်သည် သို့မဟုတ်
လိုချင်သော prefix ကို ကိုယ်တိုင်ရိုက်ထည့်နိုင်ပါသည်။ စကားဝှက် ဖန်တီးရန် အမှန်ခြစ်ပါက
စက်ပစ္စည်း ပြောင်းလဲသော်လည်း email လိပ်စာ + စကားဝှက်ဖြင့် ပြန်လည်ရယူနိုင်ပါသည်။
Backend Admin လျှို့ဝှက်ဝင်ပေါက်
Frontend စာမျက်နှာ ဘယ်ဘက်အပေါ်ထောင့်ရှိ Logo icon ကို
၅ ကြိမ် ဆက်တိုက် click ပါ။ Admin စကားဝှက် ရိုက်ထည့်ရန် box ပေါ်လာပါမည်။
ADMIN_PASSWORDS ထဲက စကားဝှက်ကို ရိုက်ထည့်ပါ။
Telegram Bot ချိတ်ဆက်ခြင်း
Backend ထဲတွင် Telegram Bot ကို configure လုပ်နိုင်ပါသည်။ Configure ပြီးပါက ဖုန်းပေါ်တွင် Telegram ဖွင့်ပြီး email အသစ်ဖန်တီးခြင်း၊ email ကြည့်ခြင်း၊ အတည်ပြုကုဒ် လက်ခံခြင်းတို့ကို တိုက်ရိုက် ပြုလုပ်နိုင်ပါသည်။
8 သတိပြုရမည့်အချက်များ
- Email ပို့ခြင်း: ဤနည်းလမ်းသည် အတည်ပြုကုဒ် လက်ခံရန်အတွက် အဓိကဖြစ်သည်။ Cloudflare သည် မူလအားဖြင့် email လက်ခံရန်သာ ဖြစ်သည်။ Email ပို့လိုပါက Resend API စသည်ဖြင့် ထပ်ဆောင်း ချိတ်ဆက်ရပါမည်။
- တရုတ်ပြည်တွင်း network:
workers.devနှင့်pages.devအစား ကိုယ်ပိုင် subdomain ကို မဖြစ်မနေ ချိတ်ဆက်ပါ။ - အခမဲ့ quota: D1 နှင့် Workers အခမဲ့ plan သည် ကိုယ်ပိုင်အသုံးပြုရန် လုံလောက်ပါသည်။
- လုံခြုံရေး: Admin စကားဝှက်နှင့် JWT Secret ကို ခိုင်မာစွာ သတ်မှတ်ပါ။ Public repo တွင် မတင်ပါနှင့်။