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 + 上面那三行权限」这个核心不会变，认准权限表就不会错。

指南到此结束 🎉 这些笔记都可以随意编辑或删除，不影响任何功能。祝你用得顺手！