Modos de conexion explicados: Red local vs. Cloudflare Tunnel

Una de las preguntas mas frecuentes de los nuevos usuarios de Tactic Remote es: "Deberia usar el modo Red local o Cloudflare Tunnel?" La respuesta depende de como y donde trabajas. Este articulo explica ambos modos en detalle — como difieren arquitectonicamente, sus caracteristicas de rendimiento y seguridad, y como Tactic Remote gestiona las transiciones entre ellos.

Dos modos, una interfaz

Antes de profundizar en los detalles tecnicos, el punto mas importante: la aplicacion de iPhone funciona de manera identica independientemente del modo de conexion que uses. Gestion de sesiones, streaming de terminal, flujos de aprobacion, notificaciones push — todo esto funciona igual ya sea que tu telefono este en la misma Wi-Fi que tu Mac o en una red celular al otro lado del pais.

El modo de conexion solo afecta como tu iPhone alcanza la API de la aplicacion Companion. Todo lo que esta por encima de la capa de transporte es identico.

Modo Red Local

El modo Red local es la configuracion predeterminada y la mas simple. La aplicacion Companion de tu Mac vincula su servidor HTTP/WebSocket a un puerto en tu red local, y tu iPhone se conecta directamente a esa direccion IP y puerto.

Como funciona

1. La aplicacion Companion inicia su servidor integrado en el puerto 48736 (configurable).
2. El Mac anuncia su direccion IP local (ej., 192.168.1.42:48736).
3. El iPhone se conecta a esa direccion a traves de tu red Wi-Fi local.
4. Toda la comunicacion viaja directamente entre los dos dispositivos a traves de la red local — sin intermediarios.

Rendimiento

El modo Red local proporciona la mejor latencia posible porque los paquetes viajan por la ruta mas corta: iPhone al router al Mac (o directamente via Wi-Fi Direct en algunas configuraciones de red).

Estos numeros asumen una red Wi-Fi estandar de hogar u oficina. Las redes congestionadas (Wi-Fi de conferencias, por ejemplo) pueden mostrar mayor latencia, pero el modo Red local siempre superara en rendimiento a las conexiones por tunel en la misma red.

Perfil de seguridad

La seguridad del modo Red local se basa en dos capas:

Aislamiento de red. Tu red local actua como perimetro. Solo los dispositivos en la misma red pueden alcanzar el puerto de la aplicacion Companion. Esto es suficiente para la mayoria de los entornos domesticos y de oficina.

Autenticacion por Token. Cada solicitud API requiere un Bearer Token. Incluso si un atacante esta en tu red local, no puede interactuar con la aplicacion Companion sin el Token.

Lo que el modo Red local no proporciona: proteccion contra un dispositivo comprometido en tu red que de alguna manera haya obtenido tu Token. Para entornos donde no puedes confiar en la red local (espacios de coworking compartidos, Wi-Fi de hotel), se recomienda el modo Cloudflare Tunnel.

Limitaciones

• Misma red requerida. Tu iPhone y Mac deben estar en la misma red Wi-Fi (o alcanzables via la misma LAN). En el momento en que abandonas tu red domestica, la conexion se pierde.
• Cambios de direccion IP. Si la IP local de tu Mac cambia (renovacion de concesion DHCP, reconexion a Wi-Fi), necesitas actualizar la configuracion de conexion del iPhone. El flujo de codigo QR mitiga esto mediante re-escaneo, pero sigue siendo un paso manual.
• Sin acceso desde celular. Por definicion, los datos celulares no se enrutan a tu red domestica.

Modo Cloudflare Tunnel

El modo Cloudflare Tunnel crea una conexion saliente persistente desde tu Mac a la red de borde global de Cloudflare. Tu iPhone se conecta a una URL de Cloudflare, y Cloudflare enruta el trafico de vuelta a traves del tunel a tu Mac.

Como funciona

1. La aplicacion Companion lanza cloudflared como un proceso hijo gestionado con tus credenciales de tunel.
2. cloudflared establece una conexion saliente al servidor de borde de Cloudflare mas cercano (tipicamente 2-4 conexiones simultaneas para redundancia).
3. Tu tunel es accesible en la URL que configuraste (ej., claude.yourdomain.com).
4. El iPhone se conecta a esa URL. Cloudflare enruta la solicitud a traves de su red al proceso cloudflared en tu Mac.
5. cloudflared reenvía la solicitud al servidor local de la aplicacion Companion.

La propiedad arquitectonica clave: tu Mac nunca acepta conexiones entrantes de internet. El tunel es solo de salida, lo que significa que no hay puertos que abrir, no hay reglas de firewall, y no hay exposicion a escaneadores de puertos.

Rendimiento

Cloudflare Tunnel agrega latencia medible porque el trafico se enruta a traves de la red de borde de Cloudflare:

