🌐 Public Access: Gamit ang Sarili Mong Domain + Cloudflare

Kapag pinapatakbo mo ang OKNote sa NAS sa bahay, ma-a-access mo lang ito sa local network mo bilang default. Para mabuksan ang OKNote mo mula sa opisina, sa biyahe, kahit saan, kailangan mo ng "public mapping." May built-in na Cloudflare Tunnel na option ang OKNote:

• Hindi kailangan ng public IP at hindi kailangan mag-port forward sa router — okay lang kahit carrier-grade NAT / private IP lang ang ibinigay ng ISP mo;
• Gumagamit ng sarili mong domain para sa address (hal. https://notes.example.com), dumadaan sa encrypted na tunnel ng Cloudflare — secure at stable.

Prerequisites: kakayahan ito ng Family plan pataas; hindi kasama sa Free. Bukod dito, kailangang server build (NAS / desktop server) ang gagamitin bilang tunnel host; tumatakbo sa sandbox ang Mac App Store IAP edition kaya hindi ito puwedeng maging tunnel host.

Kumpleto ang lahat sa 4-step na wizard sa ilalim ng Settings → Public Mapping → "Set up public access · Bring your own domain." Narito ang step-by-step. Ang pinaka-kritikal na parte ay ang Step 3, pagkuha ng token — basahing mabuti at hindi ka matitigil.

Step 1: Ihanda ang domain mo

Kailangan mo ng sarili mong domain para gawan ng address.

• May domain ka na (binili sa GoDaddy, Namecheap, Aliyun, atbp.) → gamitin ito, tumuloy sa Step 2.
• Wala pang domain → bumili sa Cloudflare Registrar, GoDaddy, o iba pang site; karaniwang ilang dolyar lang kada taon. Gagana ang .com / .top / .xyz.

Step 2: I-add ang domain mo sa Cloudflare

Sa hakbang na ito, ibibigay mo sa Cloudflare ang DNS management ng domain mo.

1. Mag-sign up at mag-log in sa Cloudflare dashboard (libre).
2. I-click ang Add a site (magdagdag ng site) at ilagay ang domain mo.
3. Piliin ang Free na plan. Bibigyan ka ng Cloudflare ng dalawang nameserver (DNS server) address.
4. Bumalik sa kung saan mo binili ang domain at palitan ang nameserver nito ng dalawang binigay ng Cloudflare:
   • GoDaddy: My Domains → buksan ang Domain Settings ng domain → Nameservers → Change → piliin ang Custom → ilagay ang dalawa, i-save.
   • Namecheap / iba pa: hanapin ang setting na "Nameservers", lumipat sa Custom DNS, ilagay ang dalawa, i-save.
5. Hintayin na maging Active ang status ng domain sa Cloudflare — kadalasang ilang minuto hanggang ilang oras.

Kung sa Cloudflare Registrar mo binili ang domain, automatic na naka-connect na ito — puwede mong laktawan ang hakbang na ito.

Step 3: Gumawa ng API Token (🔑 ang pinaka-kritikal na hakbang)

Bibigyan nito ng "susi" ang OKNote para awtomatiko itong makagawa ng tunnel at makapag-configure ng DNS sa ilalim ng domain mo. Dito nakapaloob ang buong hirap, at nakasalalay lahat sa pagbibigay ng tamang permission.

1. Buksan ang Cloudflare API Tokens page.

2. I-click ang Create Token → mag-scroll pababa hanggang sa ilalim, Create Custom Token → Get started.

3. Sa ilalim ng Permissions, idagdag ang tatlong row na ito nang eksakto (i-click ang "+ Add more" para sa karagdagang row):

   Column 1 (grupo)	Column 2 (item)	Column 3 (level)
   Account	Cloudflare Tunnel	Edit
   Zone	DNS	Edit
   Zone	Zone	Read

   Kailangan lahat ng tatlo: pinapayagan ng row 1 ang OKNote na gumawa ng tunnel, pinapayagan ng row 2 na i-configure ang DNS ng access domain mo, at pinapayagan ng row 3 na mabasa ang listahan ng mga domain mo.

4. Sa ibaba nito:

   • Account Resources: piliin ang sarili mong account.
   • Zone Resources: piliin ang domain na gagamitin mo (o All zones).

5. I-click ang Continue to summary → Create Token, tapos kopyahin ang nagawang token.

   ⚠️ Isang beses lang ipapakita ang token. Kopyahin ito bago umalis sa page — kung mawala ito, kailangan mo na lang gumawa ng bago.

6. Dalhin ang kinopyang token sa Step 4 ng wizard.

Step 4: I-fill up at i-activate

Bumalik sa wizard ng OKNote, Step 4:

1. Domain: ang root domain mo, hal. example.com (walang https://, walang subdomain).
2. Subdomain: ang access prefix mo, default ay notes. Habang nagta-type ka, ipapakita nang live ng wizard ang address mo, hal. https://notes.example.com.
3. Cloudflare API Token: i-paste ang token mula sa Step 3.
4. I-click ang Verify domain and token — kapag successful, may makikita kang berdeng "Verified, ready to activate.".

   Nabibigo ang verification? Malamang may kulang na permission row sa Step 3, o mali ang type ng domain / hindi pa Active. Bumalik at i-check ang tatlong row.

5. I-click ang Activate. Pagkalipas ng ilang sandali, magiging live na ang public address mo.

Mula noon, buksan lang ang https://notes.your-domain sa kahit anong network para ma-access ang OKNote na ito.

FAQ

• Kailangan ko ba talaga ng domain? Oo — kailangan ng sarili mong domain sa bring-your-own-domain (ilang dolyar lang kada taon). Sa ganitong paraan, sarili mong address ito — malinis at stable.
• Palaging nabibigo ang verification? I-check nang sunud-sunod: ① kompleto ba ang tatlong permission row sa Step 3 at tugma ang group/item/level; ② Active na ba ang domain sa Cloudflare; ③ walang typo sa domain at kompleto ang na-copy na token.
• Na-activate na pero hindi pa mabuksan? Nangangailangan ng kaunting oras ang DNS para mag-propagate pagkatapos ikonekta ang domain; siguraduhing online ang server mismo at may internet access (ang server ang gumagawa ng tunnel papunta sa Cloudflare).
• Papalitan ang domain / papatayin ito? Bumalik sa Settings → Public Mapping para i-reconfigure o i-disable ang public access.

📸 Paminsan-minsang inililipat ng Cloudflare ang posisyon ng mga button, pero hindi nagbabago ang core — ang "Create Custom Token" kasama ang tatlong permission row sa itaas. Sundan mo lang ang permission table at okay ka na.

---

Dito na nagtatapos ang mga gabay 🎉 Malaya mong ma-e-edit o matatanggal ang mga note na ito — walang maaapektuhang function. I-enjoy ang OKNote!