TrustTunnel v1.1.0 — Open-source VPN protocol that tunnels TCP, UDP, and ICMP traffic over HTTPS, bypassing DPI and throttling. Features split tunneling, SOCKS5 proxy, custom DNS, and cross-platform clients.

TrustTunnel

Clientes · App Store (iOS) · App Store (macOS) · Play store

Tabla de contenidos

Introducción
Características del servidor
Características del cliente
Inicio rápido
- Configuración del endpoint
- Configuración del cliente
Clientes
Ver también
Hoja de ruta
Licencia

Introducción

TrustTunnel es un protocolo VPN moderno y de código abierto desarrollado originalmente por AdGuard VPN y ahora disponible para que cualquiera lo use y audite.

Ofrece conexiones VPN rápidas, seguras y fiables sin las contrapartidas habituales. Por diseño, el tráfico de TrustTunnel es indistinguible del tráfico HTTPS normal, lo que le permite eludir la limitación de velocidad y la inspección profunda de paquetes mientras mantiene sólidas protecciones de privacidad.

El proyecto TrustTunnel incluye el endpoint VPN (este repositorio), la biblioteca y CLI para el cliente, y la aplicación GUI.

Características del servidor

Protocolo VPN: La biblioteca implementa el protocolo VPN compatible con HTTP/1.1, HTTP/2 y QUIC. Al imitar el tráfico de red normal, se vuelve imposible de detectar y bloquear.
Tunelización flexible del tráfico: TrustTunnel puede tunelizar tráfico TCP, UDP e ICMP hacia y desde el cliente.
Compatibilidad de plataformas: El servidor es compatible con Linux y macOS. El cliente está disponible para Android, Apple, Windows y Linux.
Endpoint de suscripción: Opcionalmente, servir una URL de suscripción por usuario a través de HTTPS. Cuando [subscription] está habilitado en vpn.toml, cada cliente puede obtener su propia configuración JSON (parámetros de conexión, credenciales, upstreams de DNS, y más) a través de HTTPS usando HTTP Basic Auth, lo que permite el autoservicio y la actualización automática de la configuración del cliente sin redistribución manual de archivos.

Características del cliente

Tunelización del tráfico: La biblioteca es capaz de tunelizar tráfico TCP, UDP e ICMP desde el cliente hasta el endpoint y de vuelta.
Compatibilidad multiplataforma: Es compatible con las plataformas Linux, macOS y Windows, proporcionando una experiencia consistente en diferentes sistemas operativos.
Túnel a nivel de sistema y proxy SOCKS5: Se puede configurar como un túnel a nivel de sistema, utilizando una interfaz de red virtual, así como un proxy SOCKS5.
Tunelización dividida: La biblioteca admite la tunelización dividida, lo que permite a los usuarios excluir conexiones a ciertos dominios o hosts del enrutamiento a través del endpoint VPN, o viceversa, enrutando solo las conexiones a dominios o hosts específicos a través del endpoint según una lista de exclusión.
Upstream de DNS personalizado: Los usuarios pueden especificar un upstream de DNS personalizado, que se utiliza para las consultas de DNS enrutadas a través del endpoint VPN.

Inicio rápido

Configuración del endpoint

Instalar el endpoint

Hay disponible un script de instalación que se puede ejecutar con el siguiente comando:```bash curl -fsSL https://raw.githubusercontent.com/TrustTunnel/TrustTunnel/refs/heads/master/scripts/install.sh | sh -s -

El script de instalación descargará el paquete precompilado desde la última
versión de GitHub para la arquitectura del sistema correspondiente y lo
desempaquetará en `/opt/trusttunnel`. El directorio de salida puede
sobrescribirse especificando el flag `-o DIR` al final del comando anterior.

Si deseas instalar una versión específica (en lugar de la última), usa `-V <version>`:```bash
curl -fsSL https://raw.githubusercontent.com/TrustTunnel/TrustTunnel/refs/heads/master/scripts/install.sh | sh -s - -V <version>

[!NOTE] Hay paquetes precompilados disponibles para las arquitecturas linux-x86_64, linux-aarch64 y macos-universal (Intel y Apple Silicon).

Actualización del endpoint

El script de instalación siempre instala la última versión disponible. Por lo tanto, para actualizar tu instalación, ejecuta de nuevo el comando de instalación:```bash curl -fsSL https://raw.githubusercontent.com/TrustTunnel/TrustTunnel/refs/heads/master/scripts/install.sh | sh -s -

Esto vuelve a ejecutar el instalador y reemplaza los binarios en el directorio
de instalación (`/opt/trusttunnel` por defecto, o el directorio que especificaste con `-o DIR`).

> [!NOTE]
> No olvides detener el endpoint antes de actualizar:
>
> ```bash
> sudo systemctl stop trusttunnel
> ```
>
> Para iniciar el endpoint de nuevo después de actualizar:
>
> ```bash
> sudo systemctl start trusttunnel
> ```

#### Asistente de configuración del endpoint

Consulta [CONFIGURATION.md](https://github.com/trusttunnel/trusttunnel/blob/master/CONFIGURATION.md) para obtener documentación más
detallada sobre cómo configurar el endpoint.

El directorio de instalación contiene el binario `setup_wizard` que ayuda a generar
los archivos de configuración necesarios para que el endpoint se ejecute:```bash
cd /opt/trusttunnel/
./setup_wizard -h

El asistente de configuración admite el modo interactivo, por lo que puedes ejecutarlo y te solicitará los datos necesarios para la configuración del endpoint.```bash cd /opt/trusttunnel/ sudo ./setup_wizard

> [!NOTE]
> Se requiere `sudo` para gestionar los certificados TLS correctamente.

El asistente solicitará los siguientes campos, algunos de ellos tienen los valores predeterminados que puede usar de forma segura: