Icono de Kivuko

Kivuko

Un cliente de NordVPN para la barra de menús del Mac, escrito en Rust y basado en WireGuard.

Kivuko (ki-VU-ko) significa “cruce” o “transbordador” en suajili.

Compilar desde el código fuenteChip de Apple · macOS 14 o posterior Código fuente en GitHubgithub.com/piedol/kivuko

Kivuko es un proyecto independiente. Nord Security no lo ha creado, ni lo respalda ni le da soporte. Necesitas tu propia suscripción a NordVPN.

El menú de Kivuko durante una conexión: Disconnect, Location con United States, y Kill Switch, Auto-Connect y Block Ads and Trackers marcados

Kill switch, reconexión automática y bloqueo de anuncios

Kivuko es un cliente de NordVPN gratuito y de código abierto para macOS que se conecta mediante WireGuard (NordLynx).

macOS aplica el kill switch de Kivuko. Kivuko se vuelve a conectar tras el reposo y los cambios de red, y puede bloquear anuncios y rastreadores mediante el DNS de NordVPN. La app de la barra de menús usa unos 23 MB de memoria, y el túnel, unos 8 MB.

Su túnel ejecuta GotaTun, la implementación de WireGuard en Rust de Mullvad, dentro de una extensión packet-tunnel de macOS. macOS inicia y reinicia esa extensión, por ejemplo tras el reposo.

Cuando un servidor deja de responder

Kivuko comprueba el handshake de WireGuard cada 15 segundos.

  1. 8 sProbar el siguiente servidorSi un servidor no responde en 8 segundos, Kivuko prueba con el siguiente, hasta tres.
  2. 3 minForzar un handshakeSi no llega ningún handshake de WireGuard en 3 minutos, Kivuko fuerza uno nuevo.
  3. 6 minReiniciar en otro servidorA los 6 minutos, macOS reinicia el túnel en un servidor nuevo (con Auto-Connect activado).

Cómo funciona

Kivuko.app                     app/       menu bar app: menu, token prompt, VPN configuration
└── Contents/PlugIns/
    └── KivukoTunnel.appex     provider/  packet-tunnel extension: server choice, GotaTun, watchdog
  • La app de la barra de menús gestiona la configuración VPN que macOS guarda en Ajustes del Sistema › VPN, incluidos el kill switch, la regla On-Demand y la elección de DNS.
  • El túnel es un proveedor packet-tunnel de NetworkExtension. macOS lo inicia cada vez que se inicia la VPN, incluidas las reconexiones automáticas mientras la app no está abierta.
  • En cada inicio, el túnel pide a NordVPN los servidores WireGuard recomendados, pasa a macOS las direcciones, las rutas y el DNS, y ejecuta GotaTun en la interfaz de túnel que crea macOS.
  • docs/architecture.md explica las decisiones de diseño, la secuencia de conexión y el watchdog.

Privacidad y seguridad

Kivuko solo se comunica con la API de NordVPN y el servidor VPN al que estás conectado, y no envía analíticas.

  • Tu token de acceso de NordVPN se guarda en tu llavero de inicio de sesión. Cuando haces clic en Connect, la app se lo pasa al túnel, que lo usa para obtener tu clave de WireGuard de NordVPN.
  • El túnel guarda la clave de WireGuard en su propio contenedor aislado (sandbox), que solo puede leer tu usuario (modo 0600).
  • Cualquier usuario del Mac puede leer la configuración VPN de macOS, así que Kivuko solo guarda ahí tu país y tu elección de DNS.
  • Los registros anotan eventos, nunca el token ni la clave. docs/setup.md enumera todos los archivos que escribe Kivuko.

Uso de recursos

Medido en un MacBook Pro con macOS 26.

MemoriaCPU
App de la barra de menús23 MB0 % en reposo
Túnel8 MBMenos del 1 % con tráfico en segundo plano; alrededor del 26 % de un núcleo al descargar a 212 Mbit/s

Consigue Kivuko

No hay una descarga lista para usar. macOS solo carga extensiones VPN firmadas con una membresía de pago del Apple Developer Program, así que tienes que compilar y firmar Kivuko tú mismo. La guía completa está en docs/setup.md.

Requisitos

Mac
Chip de Apple
macOS
14 o posterior (de momento, solo probado en macOS 26)
Servicio VPN
Tu propia suscripción a NordVPN
Firma
Una membresía de pago del Apple Developer Program

Para compilarlo

Xcode
Con la sesión iniciada en esa cuenta
XcodeGen
github.com/yonaskolb/XcodeGen
Rust
1.95 o posterior

  1. Clona el repositorio y elige tu propio prefijo de bundle ID, como com.yourname:

    git clone https://github.com/piedol/kivuko.git
    cd kivuko && cp signing/local.env.example signing/local.env

    Define KIVUKO_BUNDLE_PREFIX en signing/local.env, y KIVUKO_TEAM si tu ID de Apple pertenece a varios equipos de desarrollo. scripts/bundle.sh --check muestra qué se va a firmar.

  2. Compila, firma e instala. En la primera ejecución, Xcode registra tu Mac y los dos bundle IDs, y descarga los perfiles de desarrollo:

    scripts/bundle.sh --install

  3. Consigue un token de acceso de NordVPN en Nord Account › NordVPN › Advanced settings › Access token.

  4. Haz clic en el escudo de la barra de menús y elige Set Up and Connect. Pega el token, haz clic en Save and Connect y, después, en Permitir cuando macOS pida añadir una configuración VPN.

Los perfiles de desarrollo duran un año. Cuando caducan, macOS deja de cargar Kivuko; para renovarlos, vuelve a ejecutar scripts/bundle.sh --install. No tengas una segunda copia de Kivuko en tu Mac. Si hay dos copias de la extensión del túnel registradas, al abrir cualquiera de las dos copias de la app macOS detiene el túnel de la otra, y la VPN se cae.

Para desinstalarlo, sigue en orden los pasos de desinstalación. Si eliminas primero la app, el kill switch puede quedarse bloqueando tu conexión hasta que elimines la configuración VPN.

Preguntas frecuentes

¿Kivuko es gratis y de código abierto?

Sí. Kivuko se puede descargar y usar gratis, y su código fuente está en GitHub bajo la GNU General Public License v3.0 o posterior.

¿Necesito una suscripción a NordVPN?

Sí. Kivuko se conecta a NordVPN con tu propia suscripción, mediante un token de acceso de Nord Account › NordVPN › Advanced settings.

¿Kivuko está vinculado a Nord Security?

No. Kivuko es un proyecto independiente. Nord Security no lo ha creado, ni lo respalda ni le da soporte.

¿Cómo se instala Kivuko?

Compílalo desde el código fuente en un Mac con chip de Apple y macOS 14 o posterior. macOS solo carga extensiones VPN firmadas con una membresía de pago del Apple Developer Program, así que no hay una descarga lista para usar. Los pasos están en docs/setup.md.

¿Qué envía Kivuko por la red?

Solo se comunica con la API de NordVPN y el servidor VPN al que estás conectado, y no envía analíticas. Tu token de acceso se queda en tu llavero de inicio de sesión.

¿Cómo se desinstala Kivuko?

Sal primero de Kivuko; después elimina su configuración en Ajustes del Sistema › VPN, traslada Kivuko.app a la papelera y borra su token del llavero de inicio de sesión. Si eliminas primero la app, el kill switch puede quedarse bloqueando tu conexión.

Licencia

Kivuko es software libre bajo la GNU General Public License v3.0 o posterior. Los informes de errores y las pull requests son bienvenidos en GitHub.

Úsalo donde quieras, también en el trabajo, y lee, modifica y comparte el código fuente. Si distribuyes una versión modificada, publica su código fuente con la misma licencia.

Créditos: GotaTun, de Mullvad, wireguard-apple y objc2.