Configuración de Cloudflare Tunnel

Cloudflare Tunnel te permite conectarte a tu Mac desde cualquier red — datos celulares, una WiFi diferente o desde el otro lado del mundo. Sin port forwarding ni cambios en el router.

Cuándo usar esto

• Tu iPhone está en una red diferente a la de tu Mac (ej. estás en movimiento).
• Tu red bloquea conexiones directas entre dispositivos.
• Quieres cifrado HTTPS/WSS por defecto.

Cómo funciona

cloudflared crea un túnel de salida desde tu Mac hacia el edge de Cloudflare. Tu iPhone se conecta a una URL de Cloudflare y el tráfico se retransmite a tu Mac. No se abren puertos en tu router.

Opción A: Quick tunnel (temporal)

Es la forma más rápida de empezar. No requiere cuenta de Cloudflare. La URL es aleatoria y cambia cada vez que reinicias.

Usando la app de Mac

Activa Cloudflare Tunnel en los ajustes de la app de Mac. La app ejecuta cloudflared internamente y muestra la URL del túnel.

Usando la línea de comandos

Instala cloudflared:

brew install cloudflared

Inicia un quick tunnel:

cloudflared tunnel --url http://localhost:8765

cloudflared muestra una URL como https://random-words.trycloudflare.com. Usa esta URL en la app de iPhone (configura el modo de conexión en Público / Cloudflare).

Opción B: Named tunnel (URL persistente)

Para uso diario, un named tunnel te da una URL estable que no cambia.

Requisitos:

• Una cuenta gratuita de Cloudflare.
• Un dominio gestionado por Cloudflare (puede ser un dominio gratuito).

Pasos:

1. Autentícate:

   cloudflared tunnel login

2. Crea un túnel:

   cloudflared tunnel create claude-remote

3. Configura DNS: apunta un subdominio a tu túnel:

   cloudflared tunnel route dns claude-remote remote.tudominio.com

4. Crea un archivo de configuración en ~/.cloudflared/config.yml:

   tunnel: claude-remote
   credentials-file: ~/.cloudflared/<TUNNEL_ID>.json
   ingress:
     - hostname: remote.tudominio.com
       service: http://localhost:8765
     - service: http_status:404

5. Ejecuta:

   cloudflared tunnel run claude-remote

Tu URL persistente ahora es wss://remote.tudominio.com.

Conectar desde iPhone

1. En la app de iPhone, cambia al modo de conexión Público (Cloudflare).
2. Introduce la URL del túnel (ya sea la aleatoria *.trycloudflare.com o tu dominio nombrado).
3. Introduce la API key (requerida para acceso público).
4. Toca Conectar.

Importante: Siempre configura una API key para túneles públicos

Cuando tu servidor es accesible desde internet, una API key es obligatoria. Configúrala como variable de entorno antes de iniciar el servidor:

export CLAUDE_REMOTE_API_KEY="tu-clave-secreta"

O deja que la app de Mac genere una por ti (se muestra en el panel de la barra de menú).

Resolución de problemas

• El túnel conecta pero iPhone no puede alcanzarlo: asegúrate de que el servidor local está ejecutándose en el mismo puerto al que apunta el túnel (por defecto: 8765).
• DNS no resuelve: para named tunnels, verifica que el registro CNAME existe en tu panel de Cloudflare.
• La URL aleatoria cambió: los quick tunnels generan una nueva URL cada reinicio. Usa un named tunnel para persistencia.