🌐 Acceso Público: Tu Propio Dominio + Cloudflare

Al ejecutar OKNote en un NAS en casa, por defecto solo puedes acceder a él en tu red local. Para abrir tu OKNote desde la oficina, de viaje o desde cualquier sitio, necesitas el "mapeo público". OKNote incluye una opción integrada de Cloudflare Tunnel:

• Sin IP pública ni redirección de puertos en tu router: una NAT de operador o una IP privada de tu proveedor de internet son suficientes;
• Usa tu propio dominio para la dirección (por ejemplo, https://notes.ejemplo.com) a través del túnel cifrado de Cloudflare: seguro y estable.

Requisitos previos: el mapeo público es una capacidad del plan Familiar en adelante; el plan Gratuito no lo incluye. Además, el host del túnel debe ser una compilación de servidor (NAS / servidor de escritorio); la edición de compra dentro de la app de la Mac App Store se ejecuta en un sandbox y no puede actuar como host del túnel.

Todo el proceso se hace en el asistente de 4 pasos en Ajustes → Mapeo público → "Configurar acceso público · Usa tu propio dominio." A continuación, el paso a paso. La parte crítica es el Paso 3, obtener el token; léelo con atención y no te quedarás atascado.

Paso 1: Ten un dominio listo

Necesitas un dominio propio a partir del cual construir la dirección.

• Ya tienes uno (comprado en GoDaddy, Namecheap, Aliyun, etc.) → úsalo, ve al Paso 2.
• Todavía no tienes dominio → compra uno en Cloudflare Registrar, GoDaddy u otro sitio; normalmente unos pocos dólares al año. .com / .top / .xyz funcionan todos.

Paso 2: Añade tu dominio a Cloudflare

Este paso entrega la gestión de DNS de tu dominio a Cloudflare.

1. Regístrate e inicia sesión en el panel de Cloudflare (gratis).
2. Haz clic en Add a site e introduce tu dominio.
3. Elige el plan Free. Cloudflare te da dos direcciones de servidor de nombres (DNS).
4. Vuelve a donde compraste el dominio y cambia sus servidores de nombres por los dos que te dio Cloudflare:
   • GoDaddy: My Domains → abre Domain Settings del dominio → Nameservers → Change → elige Custom → introduce los dos, guarda.
   • Namecheap / otros: busca el ajuste de "Nameservers", cambia a Custom DNS, introduce los dos, guarda.
5. Espera a que el estado del dominio en Cloudflare pase a Active; normalmente de unos minutos a unas horas.

Si compraste el dominio originalmente en Cloudflare Registrar, ya está conectado: sáltate este paso.

Paso 3: Crea un Token de API (🔑 el paso crítico)

Esto le da a OKNote una "llave" para que pueda construir el túnel automáticamente y configurar el DNS bajo tu dominio. Toda la dificultad está aquí, y se reduce a conceder los permisos correctos.

1. Abre la página de API Tokens de Cloudflare.

2. Haz clic en Create Token → desplázate hasta abajo, Create Custom Token → Get started.

3. En Permissions, añade exactamente estas tres filas (haz clic en "+ Add more" para filas adicionales):

   Columna 1 (grupo)	Columna 2 (elemento)	Columna 3 (nivel)
   Account	Cloudflare Tunnel	Edit
   Zone	DNS	Edit
   Zone	Zone	Read

   Las tres son obligatorias: la fila 1 permite a OKNote construir el túnel, la fila 2 le permite configurar el DNS de tu dominio de acceso, la fila 3 le permite leer tu lista de dominios.

4. Debajo de eso:

   • Account Resources: selecciona tu propia cuenta.
   • Zone Resources: selecciona el dominio que vas a usar (o All zones).

5. Haz clic en Continue to summary → Create Token, y luego copia el token generado.

   ⚠️ El token se muestra solo una vez. Cópialo antes de salir de la página; si lo pierdes, tendrás que crear uno nuevo.

6. Lleva el token copiado al Paso 4 del asistente.

Paso 4: Rellena y activa

De vuelta en el asistente de OKNote, Paso 4:

1. Dominio: tu dominio raíz, por ejemplo ejemplo.com (sin https://, sin subdominio).
2. Subdominio: tu prefijo de acceso, por defecto notes. Mientras escribes, el asistente muestra tu dirección en vivo, por ejemplo https://notes.ejemplo.com.
3. Token de API de Cloudflare: pega el token del Paso 3.
4. Haz clic en Verificar dominio y token; si todo va bien, verás un mensaje verde de "Verificado, listo para activar."

   ¿Falla la verificación? Lo más probable es que falte una fila de permisos en el Paso 3, o que el dominio esté mal escrito o todavía no esté Active. Vuelve atrás y revisa las tres filas.

5. Haz clic en Activar. En un momento tu dirección pública queda en marcha.

A partir de ahí, abre https://notes.tu-dominio desde cualquier red para acceder a este OKNote.

Preguntas frecuentes

• ¿De verdad necesito un dominio? Sí: usar tu propio dominio requiere un dominio propio (unos pocos dólares al año). Así la dirección es tuya, limpia y estable.
• ¿La verificación sigue fallando? Revisa en orden: ① las tres filas de permisos del Paso 3 están presentes y el grupo/elemento/nivel coinciden; ② el dominio está Active en Cloudflare; ③ no hay errores tipográficos en el dominio y el token se copió completo.
• ¿Activado pero no abre? El DNS tarda un poco en propagarse justo después de conectar un dominio; asegúrate de que el propio servidor esté en línea con acceso a internet (el servidor construye el túnel de salida hacia Cloudflare).
• ¿Cambiar de dominio o desactivarlo? Vuelve a Ajustes → Mapeo público para reconfigurar o desactivar el acceso público.

📸 Cloudflare mueve los botones de vez en cuando, pero lo esencial ("Create Custom Token" más las tres filas de permisos anteriores) no cambia. Confía en la tabla de permisos y todo irá bien.

---

Aquí termina la guía 🎉 Siéntete libre de editar o eliminar estas notas: no se romperá nada. ¡Disfruta de OKNote!