OKNote
Aan de slag

🌐 Publieke toegang: je eigen domein + Cloudflare

Draai je OKNote thuis op een NAS, dan bereik je hem standaard alleen via je lokale netwerk. Om je OKNote vanaf kantoor, onderweg, overal te openen, heb je "publieke mapping" nodig. OKNote heeft een ingebouwde Cloudflare Tunnel-optie:

  • Geen publiek IP en geen portforwarding op je router nodig — carrier-grade NAT / een privé-IP van je provider is prima;
  • Gebruikt je eigen domein voor het adres (bijv. https://notes.example.com) via de versleutelde tunnel van Cloudflare — veilig en stabiel.

Vereisten: publieke mapping is een mogelijkheid vanaf het Familie-abonnement; Gratis bevat dit niet. Ook moet de tunnelhost een server-build zijn (NAS / desktopserver); de in-app-aankoopeditie via de Mac App Store draait in een sandbox en kan niet als tunnelhost optreden.

Het geheel doorloop je in de wizard van 4 stappen onder Instellingen → Publieke mapping → "Publieke toegang instellen · Eigen domein gebruiken." Hieronder de stap-voor-stap uitleg. Het kritieke onderdeel is Stap 3, het ophalen van het token — lees die goed door en je loopt niet vast.

Stap 1: Zorg voor een domein

Je hebt een eigen domein nodig om het adres op te bouwen.

  • Heb je er al een (gekocht bij GoDaddy, Namecheap, Aliyun, enz.) → gebruik dat, ga naar Stap 2.
  • Nog geen domein? → koop er een bij Cloudflare Registrar, GoDaddy of elders; meestal een paar dollar per jaar. .com / .top / .xyz werken allemaal.

Stap 2: Voeg je domein toe aan Cloudflare

Deze stap draagt het DNS-beheer van je domein over aan Cloudflare.

  1. Registreer en log in bij het Cloudflare-dashboard (gratis).
  2. Klik op Add a site en voer je domein in.
  3. Kies het Free-plan. Cloudflare geeft je twee nameserver (DNS-server)-adressen.
  4. Ga terug naar waar je het domein hebt gekocht en wijzig de nameservers naar de twee die je van Cloudflare hebt gekregen:
    • GoDaddy: My Domains → open de Domain Settings van het domein → Nameservers → Change → kies Custom → voer de twee adressen in, opslaan.
    • Namecheap / andere providers: zoek de instelling "Nameservers", schakel over naar Custom DNS, voer de twee adressen in, opslaan.
  5. Wacht tot de status van het domein in Cloudflare Active wordt — meestal een paar minuten tot een paar uur.

Heb je het domein oorspronkelijk al bij Cloudflare Registrar gekocht, dan is het al gekoppeld — sla deze stap over.

Stap 3: Maak een API Token aan (🔑 de kritieke stap)

Dit geeft OKNote een "sleutel" waarmee het automatisch de tunnel kan opbouwen en de DNS onder je domein kan configureren. Alle moeilijkheid zit hem hierin, en het draait volledig om het toekennen van de juiste rechten.

  1. Open de Cloudflare API Tokens-pagina.

  2. Klik op Create Token → scroll helemaal naar beneden, Create Custom Token → Get started.

  3. Voeg bij Permissions precies deze drie rijen toe (klik op "+ Add more" voor extra rijen):

    Kolom 1 (groep) Kolom 2 (item) Kolom 3 (niveau)
    Account Cloudflare Tunnel Edit
    Zone DNS Edit
    Zone Zone Read

    Alle drie zijn verplicht: rij 1 laat OKNote de tunnel opbouwen, rij 2 laat het de DNS van je toegangsdomein configureren, rij 3 laat het je lijst met domeinen lezen.

  4. Daaronder:

    • Account Resources: selecteer je eigen account.
    • Zone Resources: selecteer het domein dat je gaat gebruiken (of All zones).

  5. Klik op Continue to summary → Create Token, en kopieer vervolgens het gegenereerde token.

    ⚠️ Het token wordt maar één keer getoond. Kopieer het voordat je de pagina verlaat — raak je het kwijt, dan moet je een nieuw token aanmaken.

  6. Neem het gekopieerde token mee naar Stap 4 van de wizard.

Stap 4: Invullen en activeren

Terug in de OKNote-wizard, Stap 4:

  1. Domein: je hoofddomein, bijv. example.com (geen https://, geen subdomein).
  2. Subdomein: je toegangsprefix, standaard notes. Terwijl je typt, toont de wizard live je adres, bijv. https://notes.example.com.
  3. Cloudflare API Token: plak het token uit Stap 3.
  4. Klik op Verify domain and token — bij succes zie je een groen "Verified, ready to activate."

    Mislukt de verificatie? Waarschijnlijk ontbreekt een rechtenrij uit Stap 3, of is het domein verkeerd getypt / nog niet Active. Ga terug en controleer de drie rijen.

  5. Klik op Activate. Na een moment is je publieke adres actief.

Vanaf dan open je op elk netwerk https://notes.jouw-domein om deze OKNote te bereiken.

Veelgestelde vragen

  • Heb ik echt een domein nodig? Ja — een eigen domein gebruiken vereist een eigen domein (een paar dollar per jaar). Zo is het adres van jou, netjes en stabiel.
  • Verificatie blijft mislukken? Controleer op volgorde: ① alle drie de rechtenrijen uit Stap 3 zijn aanwezig en groep/item/niveau kloppen; ② het domein is Active in Cloudflare; ③ geen typefouten in het domein en het token is volledig gekopieerd.
  • Geactiveerd maar het opent niet? DNS heeft even tijd nodig om door te dringen vlak nadat je een domein hebt gekoppeld; controleer ook of de server zelf online is met internettoegang (de server bouwt de tunnel uitgaand op naar Cloudflare).
  • Domein wijzigen / uitschakelen? Ga terug naar Instellingen → Publieke mapping om te herconfigureren of publieke toegang uit te schakelen.

📸 Cloudflare verplaatst af en toe knoppen, maar de kern — "Create Custom Token" plus de drie rechtenrijen hierboven — blijft hetzelfde. Vertrouw op de rechtentabel en het komt goed.

Dat is het einde van de gidsen 🎉 Bewerk of verwijder deze notities gerust — er gaat niets kapot. Veel plezier met OKNote!