OKNote
スタートガイド

🌐 外部公開:独自ドメイン + Cloudflare

自宅のNASでOKNoteを動かしている場合、デフォルトではローカルネットワークからしかアクセスできません。オフィスや外出先など、どこからでもOKNoteを開けるようにするには「外部公開」が必要です。OKNoteにはCloudflare Tunnelを使ったオプションが組み込まれています。

  • 固定グローバルIPも、ルーターのポート開放も不要です。ISPから割り当てられるキャリアグレードNAT/プライベートIPで問題ありません。
  • アドレスには独自ドメインを使用でき(例:https://notes.example.com)、Cloudflareの暗号化トンネルを経由するため安全かつ安定しています。

前提条件:外部公開はファミリープラン以上の機能で、無料プランには含まれません。また、トンネルのホストはサーバー版(NAS/デスクトップサーバー)である必要があります。Mac App Storeのアプリ内課金版はサンドボックス内で動作するため、トンネルのホストにはなれません。

すべての設定は、設定 → 外部公開 →「外部公開を設定・独自ドメインを使用」にある4ステップのウィザードで完結します。以下に手順を示します。特に重要なのはステップ3のトークン取得です。ここを注意深く読めばつまずきません。

ステップ1:ドメインを用意する

アドレスの元になる、自分自身のドメインが必要です。

  • すでに持っている場合(GoDaddy、Namecheap、Aliyunなどで購入済み)→ そのまま使い、ステップ2に進みます。
  • まだ持っていない場合→ Cloudflare Registrar、GoDaddyなどで購入します。年間数ドル程度が相場です。.com / .top / .xyz などどれでも使えます。

ステップ2:ドメインをCloudflareに追加する

このステップでは、ドメインのDNS管理をCloudflareに任せます。

  1. Cloudflareダッシュボードに登録してログインします(無料)。
  2. Add a site をクリックして、ドメインを入力します。
  3. Free プランを選びます。Cloudflareから2つのネームサーバー(DNSサーバー)アドレスが発行されます。
  4. ドメインを購入したサービスに戻り、ネームサーバーをCloudflareから発行された2つに変更します。
    • GoDaddy:My Domains → 対象ドメインの Domain Settings を開く → Nameservers → Change → Custom を選択 → 2つのアドレスを入力して保存します。
    • Namecheap / その他:「Nameservers」の設定を探し、Custom DNS に切り替えて2つのアドレスを入力し、保存します。
  5. Cloudflare上でドメインのステータスが Active になるのを待ちます。通常は数分〜数時間程度です。

最初からCloudflare Registrarでドメインを購入していた場合は、すでに接続済みなのでこのステップは不要です。

ステップ3:APIトークンを作成する(🔑 最重要ステップ)

これによってOKNoteに「鍵」が渡り、トンネルの自動構築とドメイン配下のDNS設定が可能になります。難しいのはここだけで、要は正しい権限を付与できるかどうかです。

  1. Cloudflare API Tokensページを開きます。

  2. Create Token をクリック → 一番下までスクロールし、Create Custom Token → Get started をクリックします。

  3. Permissions の項目で、次の3行をそのまま追加します(行を増やすには「+ Add more」をクリックします)。

    列1(グループ) 列2(項目) 列3(権限レベル)
    Account Cloudflare Tunnel Edit
    Zone DNS Edit
    Zone Zone Read

    3行すべてが必要です。1行目はOKNoteがトンネルを構築するため、2行目はアクセス用ドメインのDNSを設定するため、3行目はあなたのドメイン一覧を読み取るためのものです。

  4. その下で:

    • Account Resources:自分自身のアカウントを選択します。
    • Zone Resources:使用するドメイン(または All zones)を選択します。

  5. Continue to summary → Create Token をクリックし、生成されたトークンをコピーします。

    ⚠️ トークンはこの場でしか表示されません。ページを離れる前に必ずコピーしてください。紛失した場合は、新しく作り直す必要があります。

  6. コピーしたトークンを、ウィザードのステップ4に持って行きます。

ステップ4:入力して有効化する

OKNoteのウィザードに戻り、ステップ4です。

  1. Domain:ルートドメインを入力します。例:example.com(https://やサブドメインは不要)。
  2. Subdomain:アクセス用のプレフィックスです。デフォルトは notes。入力すると、ウィザードに https://notes.example.com のようなアドレスがリアルタイムで表示されます。
  3. Cloudflare API Token:ステップ3で取得したトークンを貼り付けます。
  4. Verify domain and token をクリックします。成功すると、緑色で「Verified, ready to activate」と表示されます。

    検証に失敗する場合は?ステップ3の権限行が不足しているか、ドメインの入力ミス、またはまだ Active になっていない可能性が高いです。3行の設定を見直してください。

  5. Activate をクリックします。しばらくすると、外部公開アドレスが使えるようになります。

以降は、どのネットワークからでも https://notes.your-domain を開けば、このOKNoteにアクセスできます。

FAQ

  • 本当にドメインが必要ですか? はい。独自ドメインを使う方式では、自分自身のドメイン(年間数ドル程度)が必要です。そうすることで、アドレスは自分専用のもの、かつシンプルで安定したものになります。
  • 検証が繰り返し失敗する場合は? 次の順に確認してください。①ステップ3の権限3行がすべて揃っていて、グループ/項目/権限レベルが一致しているか、②Cloudflare上でドメインが Active になっているか、③ドメインの入力ミスがなく、トークンが全文コピーされているか。
  • 有効化したのに開けない場合は? ドメインを接続した直後は、DNSの反映に少し時間がかかります。また、サーバー自体がインターネットに接続できているか確認してください(サーバーがCloudflareに向けて発信方向にトンネルを構築します)。
  • ドメインを変更したい/無効にしたい場合は? 設定 → 外部公開に戻れば、再設定または外部公開の無効化ができます。

📸 Cloudflareのボタン配置は時々変わりますが、核心部分 —— 「Create Custom Token」と上記の権限3行 —— は変わりません。この権限表さえ信じていれば大丈夫です。

これでガイドは以上です🎉 これらのノートは自由に編集・削除して構いません。何も壊れません。OKNoteをお楽しみください!