feat: add Ngrok tunnel provider (#1415)

Adds Ngrok quick tunnel support
Adds desktop tunnel docs across locales
Improves tunnel settings provider and TTL labels
This commit is contained in:
Bohdan Triapitsyn
2026-05-25 18:00:03 +03:00
committed by GitHub
parent 25ed8e6abb
commit 00a7807168
22 changed files with 893 additions and 28 deletions
@@ -0,0 +1,41 @@
---
title: Túneles de escritorio
description: Crea túneles de Cloudflare o Ngrok desde la app de escritorio.
---
# Túneles de escritorio
La app de escritorio puede crear un túnel público desde **Settings → OpenChamber → Tunnel**. No necesitas iniciar OpenChamber desde el CLI para este flujo.
## Instala un proveedor
OpenChamber inicia el CLI del proveedor en tu máquina. Instala primero el proveedor que quieras usar:
```bash
brew install cloudflared
brew install ngrok
```
Cloudflare usa `cloudflared`. Ngrok requiere una cuenta de ngrok y un authtoken del panel de ngrok:
```bash
ngrok config add-authtoken <your-ngrok-token>
```
## Inicia desde la app
1. Abre **Settings → OpenChamber → Tunnel**.
2. Elige **Cloudflare** o **Ngrok**.
3. Inicia un quick tunnel.
4. Escanea el código QR generado desde tu teléfono.
Ngrok actualmente soporta quick tunnels. Cloudflare soporta quick tunnels y modos gestionados de Cloudflare.
## Protección de acceso
Aunque la URL del proveedor sea pública, OpenChamber sigue protegiendo el acceso con su propio connect token. El enlace generado contiene un token de un solo uso, tiene TTL, y los enlaces antiguos sin usar se revocan cuando generas uno nuevo o detienes/reinicias el túnel.
## Relacionado
- [Túneles](/es/tunnels/) — uso de túneles por CLI y modos gestionados de Cloudflare
- [PWA y acceso móvil](/es/mobile/) — accede a OpenChamber desde tu teléfono
+31 -2
View File
@@ -7,7 +7,22 @@ description: Expón OpenChamber de forma segura para acceso remoto y móvil.
Un túnel es un enlace público a tu OpenChamber, para que puedas acceder a él desde tu teléfono u otra red. Usa `openchamber tunnel` para crear uno para una instancia en marcha.
## Inicio rápido (modo rápido de Cloudflare)
## Requisitos previos
OpenChamber inicia el CLI del proveedor de túnel en tu máquina. Instala primero el proveedor que quieras usar:
```bash
brew install cloudflared
brew install ngrok
```
Los túneles rápidos de Cloudflare pueden funcionar con `cloudflared`. Ngrok requiere una cuenta de ngrok y un authtoken del panel de ngrok:
```bash
ngrok config add-authtoken <your-ngrok-token>
```
## Inicio rápido
1. Inicia OpenChamber:
@@ -15,12 +30,18 @@ Un túnel es un enlace público a tu OpenChamber, para que puedas acceder a él
openchamber
```
2. Inicia un túnel:
2. Inicia un túnel de Cloudflare:
```bash
openchamber tunnel start --provider cloudflare --mode quick
```
O inicia un túnel de Ngrok:
```bash
openchamber tunnel start --provider ngrok --mode quick
```
3. Comprueba el estado:
```bash
@@ -31,6 +52,11 @@ Cuando el túnel está activo, `status` muestra una URL pública. Ábrela, o esc
Por defecto, OpenChamber imprime un código QR en sesiones TTY interactivas. Usa `--qr` para forzar la salida del QR, o `--no-qr` para desactivarla.
## Proveedores
- `cloudflare`: modos quick, managed remote y managed local
- `ngrok`: modo quick
## Modos gestionados
### Gestionado remoto
@@ -68,7 +94,9 @@ openchamber tunnel start --profile prod-main
```bash
openchamber tunnel providers
openchamber tunnel ready --provider cloudflare
openchamber tunnel ready --provider ngrok
openchamber tunnel doctor --provider cloudflare
openchamber tunnel doctor --provider ngrok
openchamber tunnel stop --port 3000
```
@@ -81,5 +109,6 @@ openchamber tunnel stop --port 3000
## Relacionado
- [Seguridad](/es/security/) — protege la interfaz antes de exponerla
- [Túneles de escritorio](/es/desktop-tunnels/) — configuración de túneles en la app de escritorio sin iniciar desde CLI
- [PWA y acceso móvil](/es/mobile/) — accede a OpenChamber desde tu teléfono
- [Resolución de problemas](/es/troubleshooting/) — si el enlace del túnel no funciona