OKNote
Začínáme

🌐 Veřejný přístup: vlastní doména + Cloudflare

Když provozuješ OKNote na domácím NAS, standardně se k němu dostaneš jen ve své lokální síti. Abys otevřel/a svůj OKNote z kanceláře, na cestách, odkudkoli, potřebuješ „veřejné mapování". OKNote má vestavěnou možnost Cloudflare Tunnel:

  • Žádná veřejná IP adresa ani přesměrování portů na routeru — stačí i NAT operátorské třídy / privátní IP adresa od tvého poskytovatele internetu;
  • Používá tvou vlastní doménu pro adresu (např. https://notes.example.com) přes šifrovaný tunel Cloudflare — bezpečné a stabilní.

Předpoklady: veřejné mapování je funkce dostupná od plánu Rodinný výš; Free ji neobsahuje. Hostitel tunelu navíc musí být serverová sestava (NAS / desktopový server); edice s nákupem v aplikaci z Mac App Store běží v sandboxu a nemůže sloužit jako hostitel tunelu.

Celé to zvládneš ve 4krokovém průvodci v Nastavení → Veřejné mapování → „Nastavit veřejný přístup · Vlastní doména". Níže je postup krok za krokem. Klíčová je část Krok 3, získání tokenu — přečti si ji pozorně a nezasekneš se.

Krok 1: Připrav si doménu

Potřebuješ vlastní doménu, ze které se adresa postaví.

  • Už nějakou máš (koupenou u GoDaddy, Namecheap, Aliyun atd.) → použij ji a pokračuj Krokem 2.
  • Ještě doménu nemáš → kup si ji u Cloudflare Registrar, GoDaddy nebo jinde; obvykle pár dolarů ročně. .com / .top / .xyz fungují všechny.

Krok 2: Přidej doménu do Cloudflare

Tento krok předá správu DNS tvé domény Cloudflare.

  1. Zaregistruj se a přihlas do Cloudflare dashboardu (zdarma).
  2. Klikni na Add a site a zadej svou doménu.
  3. Vyber plán Free. Cloudflare ti dá dvě adresy nameserverů (DNS serverů).
  4. Vrať se tam, kde jsi doménu koupil/a, a změň jí nameservery na ty dva, které ti dala Cloudflare:
    • GoDaddy: My Domains → otevři Domain Settings dané domény → Nameservers → Change → zvol Custom → zadej oba dva, ulož.
    • Namecheap / ostatní: najdi nastavení „Nameservers", přepni na Custom DNS, zadej oba dva, ulož.
  5. Počkej, až stav domény v Cloudflare přejde na Active — obvykle pár minut až pár hodin.

Pokud jsi doménu koupil/a rovnou u Cloudflare Registrar, je už propojená — tento krok přeskoč.

Krok 3: Vytvoř API Token (🔑 klíčový krok)

Tím dáš OKNote „klíč", pomocí kterého si automaticky vybuduje tunel a nakonfiguruje DNS pod tvou doménou. Celá obtížnost je právě tady a jde jen o udělení správných oprávnění.

  1. Otevři stránku Cloudflare API Tokens.

  2. Klikni na Create Token → sjeď dolů na Create Custom Token → Get started.

  3. V sekci Permissions přidej přesně tyto tři řádky (na další řádky klikni na „+ Add more"):

    Sloupec 1 (skupina) Sloupec 2 (položka) Sloupec 3 (úroveň)
    Account Cloudflare Tunnel Edit
    Zone DNS Edit
    Zone Zone Read

    Všechny tři jsou nutné: řádek 1 umožní OKNote vybudovat tunel, řádek 2 mu umožní konfigurovat DNS tvé přístupové domény, řádek 3 mu umožní číst seznam tvých domén.

  4. Pod tím:

    • Account Resources: vyber svůj vlastní účet.
    • Zone Resources: vyber doménu, kterou budeš používat (nebo All zones).

  5. Klikni na Continue to summary → Create Token a pak zkopíruj vygenerovaný token.

    ⚠️ Token se zobrazí jen jednou. Zkopíruj si ho, než stránku opustíš — pokud o něj přijdeš, budeš muset vytvořit nový.

  6. Zkopírovaný token přenes do Kroku 4 průvodce.

Krok 4: Vyplň a aktivuj

Zpátky v průvodci OKNote, Krok 4:

  1. Domain: tvá kořenová doména, např. example.com (bez https://, bez subdomény).
  2. Subdomain: tvá přístupová předpona, výchozí notes. Jak píšeš, průvodce živě ukazuje tvou adresu, např. https://notes.example.com.
  3. Cloudflare API Token: vlož token z Kroku 3.
  4. Klikni na Verify domain and token — při úspěchu uvidíš zelené „Verified, ready to activate".

    Ověření selhává? Nejpravděpodobněji chybí řádek oprávnění z Kroku 3, nebo je doména špatně napsaná / ještě není Active. Vrať se a zkontroluj všechny tři řádky.

  5. Klikni na Activate. Za chvíli se tvá veřejná adresa zprovozní.

Od té chvíle stačí otevřít https://notes.tvoje-domena v jakékoli síti a dostaneš se k tomuto OKNote.

FAQ

  • Opravdu potřebuju doménu? Ano — vlastní doména je nutná (pár dolarů ročně). Díky tomu je adresa tvoje, čistá a stabilní.
  • Ověření pořád selhává? Zkontroluj postupně: ① že jsou v Kroku 3 přítomné všechny tři řádky oprávnění a group/item/level sedí; ② že je doména v Cloudflare Active; ③ že v doméně nejsou překlepy a token byl zkopírován celý.
  • Aktivováno, ale nejde otevřít? DNS se chvíli šíří hned po připojení domény; ujisti se, že je samotný server online s přístupem k internetu (server buduje tunel směrem ven k Cloudflare).
  • Změna domény / vypnutí? Vrať se do Nastavení → Veřejné mapování a veřejný přístup přenastav nebo vypni.

📸 Cloudflare občas přesune tlačítka jinam, ale jádro — „Create Custom Token" plus tři řádky oprávnění výše — se nemění. Věř tabulce oprávnění a bude to v pořádku.

To je konec průvodců 🎉 Klidně si tyto poznámky uprav nebo smaž — nic se tím nerozbije. Užij si OKNote!