local-web-tunnel
Installation
SKILL.md
Artefacto web local → túnel público persistente (cloudflared + launchd)
When to Use
el operador necesita ver un artefacto web local (dashboard HTML, demo, landing) desde el móvil — p.ej. el navegador interno de Orca, donde no puede tocar ni refrescar HTML — o compartir un demo por Discord/WhatsApp. Patrón de casa: HTTP local + túnel trycloudflare (sin login, gratis) + agente launchd para que sobreviva a la sesión de Hermes y a reinicios del Mac (vuelve al hacer login).
Pasos
- Comprobar
which cloudflared(brew: /opt/homebrew/bin/cloudflared) y elegir un puerto libre:lsof -i :8085 -sTCP:LISTEN. - Servir el artefacto SOLO en localhost:
python3 -m http.server PORT --bind 127.0.0.1desde su directorio. El puerto no se expone a la LAN; lo único público es el túnel. - Túnel:
cloudflared tunnel --url http://127.0.0.1:PORT— la URL trycloudflare aparece en stdout/log en ~5-10s. Extraerla congrep -o "https://[a-z0-9-]*\.trycloudflare\.com" <log>. - Persistencia: agente launchd con KeepAlive + wrapper idempotente (plantillas en
templates/). Arrancar conlaunchctl load -w ~/Library/LaunchAgents/<label>.plist; parar conlaunchctl unload(matar cloudflared/http.server a mano si quedan). - Verificar SIEMPRE con curl: 200 en
http://127.0.0.1:PORT/index.htmly 200 en la URL pública. Confirmar conlaunchctl list | grep <label>(PID vivo).
Acceso privado desde el móvil: tailscale serve (preferido si hay tailnet)
trycloudflare publica al mundo entero y la URL cambia en cada relanzamiento. Si el artefacto
es algo con poder real (un harness de agentes que ejecuta bash, un panel de administración),
lo correcto es el tailnet: WireGuard cifrado, URL fija, cero exposición a Internet.