🌐 Публичный доступ: свой домен + Cloudflare

Если OKNote работает на домашнем NAS, по умолчанию к нему можно обратиться только из локальной сети. Чтобы открыть свой OKNote из офиса, в дороге — откуда угодно, нужен «публичный доступ». В OKNote есть встроенный вариант через Cloudflare Tunnel:

• Не нужен публичный IP и проброс портов на роутере — подойдёт даже CGNAT / приватный IP от провайдера;
• Адрес строится на твоём собственном домене (например, https://notes.example.com) через зашифрованный туннель Cloudflare — надёжно и стабильно.

Предварительные условия: публичный доступ — это возможность тарифов Family и выше; в Бесплатный тариф не входит. Кроме того, узел с туннелем должен быть серверной сборкой (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 выдаст два адреса неймсерверов (DNS-серверов).
4. Вернись туда, где куплен домен, и смени его неймсерверы на те два, что дал Cloudflare:
   • GoDaddy: My Domains → открой Domain Settings нужного домена → Nameservers → Change → выбери Custom → введи два адреса, сохрани.
   • Namecheap / другие: найди настройку «Nameservers», переключи на Custom DNS, введи два адреса, сохрани.
5. Дождись, пока статус домена в Cloudflare станет Active — обычно от нескольких минут до нескольких часов.

Если домен изначально куплен через Cloudflare Registrar, он уже подключён — этот шаг можно пропустить.

Шаг 3. Создай API-токен (🔑 самый важный шаг)

Это даёт OKNote «ключ», чтобы автоматически строить туннель и настраивать DNS в твоём домене. Вся сложность здесь — в том, чтобы выдать правильные права доступа.

1. Открой страницу API-токенов Cloudflare.

2. Нажми Create Token → прокрути вниз, Create Custom Token → Get started.

3. В разделе Permissions добавь ровно эти три строки (для дополнительных строк нажимай «+ Add more»):

   Столбец 1 (группа)	Столбец 2 (элемент)	Столбец 3 (уровень)
   Account	Cloudflare Tunnel	Edit
   Zone	DNS	Edit
   Zone	Zone	Read

   Нужны все три строки: первая позволяет OKNote строить туннель, вторая — настраивать DNS домена, через который идёт доступ, третья — читать список твоих доменов.

4. Ниже:

   • Account Resources: выбери свой аккаунт.
   • Zone Resources: выбери нужный домен (или All zones).

5. Нажми Continue to summary → Create Token, затем скопируй сгенерированный токен.

   ⚠️ Токен показывается только один раз. Скопируй его, пока не покинул страницу, — если потеряешь, придётся создавать новый.

6. Возьми скопированный токен и переходи к шагу 4 мастера.

Шаг 4. Заполни и активируй

Вернись в мастер OKNote, шаг 4:

1. Домен: корневой домен, например example.com (без https:// и без поддомена).
2. Поддомен: префикс доступа, по умолчанию notes. По мере ввода мастер сразу показывает адрес, например https://notes.example.com.
3. API-токен Cloudflare: вставь токен, полученный на шаге 3.
4. Нажми «Проверить домен и токен» — при успехе появится зелёная надпись «Проверено, готово к активации».

   Проверка не проходит? Скорее всего, на шаге 3 пропущена одна из строк прав доступа, либо в домене опечатка, либо он ещё не Active. Вернись и проверь три строки.

5. Нажми «Активировать». Через мгновение публичный адрес заработает.

С этого момента https://notes.твой-домен открывает этот OKNote из любой сети.

Частые вопросы

• Действительно ли нужен домен? Да — вариант со своим доменом требует собственного домена (несколько долларов в год). Зато адрес получается твоим, чистым и стабильным.
• Проверка постоянно не проходит? Проверь по порядку: ① все три строки прав доступа на шаге 3 добавлены, а группа/элемент/уровень совпадают; ② домен в Cloudflare имеет статус Active; ③ в домене нет опечаток и токен скопирован полностью.
• Активировано, но не открывается? Сразу после подключения домена DNS какое-то время распространяется; убедись также, что сам сервер онлайн и имеет доступ в интернет (сервер сам строит исходящий туннель к Cloudflare).
• Сменить домен / отключить? Вернись в Настройки → Публичный доступ, чтобы перенастроить или отключить публичный доступ.

📸 Интерфейс Cloudflare время от времени меняется, но суть — «Create Custom Token» и три строки прав доступа выше — остаётся прежней. Доверяй таблице прав, и всё получится.

---

Вот и всё 🎉 Эти заметки можно свободно редактировать или удалить — ничего не сломается. Приятной работы с OKNote!