cftunnel
Herramienta CLI en Go para penetración de red interna con dos modos: Cloud (Cloudflare Tunnel) y Relay (frp). Permite compartir servicios web, acceder a servidores de juegos o SSH sin IP pública, y automatizar gestión de túneles vía AI.
Ficha actualizada 18 sept 2026, 21:16 · upstream 2 mar 2026, 3:45 · release v0.8.1
Qué es cftunnel
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
cftunnel es una herramienta CLI escrita en Go que facilita la penetración de red interna mediante dos modos operativos: Cloud y Relay. El modo Cloud utiliza Cloudflare Tunnel para exponer servicios HTTP/HTTPS/WebSocket sin necesidad de IP pública, generando dominios temporales o configurando rutas con CNAME automático. El modo Relay emplea frp (frpc/frps) para soportar TCP/UDP/HTTP en servidores propios, ideal para juegos, SSH o bases de datos.
La herramienta actúa como capa de gestión: descarga binarios de los motores subyacentes, orquesta procesos y gestiona configuraciones en ~/.cftunnel/config.yml. Soporta instalación automática en macOS, Linux y Windows mediante systemd, launchd o servicios nativos, con actualizaciones automáticas y modo portable.
Incluye integración con asistentes AI como Claude Code para gestión directa de túneles vía comandos naturales, y cuenta con un cliente desktop (cftunnel-app) para visualización gráfica. Ofrece scripts de instalación remota para servidores Relay y detección automática de errores comunes como timeouts QUIC o DNS fake-ip.
- Compartir servicios web locales (ej. desarrollo frontend) mediante dominio temporal *.trycloudflare.com sin IP pública.
- Acceder a servidores de juegos (Minecraft, Rust) o SSH desde fuera usando Relay con frp en un VPS propio.
- Automatizar gestión de túneles vía CLI o asistentes AI como Claude Code para despliegues efímeros.
- Exponer APIs locales o webhooks con autenticación básica (--auth user:pass) sin exponer puertos directamente.
- Soporta dos modos independientes (Cloud y Relay) que pueden coexistir simultáneamente en el mismo sistema.
- Genera dominios temporales automáticos con Cloudflare sin necesidad de configuración DNS manual ni cuenta previa.
- Integración nativa con frp para penetración TCP/UDP/HTTP en servidores propios con token de autenticación.
- Gestión automática de binarios (cloudflared, frpc/frps) y soporte para systemd/launchd en Linux/macOS.
- Scripts de instalación remota para configurar servidores Relay (frps) vía SSH o Docker Compose.
- Modo portable que almacena configuración y logs en el directorio del ejecutable sin instalaciones globales.
- El modo Cloud requiere cuenta gratuita de Cloudflare; dominios temporales expiran al cerrar sesión.
- El modo Relay necesita un servidor público con IP fija y puertos abiertos (ej. frps en puerto 7000).
- No incluye Dockerfile ni soporte nativo para contenedores, aunque permite ejecutar binarios externos.
- La gestión de rutas Cloud depende de la API de Cloudflare; errores DNS pueden requerir reinicio del servicio.
- Modo Relay no soporta encriptación TLS por defecto; requiere configuración manual de frps para certificados.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instalar vía curl | bash (Linux/macOS) o PowerShell (Windows). Para Cloud: cftunnel quick <puerto> o cftunnel init con token API. Para Relay: instalar frps en servidor y usar cftunnel relay init. Registrar servicio con cftunnel install para arranque automático. Verificar logs con cftunnel logs -f si hay errores de conexión QUIC o DNS.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.