La latencia varia segun tu distancia geografica al servidor de borde de Cloudflare mas cercano. Cloudflare opera en mas de 300 ciudades, por lo que la mayoria de los usuarios en areas urbanas ven latencia hacia el extremo inferior de estos rangos. Los usuarios en regiones con menos puntos de presencia de Cloudflare pueden experimentar mayor latencia.

En la practica, esta latencia es notable durante los primeros minutos de uso pero rapidamente se vuelve imperceptible. La salida del terminal sigue desplazandose con fluidez, y las interacciones de aprobacion se mantienen lo suficientemente receptivas como para que la mayoria de los usuarios las gestionen en menos de 15 segundos tras la notificacion.

Perfil de seguridad

Cloudflare Tunnel proporciona una postura de seguridad mas fuerte que el modo Red local en varios aspectos:

Sin superficie de ataque entrante. Tu Mac nunca escucha conexiones de internet. No hay nada que escanear por puertos, nada que forzar desde el exterior.

Cifrado TLS. Todo el trafico entre tu iPhone y Cloudflare, y entre Cloudflare y tu Mac, esta cifrado con TLS. Combinado con la autenticacion por Token de Tactic Remote, esto proporciona dos capas de seguridad independientes.

La proteccion DDoS y contra bots de Cloudflare se aplica a tu endpoint del tunel por defecto, anadiendo proteccion contra ataques automatizados.

La contrapartida: el trafico transita a traves de la red de Cloudflare. Aunque esta cifrado, esto significa que Cloudflare es un intermediario de confianza. Para la mayoria de los desarrolladores individuales, esta es una contrapartida aceptable dada la conveniencia. Para entornos sensibles, consulta nuestra guia de Seguridad y endurecimiento de red para medidas adicionales.

Limitaciones

• Requiere una cuenta de Cloudflare. Necesitas una cuenta gratuita de Cloudflare y un dominio gestionado por Cloudflare. El tunel en si es gratuito, pero la configuracion DNS inicial toma unos minutos.
• Dependencia de la disponibilidad de Cloudflare. Si Cloudflare experimenta una interrupcion, el acceso en modo tunel no esta disponible. Esto es raro (el historial de tiempo de actividad de Cloudflare es solido) pero vale la pena mencionarlo.
• Mayor latencia que el modo local. Como se detallo anteriormente, cada interaccion agrega 50-200ms comparado con el modo Red local.

Flujo de conexion por codigo QR

Ambos modos usan el mismo flujo de codigo QR para el emparejamiento inicial, pero el contenido del codigo QR difiere:

Codigo QR de Red local codifica: http://<local-ip>:<port> mas el Token de autenticacion.

Codigo QR de Cloudflare Tunnel codifica: https://<your-tunnel-domain> mas el Token de autenticacion.

La aplicacion de iPhone detecta a que modo se esta conectando basandose en el esquema de URL y las caracteristicas de red. Si el codigo QR contiene una direccion IP local, la aplicacion se configura para el modo Red local. Si contiene un dominio HTTPS, se configura para el modo Cloudflare Tunnel.

Para cambiar de modo, generas un nuevo codigo QR desde el menu desplegable de la barra de menu de la aplicacion Companion y lo escaneas con tu iPhone. La aplicacion reemplaza la configuracion de conexion anterior. El cambio completo de modo toma menos de 10 segundos.

Comparacion lado a lado

Patrones de uso recomendados

Usa el modo Red local cuando estes en tu escritorio o en la misma red que tu Mac. La menor latencia hace que el streaming de terminal sea notablemente mas fluido, y no hay dependencia de terceros.

Usa el modo Cloudflare Tunnel cuando necesites acceso desde fuera de tu red local — desplazandote, viajando, trabajando desde otra ubicacion, o cuando quieras iniciar una tarea en casa y monitorearla desde la oficina.

Usa ambos configurando Cloudflare Tunnel en tu Mac pero conectandote via modo Red local cuando estes en casa. La aplicacion Companion puede servir ambos modos simultaneamente. Tu iPhone puede almacenar ambos perfiles de conexion, y cambiar entre ellos es un solo toque en la configuracion de conexion de la aplicacion.

Muchos de nuestros usuarios configuran Cloudflare Tunnel una vez como seguro y usan el modo Red local dia a dia. Cuando salen de casa, cambian al perfil del tunel. Esto les da la mejor latencia cuando esta disponible y acceso remoto cuando lo necesitan.

Proximos pasos

Estamos explorando la seleccion automatica de modo que detecte cuando tu iPhone esta en la misma red que tu Mac y enrute localmente, volviendo a Cloudflare Tunnel cuando te vayas. Esto eliminaria el cambio manual de modo por completo. Las pruebas iniciales muestran deteccion de red confiable en iOS, pero los casos limite con VPN y configuraciones de tunel dividido aun necesitan trabajo.

Para instrucciones de configuracion, consulta Primeros pasos para el modo Red local y Configuracion de Cloudflare Tunnel para la configuracion de acceso remoto.