Volver a actualizaciones
Nuevo releaseAug 18, 2026

gotatun v0.9.0

Implementación de WireGuard® en espacio de usuario en Rust

Compartir

GotaTun

Una implementación de WireGuard® en espacio de usuario, y un fork de BoringTun.

Contribuir

Consulta las directrices de contribución.

Licencia

Todo el código fuente de este repositorio está sujeto a los términos de la Licencia Pública de Mozilla, versión 2.0, salvo que se indique lo contrario. Puedes encontrar una copia de esta licencia en el archivo "LICENSE" o en https://www.mozilla.org/MPL/2.0/.

Las contribuciones realizadas antes del 5 de marzo de 2026 están licenciadas bajo la antigua licencia BSD de 3 cláusulas. Puedes encontrar una copia de esta licencia en el archivo "LICENSE-CLOUDFLARE".

Compilación

  • Solo biblioteca: cargo build --lib --no-default-features --release [--target $(TARGET_TRIPLE)]
  • Ejecutable: cargo build --bin gotatun --release [--target $(TARGET_TRIPLE)]

Instalación

Por defecto, el ejecutable se coloca en la carpeta ./target/release. Puedes copiarlo manualmente a la ubicación deseada, o instalarlo usando cargo install --bin gotatun --path ..

Nix

Para compilar el ejecutable, simplemente ejecuta nix build .#gotatun. El binario final se ubicará en result/bin/gotatun.

Ejecución

Según la especificación, para iniciar un túnel usa:

gotatun [-f/--foreground] INTERFACE-NAME

El túnel puede configurarse entonces usando wg, como un túnel WireGuard normal, o cualquier otra herramienta.

También es posible usarlo con wg-quick estableciendo la variable de entorno WG_QUICK_USERSPACE_IMPLEMENTATION a gotatun. Por ejemplo:

sudo WG_QUICK_USERSPACE_IMPLEMENTATION=gotatun WG_SUDO=1 wg-quick up CONFIGURATION

Ten en cuenta que wg-quick ignorará WG_QUICK_USERSPACE_IMPLEMENTATION en Linux si tienes instalado el módulo de kernel de wireguard.

Pruebas

Probar este proyecto tiene algunos requisitos:

  • sudo: necesario para crear túneles. Cuando ejecutes cargo test se te pedirá tu contraseña.
  • Docker: puedes instalarlo aquí. Si usas Ubuntu/Debian puedes ejecutar apt-get install docker.io.

Plataformas compatibles

Target tripleBinarioBiblioteca
x86_64-unknown-linux-gnu✓✓
aarch64-unknown-linux-gnu✓✓
riscv64gc-unknown-linux-gnu✓✓
aarch64-apple-darwin✓✓
x86_64-pc-windows-msvc✓✓
x86_64-pc-windows-gnullvm✓✓
aarch64-pc-windows-msvc✓✓
aarch64-pc-windows-gnullvm✓✓
x86_64-linux-android✓
aarch64-linux-android✓
aarch64-apple-ios✓

Otros targets pueden funcionar, pero solo probamos estos

Linux

Se admiten las arquitecturas x86-64 y aarch64. El comportamiento debería ser idéntico al de wireguard-go, con la siguiente diferencia:

gotatun abandonará los privilegios al iniciarse. Cuando se abandonan los privilegios no es posible establecer fwmark. Si se requiere fwmark, como al usar wg-quick, ejecuta con --disable-drop-privileges o establece la variable de entorno WG_SUDO=1.

Deberás otorgar al ejecutable la capacidad CAP_NET_ADMIN usando: sudo setcap cap_net_admin+epi gotatun. No se necesita sudo.

macOS

El comportamiento es similar al de wireguard-go. En concreto, el nombre de la interfaz debe ser utun[0-9]+ para un nombre de interfaz explícito, o utun para que el kernel seleccione la más baja disponible. Si eliges utun como nombre de interfaz, y la variable de entorno WG_TUN_NAME_FILE está definida, entonces el nombre real de la interfaz elegida por el kernel se escribe en el archivo especificado por esa variable.

Extensiones UAPI

Consulta UAPI para las extensiones del protocolo de configuración de wg.


Auditorías

Se han realizado auditorías de seguridad independientes sobre el proyecto. Consulte el directorio de auditorías.


WireGuard es una marca registrada de Jason A. Donenfeld. GotaTun no está patrocinado ni respaldado por Jason A. Donenfeld.

Categorías