OKNote
初步使用指南

🌐 公開網路存取：用自己的網域 + Cloudflare

在家裡的 NAS 上跑 OKNote，預設只能在區域網路裡存取。想在公司、路上、任何地方都能打開自己的 OKNote，就需要「公開網路對映」。OKNote 內建了 Cloudflare 通道方案：

  • 不需要公用 IP、不需要在路由器上做連接埠轉發，電信業者給的是內網 IP 也沒關係；
  • 用你自己的網域產生存取位址（如 https://notes.example.com），走 Cloudflare 的加密通道，安全又穩定。

前置條件：公開網路對映屬於家庭版以上才有的功能，免費版不含。另外，作為通道進入點的必須是伺服器端型態（NAS 版 / 桌面伺服器端版）；Mac App Store 內購版執行在沙盒裡，無法作為通道進入點。

整個設定在 設定 → 公開網路對映服務 → 「開通公開網路存取．自有網域接入」 的 4 步精靈裡完成。以下逐步說明，最關鍵的是第 3 步取得 Token，看仔細一點就不會卡關。

第 1 步：準備一個網域

你需要一個自己的網域，用來產生存取位址。

  • 已經有網域（在阿里雲、GoDaddy、騰訊雲等任何註冊商買的）→ 直接用，進入第 2 步。
  • 還沒有網域 → 去 Cloudflare Registrar、GoDaddy 或阿里雲買一個，一年通常幾十元。.com/.top/.xyz 都可以。

第 2 步：把網域接入 Cloudflare

這一步是讓 Cloudflare 來管理你網域的解析。

  1. 註冊並登入 Cloudflare 主控台（免費）。
  2. 點 Add a site（新增網站），輸入你的網域。
  3. 方案選 Free（免費）。Cloudflare 會給你兩個 nameserver（DNS 伺服器）位址。
  4. 回到你買網域的地方，把網域的 nameserver 改成 Cloudflare 給的那兩個：
    • 阿里雲：網域控制台 → 找到網域點「管理」→ 左側「DNS 修改」→ 刪掉原有、填入 Cloudflare 給的兩個，確認。
    • GoDaddy：My Domains → 進入網域的 Domain Settings → Nameservers → Change → 選自訂（Custom）→ 填入那兩個，儲存。
  5. 等網域狀態在 Cloudflare 裡變成 Active（已啟用），通常幾分鐘到幾小時。

如果你的網域本來就是在 Cloudflare Registrar 買的，它已經自動接入了，這步可以直接跳過。

第 3 步：建立 API Token（🔑 最關鍵的一步）

這一步是給 OKNote 一把「鑰匙」，讓它能自動在你的網域下建通道、設定解析。難點全在這裡，重點是給對權限。

  1. 打開 Cloudflare API Tokens 頁面。

  2. 點 Create Token（建立權杖） → 拉到最下面 Create Custom Token（建立自訂權杖） 的 Get started。

  3. 在 Permissions（權限） 處，照下面這三行各加一條（點 + Add more 加一行）：

    第一欄（類型） 第二欄（項目） 第三欄（權限）
    Account（帳戶） Cloudflare Tunnel Edit（編輯）
    Zone（區域） DNS Edit（編輯）
    Zone（區域） Zone（區域） Read（讀取）

    三行缺一不可：第一行讓 OKNote 能建通道，第二行讓它能設定你的存取網域解析，第三行讓它能讀到你的網域清單。

  4. 往下：

    • Account Resources（帳戶資源）：選你自己的帳戶。
    • Zone Resources（區域資源）：選 你要用的那個網域（也可以選 All zones）。

  5. 點 Continue to summary → Create Token，然後 複製產生的 Token。

    ⚠️ 這個 Token 只會顯示這一次，務必先複製下來再離開頁面。弄丟了就只能重新建立一個。

  6. 把複製好的 Token 帶到精靈第 4 步貼上。

第 4 步：填寫並開通

回到 OKNote 的精靈第 4 步：

  1. 網域：填你的主網域，如 example.com（不含 https://、不含子網域）。
  2. 子網域：你的存取前綴，預設 notes。填好後精靈會即時顯示你的存取位址，比如 https://notes.example.com。
  3. Cloudflare API Token：貼上第 3 步複製的 Token。
  4. 點 「驗證網域與 Token」——通過後會顯示綠色的「驗證通過，可開通」。

    驗證不通過？八成是第 3 步權限少了一行，或網域填錯／還沒 Active。回去核對三行權限。

  5. 點 「開通」。稍等片刻，你的公開網路位址就生效了。

之後在任何網路下打開 https://notes.你的網域，就能存取這台 OKNote 了。

常見問題

  • 一定要買網域嗎？ 是的，自有網域接入需要一個你自己的網域（一年幾十元）。這樣存取位址是你自己的、乾淨且穩定。
  • 驗證一直失敗？ 按優先順序排查：① 第 3 步三行權限是否都加了、類型／項目／權限是否對得上；② 網域在 Cloudflare 裡是不是已經 Active；③ 網域有沒有拼錯、Token 有沒有複製完整。
  • 開通後打不開？ 網域剛接入時 DNS 生效需要一點時間；確認伺服器本身在線、能上網（通道由伺服器主動向 Cloudflare 建立）。
  • 換網域 / 想關掉？ 回到 設定 → 公開網路對映服務，可以重新設定或關閉公開網路存取。

📸 Cloudflare 的介面偶爾會調整按鈕位置，但「Create Custom Token + 上面那三行權限」這個核心不會變，認準權限表就不會錯。

指南到此結束 🎉 這些筆記都可以隨意編輯或刪除，不影響任何功能。祝你用得順手！