docs
ဤစာမျက်နှာတွင်

Deployment: HTTPS နောက်ကွယ်ရှိ payment domain

polysiad run သည် loopback port နှစ်ခုတွင် အရာနှစ်ခုကို ဝန်ဆောင်သည် —

Listenerမူလဘာလဲဘယ်သူ ဝင်ခွင့်ရှိလဲ
API_ADDR127.0.0.1:8081/v1/* (API)၊ /pay/* (ငွေပေးချေရန် စာမျက်နှာ)၊ /l/* (payment link)internet — သင့် HTTPS reverse proxy မှတစ်ဆင့်သာ
DASHBOARD_ADDR127.0.0.1:8080admin 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:8080

    API_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 ထုတ်သည်။