OKNote
Per iniziare

🌐 Accesso pubblico: il tuo dominio + Cloudflare

Se usi OKNote su un NAS a casa, per impostazione predefinita puoi raggiungerlo solo dalla tua rete locale. Per aprire il tuo OKNote dall'ufficio, in viaggio, da qualsiasi luogo, ti serve la "mappatura pubblica". OKNote include un'opzione integrata Cloudflare Tunnel:

  • Nessun IP pubblico e nessun port forwarding sul router — va bene anche un NAT carrier-grade / IP privato del tuo provider internet;
  • Usa il tuo dominio personale per l'indirizzo (ad es. https://notes.example.com) tramite il tunnel crittografato di Cloudflare — sicuro e stabile.

Prerequisiti: la mappatura pubblica è una funzione dal piano Famiglia in su; il piano Free non la include. Inoltre, l'host del tunnel deve essere una versione server (NAS / server desktop); l'edizione con acquisto in-app del Mac App Store gira in sandbox e non può fare da host del tunnel.

Tutto avviene nella procedura guidata in 4 passaggi sotto Impostazioni → Mappatura pubblica → "Configura l'accesso pubblico · Usa il tuo dominio." Di seguito trovi la procedura passo passo. La parte critica è il Passaggio 3, ottenere il token — leggilo con attenzione e non ti bloccherai.

Passaggio 1: procurati un dominio

Ti serve un dominio tuo da cui costruire l'indirizzo.

  • Ne hai già uno (acquistato su GoDaddy, Namecheap, Aliyun, ecc.) → usalo, vai al Passaggio 2.
  • Non hai ancora un dominio → acquistane uno su Cloudflare Registrar, GoDaddy o altrove; di solito pochi dollari all'anno. .com / .top / .xyz vanno tutti bene.

Passaggio 2: aggiungi il tuo dominio a Cloudflare

Questo passaggio affida la gestione DNS del tuo dominio a Cloudflare.

  1. Registrati e accedi alla dashboard di Cloudflare (gratuita).
  2. Clicca su Add a site e inserisci il tuo dominio.
  3. Scegli il piano Free. Cloudflare ti fornisce due indirizzi nameserver (server DNS).
  4. Torna dove hai acquistato il dominio e cambia i suoi nameserver con i due forniti da Cloudflare:
    • GoDaddy: My Domains → apri Domain Settings del dominio → Nameservers → Change → scegli Custom → inserisci i due indirizzi, salva.
    • Namecheap / altri: trova l'impostazione "Nameservers", passa a Custom DNS, inserisci i due indirizzi, salva.
  5. Attendi che lo stato del dominio su Cloudflare diventi Active — di solito da pochi minuti a qualche ora.

Se hai acquistato il dominio direttamente su Cloudflare Registrar, è già collegato — salta questo passaggio.

Passaggio 3: crea un API Token (🔑 il passaggio critico)

Questo dà a OKNote una "chiave" per costruire automaticamente il tunnel e configurare il DNS del tuo dominio. Tutta la difficoltà sta qui, ed è tutta questione di assegnare i permessi giusti.

  1. Apri la pagina Cloudflare API Tokens.

  2. Clicca su Create Token → scorri fino in fondo, Create Custom Token → Get started.

  3. Sotto Permissions, aggiungi esattamente queste tre righe (clicca "+ Add more" per righe aggiuntive):

    Colonna 1 (gruppo) Colonna 2 (elemento) Colonna 3 (livello)
    Account Cloudflare Tunnel Edit
    Zone DNS Edit
    Zone Zone Read

    Sono tutte e tre necessarie: la riga 1 permette a OKNote di costruire il tunnel, la riga 2 gli permette di configurare il DNS del tuo dominio di accesso, la riga 3 gli permette di leggere il tuo elenco di domini.

  4. Subito sotto:

    • Account Resources: seleziona il tuo account.
    • Zone Resources: seleziona il dominio che userai (oppure All zones).

  5. Clicca su Continue to summary → Create Token, poi copia il token generato.

    ⚠️ Il token viene mostrato una sola volta. Copialo prima di lasciare la pagina — se lo perdi dovrai crearne uno nuovo.

  6. Porta il token copiato al Passaggio 4 della procedura guidata.

Passaggio 4: completa e attiva

Torna nella procedura guidata di OKNote, Passaggio 4:

  1. Dominio: il tuo dominio principale, ad es. example.com (senza https://, senza sottodominio).
  2. Sottodominio: il tuo prefisso di accesso, predefinito notes. Mentre digiti, la procedura guidata mostra il tuo indirizzo in tempo reale, ad es. https://notes.example.com.
  3. Cloudflare API Token: incolla il token del Passaggio 3.
  4. Clicca su Verifica dominio e token — in caso di successo vedrai un messaggio verde "Verificato, pronto per l'attivazione".

    La verifica fallisce? Molto probabilmente manca una riga di permessi al Passaggio 3, oppure il dominio è scritto male o non è ancora Active. Torna indietro e controlla le tre righe.

  5. Clicca su Attiva. Dopo un momento il tuo indirizzo pubblico va online.

Da quel momento, apri https://notes.tuo-dominio da qualsiasi rete per raggiungere questo OKNote.

Domande frequenti

  • Mi serve davvero un dominio? Sì — usare un dominio proprio richiede un dominio tuo (pochi dollari all'anno). Così l'indirizzo è tuo, pulito e stabile.
  • La verifica continua a fallire? Controlla in ordine: ① tutte e tre le righe di permessi al Passaggio 3 sono presenti e gruppo/elemento/livello corrispondono; ② il dominio è Active su Cloudflare; ③ nessun errore di battitura nel dominio e il token è stato copiato per intero.
  • Attivato ma non si apre? Il DNS impiega un po' di tempo a propagarsi subito dopo aver collegato un dominio; assicurati che il server stesso sia online con accesso a internet (il server costruisce il tunnel in uscita verso Cloudflare).
  • Cambiare dominio / disattivarlo? Torna in Impostazioni → Mappatura pubblica per riconfigurare o disattivare l'accesso pubblico.

📸 Cloudflare a volte sposta i pulsanti, ma il nucleo — "Create Custom Token" più le tre righe di permessi sopra — non cambia. Fidati della tabella dei permessi e andrà tutto bene.

Ecco la fine delle guide 🎉 Sentiti libero di modificare o eliminare queste note — non romperai nulla. Buon OKNote!