Deployment: HTTPS နောက်ကွယ်ရှိ payment domain
polysiad run သည် loopback port နှစ်ခုတွင် အရာနှစ်ခုကို ဝန်ဆောင်သည် —
| Listener | မူလ | ဘာလဲ | ဘယ်သူ ဝင်ခွင့်ရှိလဲ |
|---|---|---|---|
API_ADDR | 127.0.0.1:8081 | /v1/* (API)၊ /pay/* (ငွေပေးချေရန် စာမျက်နှာ)၊ /l/* (payment link) | internet — သင့် HTTPS reverse proxy မှတစ်ဆင့်သာ |
DASHBOARD_ADDR | 127.0.0.1:8080 | admin dashboard (key များ၊ ငွေထုတ်မှု၊ setting များ) | သင်တစ်ယောက်တည်း — SSH tunnel သို့မဟုတ် VPN |
Dashboard (port 8080) ကို ဘယ်တော့မှ public မလုပ်ပါနှင့် — proxy ဖြင့်လည်း မဟုတ်၊ firewall rule ဖြင့်လည်း မဟုတ်၊
DASHBOARD_ADDR=0.0.0.0:…ဖြင့်လည်း မဟုတ်။ ၎င်းက ငွေထုတ်မှုနှင့် API key များကို ထိန်းချုပ်သည်။ssh -L 8080:127.0.0.1:8080 you@serverဖြင့် ချိတ်ပြီးhttp://127.0.0.1:8080ကို ဖွင့်ပါ။ Proxy သည် port 8081 ၏/v1/*၊/pay/*နှင့်/l/*ကို သာ လွှဲပေးပြီး ကျန်အားလုံးကို 404 ပြန်သည်။DASHBOARD_ALLOW_REMOTE=1မထားလျှင်polysiadက loopback မဟုတ်သောDASHBOARD_ADDRကို ငြင်းသည်၊ ထားလျှင်လည်း စတိုင်း warning ထုတ်သည်။
၁. DNS၊ firewall၊ .env
- DNS:
pay.example.com→ သင့် server။ Firewall: 80 နှင့် 443 (နှင့် SSH) ကို ခွင့်ပြုပါ။ 8080 နှင့် 8081 ပိတ်ထားပါ။ backend/.env:API_ADDR=127.0.0.1:8081 API_PUBLIC_URL=https://pay.example.com API_TRUST_PROXY=1 # TRUSTED_PROXIES=127.0.0.1,::1 (default; set the proxy's IP/CIDR if it runs on another host) DASHBOARD_ADDR=127.0.0.1:8080API_PUBLIC_URLကpay_url/ payment link URL များကို အပြည့်အစုံ (absolute) ဖြစ်စေပြီး HSTS ကို ဖွင့်ပေးသည်။
၂က. Caddy (Let's Encrypt အလိုအလျောက်)
/etc/caddy/Caddyfile:
pay.example.com {
encode gzip
@polysia path /v1/* /pay/* /l/*
reverse_proxy @polysia 127.0.0.1:8081
respond 404
}sudo systemctl reload caddy။ Caddy သည် X-Forwarded-For / X-Forwarded-Proto ကို မူလအတိုင်း မှန်ကန်စွာ သတ်မှတ်ပေးသည်။
၂ခ. Nginx (+ certbot)
/etc/nginx/sites-available/polysia:
server {
listen 443 ssl http2;
server_name pay.example.com;
ssl_certificate /etc/letsencrypt/live/pay.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/pay.example.com/privkey.pem;
client_max_body_size 32k;
location ~ ^/(v1|pay|l)/ {
proxy_pass http://127.0.0.1:8081;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $remote_addr; # overwrite — never append a client-supplied value
proxy_set_header X-Forwarded-Proto https;
}
location / { return 404; } # dashboard and anything else: not here
}
server { listen 80; server_name pay.example.com; return 301 https://$host$request_uri; }sudo certbot --nginx -d pay.example.com၊ ထို့နောက် sudo nginx -t && sudo systemctl reload nginx။
၃. စစ်ဆေးခြင်း
curl -sS https://pay.example.com/v1/health # {"ok":true}
curl -s -o /dev/null -w '%{http_code}\n' https://pay.example.com/ # 404
curl -s -o /dev/null -w '%{http_code}\n' https://pay.example.com/login # 404 (dashboard is not reachable)
curl -s -o /dev/null -w '%{http_code}\n' http://pay.example.com:8080/ # 000 (connection refused / filtered)polysiad log ထဲတွင် API_TRUST_PROXY / X-Forwarded-Proto / DASHBOARD_ADDR warning များ မရှိရပါ။
Proxy setting များ ဘာကြောင့် အရေးကြီးသလဲ
API သည် client IP အလိုက် rate limit လုပ်ပြီး မှားယွင်းသော API key များ ထပ်ခါထပ်ခါ ပို့သော IP ကို ပိတ်သည်။ Client IP ကို X-Forwarded-For မှ ဖတ်ခြင်းကို API_TRUST_PROXY=1 ထားပြီး TCP peer သည် TRUSTED_PROXIES ထဲတွင် ပါမှ သာ လုပ်သည် (ညာမှ ဘယ်သို့ ဖတ်ပြီး ယုံကြည်ရသော proxy များကို ကျော်သည် — ဘယ်ဘက်တွင် လိမ်ထည့်ထားသော တန်ဖိုးကို ဘယ်တော့မှ မသုံးပါ)။ Proxy ရှေ့တွင်ရှိပြီး ဤ setting မထားလျှင် request အားလုံး proxy ထံမှ လာသကဲ့သို့ ဖြစ်သွားပြီး တိုက်ခိုက်သူ တစ်ယောက်က customer အားလုံးကို ပိတ်ပစ်နိုင်သည်။ API_TRUST_PROXY=1 မပါဘဲ API_PUBLIC_URL ထားလျှင်၊ ယုံကြည်မရသော peer က X-Forwarded-For ပို့လျှင်၊ request အားလုံးနီးပါး IP တစ်ခုတည်းမှ လာလျှင် နှင့် API_PUBLIC_URL က https ဖြစ်သော်လည်း request များတွင် X-Forwarded-Proto: https မပါလျှင် polysiad က warning ထုတ်သည်။