🌐 Öffentlicher Zugriff: Eigene Domain + Cloudflare

Betreibst du OKNote auf einem NAS zu Hause, erreichst du es standardmäßig nur im lokalen Netzwerk. Um dein OKNote vom Büro, unterwegs, von überall zu öffnen, brauchst du die "öffentliche Zuordnung". OKNote hat eine eingebaute Cloudflare Tunnel-Option:

• Keine öffentliche IP und keine Portweiterleitung am Router nötig — ein Carrier-Grade-NAT bzw. eine private IP von deinem Provider reicht aus;
• nutzt deine eigene Domain für die Adresse (z. B. https://notes.example.com) über Cloudflares verschlüsselten Tunnel — sicher und stabil.

Voraussetzungen: öffentliche Zuordnung ist eine Funktion ab dem Family-Plan; Free enthält sie nicht. Außerdem muss der Tunnel-Host ein Server-Build sein (NAS / Desktop-Server); die IAP-Edition aus dem Mac App Store läuft in einer Sandbox und kann nicht als Tunnel-Host fungieren.

Das Ganze läuft über den 4-Schritte-Assistenten unter Einstellungen → Öffentliche Zuordnung → "Öffentlichen Zugriff einrichten · Eigene Domain verwenden". Im Folgenden die Schritt-für-Schritt-Anleitung. Der kritische Teil ist Schritt 3, das Beschaffen des Tokens — lies ihn sorgfältig, dann bleibst du nicht hängen.

Schritt 1: Domain bereithalten

Du brauchst eine eigene Domain, um die Adresse darauf aufzubauen.

• Hast du schon eine (gekauft bei GoDaddy, Namecheap, Aliyun usw.) → nutze sie, weiter mit Schritt 2.
• Noch keine Domain → kaufe eine bei Cloudflare Registrar, GoDaddy oder anderswo; meist ein paar Dollar im Jahr. .com / .top / .xyz funktionieren alle.

Schritt 2: Domain zu Cloudflare hinzufügen

Dieser Schritt übergibt die DNS-Verwaltung deiner Domain an Cloudflare.

1. Registriere dich und melde dich im Cloudflare-Dashboard an (kostenlos).
2. Klicke auf Add a site und gib deine Domain ein.
3. Wähle den Free-Plan. Cloudflare gibt dir zwei Nameserver-Adressen (DNS-Server).
4. Gehe zurück dorthin, wo du die Domain gekauft hast, und ändere ihre Nameserver auf die beiden von Cloudflare:
   • GoDaddy: My Domains → die Domain Settings der Domain öffnen → Nameservers → Change → Custom wählen → die beiden eintragen, speichern.
   • Namecheap / andere: die Einstellung "Nameservers" suchen, auf Custom DNS umstellen, die beiden eintragen, speichern.
5. Warte, bis der Status der Domain in Cloudflare auf Active wechselt — meist ein paar Minuten bis ein paar Stunden.

Hast du die Domain von Anfang an bei Cloudflare Registrar gekauft, ist sie bereits verbunden — überspringe diesen Schritt.

Schritt 3: API-Token erstellen (🔑 der kritische Schritt)

Das gibt OKNote einen "Schlüssel", mit dem es automatisch den Tunnel aufbauen und die DNS-Einträge unter deiner Domain konfigurieren kann. Die ganze Schwierigkeit liegt hier, und es dreht sich alles darum, die richtigen Berechtigungen zu vergeben.

1. Öffne die Cloudflare-API-Tokens-Seite.

2. Klicke auf Create Token → scrolle ganz nach unten, Create Custom Token → Get started.

3. Füge unter Permissions genau diese drei Zeilen hinzu (klicke auf "+ Add more" für weitere Zeilen):

   Spalte 1 (Gruppe)	Spalte 2 (Element)	Spalte 3 (Stufe)
   Account	Cloudflare Tunnel	Edit
   Zone	DNS	Edit
   Zone	Zone	Read

   Alle drei sind erforderlich: Zeile 1 erlaubt OKNote, den Tunnel aufzubauen, Zeile 2 erlaubt es, die DNS deiner Zugangsdomain zu konfigurieren, Zeile 3 erlaubt es, deine Domainliste zu lesen.

4. Darunter:

   • Account Resources: wähle dein eigenes Konto.
   • Zone Resources: wähle die Domain, die du nutzen wirst (oder All zones).

5. Klicke auf Continue to summary → Create Token und kopiere dann den erzeugten Token.

   ⚠️ Der Token wird nur einmal angezeigt. Kopiere ihn, bevor du die Seite verlässt — verlierst du ihn, musst du einen neuen erstellen.

6. Bring den kopierten Token mit zu Schritt 4 des Assistenten.

Schritt 4: Eintragen und aktivieren

Zurück im OKNote-Assistenten, Schritt 4:

1. Domain: deine Root-Domain, z. B. example.com (kein https://, keine Subdomain).
2. Subdomain: dein Zugangspräfix, standardmäßig notes. Während du tippst, zeigt der Assistent live deine Adresse an, z. B. https://notes.example.com.
3. Cloudflare API Token: füge den Token aus Schritt 3 ein.
4. Klicke auf Verify domain and token — bei Erfolg siehst du ein grünes "Verified, ready to activate."

   Schlägt die Verifizierung fehl? Höchstwahrscheinlich fehlt eine Berechtigungszeile aus Schritt 3, oder die Domain ist falsch geschrieben / noch nicht Active. Geh zurück und prüfe die drei Zeilen.

5. Klicke auf Activate. Nach einem Moment ist deine öffentliche Adresse live.

Ab sofort öffnest du https://notes.deine-domain in jedem Netzwerk, um dieses OKNote zu erreichen.

Häufige Fragen

• Brauche ich wirklich eine Domain? Ja — "Eigene Domain verwenden" setzt eine eigene Domain voraus (ein paar Dollar im Jahr). So gehört dir die Adresse, sauber und stabil.
• Verifizierung schlägt ständig fehl? Prüfe der Reihe nach: ① alle drei Berechtigungszeilen aus Schritt 3 sind vorhanden und Gruppe/Element/Stufe stimmen; ② die Domain ist in Cloudflare Active; ③ keine Tippfehler in der Domain, und der Token wurde vollständig kopiert.
• Aktiviert, öffnet sich aber nicht? DNS braucht nach dem Verbinden einer Domain etwas Zeit, um sich zu verbreiten; stelle sicher, dass der Server selbst online ist und Internetzugang hat (der Server baut den Tunnel ausgehend zu Cloudflare auf).
• Domain ändern / abschalten? Gehe zurück zu Einstellungen → Öffentliche Zuordnung, um den öffentlichen Zugriff neu zu konfigurieren oder zu deaktivieren.

📸 Cloudflare verschiebt gelegentlich Schaltflächen, aber der Kern — "Create Custom Token" plus die drei Berechtigungszeilen oben — bleibt gleich. Vertrau der Berechtigungstabelle, dann bist du auf der sicheren Seite.

---

Das war's mit den Guides 🎉 Bearbeite oder lösche diese Notizen ruhig — nichts geht dabei kaputt. Viel Freude mit OKNote!