Guía de configuración

De cero a operar: instalación, wizard, políticas, doctor y primera conexión. 15–20 minutos, paso a paso por sistema operativo.

Cómo funciona

Kongtrol no es un cliente VPN — es la capa que se sienta entre tus apps y los clientes VPN que ya tienes instalados (FortiClient, OpenVPN, ProtonVPN, etc.). El policy engine mira cada conexión saliente (dominio, IP o app) y decide por cuál túnel debe salir; el resto de comandos (up, doctor,status) solo controlan ese enrutamiento y el ciclo de vida de los túneles.

tus apps

Chrome, Slack, terminal, código…

kongtrol

policy engine — dominios · IPs · apps

tus VPNs

FortiClientoffice
OpenVPNdev-server
ProtonVPNus-content
Inicio rápido

Ya tienes tus VPNs instaladas y funcionando. Kongtrol solo las orquesta — tres comandos y estás operando. Las 10 secciones de abajo son referencia; vuelve a ellas solo si algo no calza.

  1. 1
    Registra tus perfiles

    Detecta clientes, guarda credenciales en el keychain, arma políticas.

    bash
    $ kongtrol init
    
  2. 2
    Valida el stack

    Binarios, certificados, keychain y permisos — antes de conectar.

    bash
    $ kongtrol doctor
    
  3. 3
    Conecta y opera

    Levanta un grupo, mira el estado en vivo, abre el panel.

    bash
    $ kongtrol up --group work
    $ kongtrol status --watch
    $ kongtrol dashboard
    
1

Prerequisitos

Kongtrol orquesta los clientes VPN existentes — no los reemplaza. Deben estar instalados antes de correr kongtrol init.

VPNCliente requeridoVerificar
FortiClientFortiClient 6.4.xAbrir FortiClient — debe aparecer al menos una conexión guardada en la lista. Si puedes conectarte manualmente desde la GUI, está listo.
OpenVPNOpenVPN Communityopenvpn --version
WireGuardwireguard-toolswg --version
ProtonVPNApp oficial de ProtonVPN (o WireGuard con su .conf)Inicia sesión en la app. En Linux Kongtrol puede conectar por ti; si no, conectas tú y lo detecta. Sin app: perfil wireguard con el .conf de Proton.
Cloudflare WARPwarp-cliwarp-cli --version
No cierres la app de tu VPN: Kongtrol trabaja con ella. Si el túnel ya está arriba, se engancha a él. Si no, abre la app y conecta por ti donde se puede; si no puede, te dice qué hacer y espera a que conectes.
ComandoEstado requerido de los clientes
kongtrol initCualquiera — solo lee archivos y keychain
kongtrol doctorCualquiera — solo valida, no conecta
kongtrol up <perfil>App instalada; abierta o cerrada da igual (Kongtrol la abre si hace falta)
2

Instalación

bash
$ curl -L https://github.com/DerotLuna/vpn-kongtrol/releases/latest/download/kongtrol_linux_amd64.tar.gz | tar xz
$ sudo mv kongtrol /usr/local/bin/

# Verificar
$ kongtrol --help

Un solo paso con administrador: corre kongtrol service install una vez y acepta el permiso. Instala un ayudante que hace los cambios de red (rutas, DNS, kill switch). Después ningún comando necesita una terminal de administrador ni sudo.

3

Registrar tus VPNs: kongtrol init

kongtrol init no configura tus VPNs — eso ya lo tienes hecho. Lo que hace es decirle a Kongtrol dónde están y cómo hablarles: qué cliente usar, qué tunnel name tiene, dónde está el .ovpn, y guarda las credenciales en el keychain del OS (nunca en el YAML).

Si ya tienes FortiClient con un túnel funcionando y OpenVPN con su .ovpn, este paso solo recopila esa información.

Archivos de conexión

Si ya tienes tus VPNs configuradas, no necesitas hacer nada especial aquí. Kongtrol apunta a los archivos donde ya están — en el wizard simplemente escribes la ruta actual de cada archivo. Solo hace falta actuar si recibes archivos nuevos de un compañero o de IT y no tienes dónde guardarlos, o si quieres reorganizar todo en un directorio único.

AdaptadorQué necesita el wizard¿Tienes que hacer algo?
FortiClientRuta al cert, ruta a la key, credencialesTener el .crt y .key en alguna ruta accesible y anotarla.
OpenVPNRuta al .ovpnNo, si ya tienes el .ovpn. Solo anotar su ruta actual.
ProtonVPNModo GUI: credenciales Proton. Modo automático: archivo .conf de WireGuard.GUI: no archivos. WireGuard: exportar config desde Proton y guardar la ruta.
WireGuard / otrosRuta al archivo de configNo, si ya tienes el archivo. Solo anotar su ruta.
Organización opcional: si quieres centralizar, puedes crear ~/.kongtrol/certs/ y copiar los archivos ahí. Útil al incorporar un compañero nuevo o al recibir certs frescos. No es requerido si ya tienes todo en su lugar.

Ejecutar el wizard

bash
$ kongtrol init

Primero seleccionas el idioma, luego el wizard muestra los clientes detectados y te pregunta si quieres agregar un perfil:

text
▸  Clientes VPN detectados en este sistema:
    ✓  FortiClient             6.4.10.1821
    ✓  OpenVPN                 2.6.8
    ✓  ProtonVPN               4.3.14

¿Agregar un nuevo perfil VPN? [s/N]: s

El wizard usa menús numerados donde aplica — no tienes que recordar los valores válidos:

text
  Nombre del perfil: office

  Tipo de adaptador:
    1) forticlient         ✓ detectado  FortiClient SSL VPN
    2) openvpn             ✓ detectado  OpenVPN (archivo .ovpn)
    3) protonvpn           ✓ detectado  ProtonVPN (cuenta Proton)
    ───────────────────────────────
    4) ciscoanyconnect                  Cisco AnyConnect
    5) wireguard                        WireGuard (archivo .conf)
    6) globalprotect                    Palo Alto GlobalProtect
    7) tailscale                        Tailscale mesh / exit node
    8) cloudflarewarp                   Cloudflare WARP

  Elige [1]: 1

Cada campo tiene una pista de dónde encontrar el valor:

Ver ejemplo del flujo por campos (FortiClient)
text
    Encuéntralo en FortiClient > Ajustes o pídelo a IT. Ej: vpn.empresa.com
  Host VPN: vpn.tuempresa.com

    443 para SSL VPN (default). Cambia solo si IT indica otro puerto.
  Puerto [443]:

    El nombre exacto de la conexión tal como aparece en la lista de FortiClient GUI.
  Nombre del túnel [Office]: Office

  Versión de FortiClient:
    1) 6  6.4.x — más común
    2) 7  7.x
    3) 5  5.x — legacy
  Elige [1]:

  Método de autenticación:
    1) credentials              usuario y contraseña
    2) certificate              solo certificado cliente
    3) certificate+credentials  certificado + usuario y contraseña (más seguro)
  Elige [3]:

  Ruta al certificado cliente: ~/.kongtrol/certs/office.crt
  Ruta a la clave privada: ~/.kongtrol/certs/office.key
  Usuario: tu_usuario
  Contraseña para office (guardada en llavero): ****

Para OpenVPN, el wizard apunta a tu archivo .ovpn existente:

Ver ejemplo del flujo por campos (OpenVPN)
text
  Nombre del perfil: dev-server

  Tipo de adaptador:
    ...
  Elige [2]: 2   ← openvpn

    Ruta completa al .ovpn. Usa la ubicación donde ya está, no hace falta copiar.
  Ruta al archivo .ovpn: ~/.config/openvpn/server.ovpn

    Si el .ovpn tiene <cert> y <key> embebidas, elige 'certificate' y deja los paths en blanco.
  Método de autenticación:
    1) credentials              usuario y contraseña
    2) certificate              solo certificado cliente
    3) certificate+credentials  certificado + usuario y contraseña (más seguro)
  Elige [2]:

  Ruta al certificado cliente (vacío si está dentro del .ovpn):
  Ruta a la clave privada (vacío si está dentro del .ovpn):

ProtonVPN: GUI manual vs WireGuard automático

Tienes dos caminos válidos con ProtonVPN según cuánto quieras automatizar.

  • GUI manual (rápido): el usuario opera Proton desde su app y Kongtrol enruta políticas sobre ese perfil.
  • WireGuard automático (recomendado): exporta un archivo .conf desde Proton, crea un perfil type: wireguard y Kongtrol puede levantar/bajar la conexión por comando.
yaml
vpns:
  us-content:
    type: wireguard
    config: ~/.kongtrol/configs/proton-us.conf
    auth:
      method: certificate
ProtonVPN junto a otros adapters (Forti/OpenVPN/etc.): úsalo en un perfil separado y enruta solo dominios/IPs objetivo (ej. streaming). Mantén tráfico corporativo en sus perfiles dedicados para evitar conflictos de ruta.
¿Dónde encuentro el Host y el Tunnel Name de FortiClient?
Abre FortiClient → pestaña Remote Access. Verás una lista de conexiones guardadas. El nombre de la conexión (ej. "Office VPN") es el tunnel name. Haz clic en el ícono de lápiz (editar) junto a esa conexión — ahí verás el campo Remote Gateway o Server: ese es el host.
Si un cliente no fue detectado automáticamente, el wizard te avisa y pide la ruta al binario. También puedes ponerla después en el YAML con binary_path.

Al final, opciones de seguridad, políticas de routing y confirmación:

Ver flujo de seguridad y políticas
text
¿Activar kill switch? [S/n]:
¿Activar DNS guard? [S/n]:
¿Activar log de auditoría firmado? [S/n]:
¿Activar panel web? (http://127.0.0.1:9741) [S/n]:
¿Mostrar tu IP pública? (consulta un servicio externo) [s/N]:
  Usa un servicio externo (api.ipify.org) que ve tu IP pública

── Políticas de enrutamiento ──────────────────────────────────────────────

¿Agregar una política de enrutamiento? [S/n]: s

  Nombre de la política (ej: trabajo, streaming): Claude AI
  Perfil VPN para esta política:
    1) office
    2) us-content
  Elige [1]: 2

    Dominio o sufijo (ej: empresa.com, .internal) — deja en blanco para terminar
  Dominio: claude.ai
  Dominio: *.anthropic.com
  Dominio:

    Rango IP o IP (ej: 10.0.0.0/8) — deja en blanco para terminar
  IP / rango:

¿Agregar una política de enrutamiento? [S/n]: s

  Nombre de la política (ej: trabajo, streaming): Red interna
  Perfil VPN para esta política:
    1) office
    2) us-content
  Elige [1]: 1

  Dominio:

  IP / rango: 10.10.0.0/16
  IP / rango: 192.168.50.0/24
  IP / rango:

¿Agregar una política de enrutamiento? [S/n]:

    También puedes editar políticas directamente en kongtrol.yaml → sección 'policies'.

¿Escribir configuración en ~/.kongtrol/kongtrol.yaml? [S/n]: s

[✓] Configuración escrita en ~/.kongtrol/kongtrol.yaml
[✓] Configuración válida.
Puedes escribir varios dominios separados por coma en un solo prompt — el wizard los divide automáticamente. claude.ai, *.anthropic.com → dos entradas.
Para agregar otro perfil o política después: vuelve a correr kongtrol init. El wizard detecta el config existente y no sobreescribe nada sin confirmación.
4

Grupos

Agrupan perfiles para levantarlos juntos con un solo comando. Edita ~/.kongtrol/kongtrol.yaml y añade al final:

yaml
groups:
  work:
    profiles: [office, dev-server, aws]

  travel:
    profiles: [us-content]

  full:
    profiles: [office, dev-server, aws, us-content]
bash
kongtrol up --group work     # levanta office + dev-server + aws en paralelo
kongtrol down --group work
Un perfil puede pertenecer a varios grupos a la vez — office puede estar en work y también en full sin conflicto.

Si ya tienes un daemon corriendo (kongtrol up en background, o vía dashboard) y editas el grupo a mano, no hace falta reiniciarlo — kongtrol reload --group work recarga el kongtrol.yaml desde disco y reconecta solo los túneles activos de ese grupo. Para un solo túnel puntual, kongtrol reload --tunnel office.

5

Políticas de routing

Cuando tienes varios túneles activos al mismo tiempo, ¿cómo sabe tu computadora qué tráfico va por cuál VPN? Eso lo definen las políticas.

text
  petición                    política                          túnel
  ──────────────────────────────────────────────────────────────────────────
  claude.ai            ──▶   domains: claude.ai            ──▶  us-content (ProtonVPN)
  10.10.4.12           ──▶   ip_ranges: 10.10.0.0/16        ──▶  office     (FortiClient)
  api.tuempresa.com    ──▶   sin coincidencia               ──▶  conexión directa (sin VPN)

Sin políticas, cada VPN instala sus propias rutas al conectarse — el último en conectar suele ganar el tráfico general, y no puedes kongtrolar qué va por dónde. Con políticas, Kongtrol enruta de forma precisa:

  • claude.ai y *.anthropic.com → van por us-content (ProtonVPN)
  • 10.10.0.0/16 (red de oficina) → van por office (FortiClient)
  • *.tuempresa.com → van por office
  • Todo lo demás → conexión directa sin VPN

El wizard (kongtrol init) te permite crear políticas al final del flujo. También puedes agregarlas o editarlas directamente en el YAML bajo la sección policies::

yaml
policies:

  # ── Contenido US / Claude AI ───────────────────────────────────────────
  - name: Claude AI
    match:
      domains:
        - claude.ai
        - "*.anthropic.com"
    via: us-content

  - name: Contenido geo-restringido
    match:
      domains:
        - "*.netflix.com"
        - "*.hulu.com"
        - "*.disneyplus.com"
    via: us-content

  # ── Oficina ────────────────────────────────────────────────────────────
  - name: Red interna de oficina
    match:
      ip_ranges:
        - 10.10.0.0/16          # red interna — ajusta a la tuya
        - 192.168.50.0/24
    via: office

  - name: Dominios internos
    match:
      domains:
        - "*.tuempresa.com"     # cambia al dominio de tu empresa
        - intranet.local
    via: office

  # ── Servidor de desarrollo ─────────────────────────────────────────────
  - name: Servidor dev
    match:
      ip_ranges:
        - 185.0.0.0/32          # reemplaza con la IP real de tu servidor
    via: dev-server

  # ── AWS ────────────────────────────────────────────────────────────────
  - name: AWS workloads
    match:
      ip_ranges:
        - 172.31.0.0/16         # VPC default de AWS — ajusta a tus CIDRs
      domains:
        - "*.amazonaws.com"
    via: aws

  # El tráfico que no coincide con ninguna regla va por tu
  # conexión normal (sin VPN). Para forzar TODO por una VPN:
  # - name: Default
  #   match:
  #     ip_ranges: [0.0.0.0/0]
  #   via: office
¿Cómo funciona el matching?
Dominios: glob exacto o con prefijo *. — *.empresa.com cubre todos los subdominios pero no empresa.com solo (agrega ambos si los necesitas).
IPs: longest-prefix match — gana la regla más específica. 10.10.1.0/24 tiene prioridad sobre 10.0.0.0/8.
Reglas por app (experimental): puedes escribir apps en una regla, pero hoy no cambia el ruteo: solo cuentan domains e ip_ranges. Por ahora apps solo se ve en kongtrol map app:<exe>.
Split-DNS transparente: con monitor.split_dns.enabled: true, Kongtrol inyecta dominios de policy en resolución del sistema (hosts) para que apps normales resuelvan por el túnel correcto sin llamar la API.
bash
# Validar después de editar
$ kongtrol config validate
# [OK] Config is valid.
Si no hay un daemon corriendo todavía, las políticas se leen al ejecutar kongtrol up. Si ya tienes uno activo, aplica el cambio sin reiniciarlo con kongtrol reload --policy — recarga el motor de políticas desde el kongtrol.yaml editado, sin tocar túneles.
6

Verificar con doctor

Antes de conectar por primera vez, deja que Kongtrol valide que todo esté en orden:

bash
$ kongtrol doctor
text
Kongtrol Doctor
────────────────────────────────────────────────────

  Configuración
  ✓  archivo de config   ~/.kongtrol/kongtrol.yaml
  ✓  config válida       4 perfil(es) definido(s)

  Binarios VPN
  ✓  forticlient         FortiClient 6.4.10.1821
  ✓  openvpn             OpenVPN 2.6.8
  ✓  protonvpn           protonvpn-cli 4.3.14

  Certificados y claves
  ✓  office: certificado ~/.kongtrol/certs/office.crt
  ✓  office: clave       ~/.kongtrol/certs/office.key
  ✓  dev-server: archivo config  ~/.kongtrol/configs/server.ovpn

  Credenciales en keychain
  ✓  office: password    encontrada en keychain del sistema
  ✓  us-content: password  encontrada en keychain del sistema

  Permisos
  ✓  kill switch         implementación de plataforma disponible
  ✓  DNS guard           implementación de plataforma disponible

Todos los checks pasaron. Listo para usar.

Si hay ✗ en alguna línea, el mensaje dice exactamente qué falta.

7

Primera conexión

Un grupo completo:

bash
$ kongtrol up --group work
[+] office      conectado
[+] dev-server  conectado
[+] aws         conectado

Varios perfiles sin grupo:

bash
$ kongtrol up office dev-server aws

Los tres túneles se levantan en paralelo. El routing policy determina qué tráfico va por cuál.

Un solo perfil:

bash
$ kongtrol up office
$ kongtrol up us-content

Kongtrol sigue corriendo en segundo plano: cerrar la vista no desconecta nada. Cuando termines:

bash
# q o Ctrl+C  →  cierra la vista; las VPN siguen conectadas

# Para desconectar (desde cualquier terminal):
$ kongtrol down --group work
$ kongtrol down --all

Ver estado:

bash
$ kongtrol status

PROFILE      STATUS        IP           UPTIME
office       connected     10.10.0.5    1h 23m
dev-server   connected     185.x.x.x    1h 23m
aws          connected     172.31.4.7   1h 23m
us-content   disconnected  —            —

Kill switch: ARMADO (protegiendo 3 túnel(es))

# Vista en tiempo real (refresca cada 2s):
$ kongtrol status --watch
8

Dashboard web

bash
$ kongtrol dashboard
# Dashboard running at http://127.0.0.1:9741

Abre http://localhost:9741 en tu navegador. Es una consola de gestión completa, con navegación lateral:

PáginaQué hace
OverviewTúneles en vivo, gráficos de tráfico por túnel, rutas activas, resolución de policy, grupos de acceso rápido, conectar/desconectar todo
StudioPestañas: políticas de routing (CRUD + probador de reglas), perfiles VPN (CRUD, config + keychain), y grupos (CRUD + conectar/desconectar)
SecurityActivar/desactivar Kill Switch y DNS Guard en vivo, override de kill switch por perfil, estado de leak check, consulta de IP pública opcional (apagada por defecto) con botón Revisar
Audit LogEventos de auditoría filtrables por perfil/nivel, con indicador de firma HMAC
SettingsHealth check, scheduler + reglas, split DNS, ajustes de kill switch/DNS guard, servicios de IP pública, audit log
bash
# Endpoints útiles
GET  /api/v1/metrics/history
GET  /api/v1/dns/resolve?domain=claude.ai&via=us-content
GET  /api/v1/resolve?target=portal.empresa.com&app=chrome.exe
POST /api/v1/security/killswitch   {"enabled": true}
POST /api/v1/security/dnsguard     {"enabled": true}
POST /api/v1/security/publicip     {"enabled": true}   # opcional: consulta tu IP pública
POST /api/v1/security/publicip/check                    # Revisar ahora
GET  /api/v1/vpns                  # perfiles · POST/PUT/DELETE para CRUD
GET  /api/v1/groups                # grupos · POST/PUT/DELETE + /connect /disconnect
GET  /api/v1/settings              # PUT para guardar
GET  /api/v1/audit                 # ?profile=&level=&limit=
El dashboard está compilado dentro del binario — no necesitas instalar nada extra. Es gestión completa (crear/editar perfiles, políticas, grupos, activar kill switch en vivo), no solo lectura. El puerto/bind del propio dashboard sigue siendo CLI-only (kongtrol config dashboard set-port <puerto>) — cambiarlo desde la página que sirve la petición rompería la conexión.
9

Uso diario

ComandoQué hace
kongtrol up --group workEmpezar el día (office + dev-server + aws)
kongtrol down --group workTerminar el día
kongtrol up us-contentNetflix, Hulu, Claude AI...
kongtrol down --allApagar todo
kongtrol statusVer qué está conectado
kongtrol status --watchMonitoreo en vivo (2s)
kongtrol status --watch --dashboardMonitoreo en vivo + levanta el dashboard embebido a la vez
kongtrol checkConsultar tu IP pública y probar fugas ahora (si activaste la consulta)
kongtrol dashboardAbrir UI web
kongtrol doctorDiagnóstico completo
kongtrol exportExportar config sin contraseñas (para compartir)

Scheduler opcional por horario:

yaml
monitor:
  scheduler:
    enabled: true
    interval: "1m"
    rules:
      - name: "work-hours"
        profiles: ["office", "aws"]
        weekdays: ["mon","tue","wed","thu","fri"]
        start: "09:00"
        end: "18:00"

Kill switch por perfil (override):

yaml
vpns:
  office:
    kill_switch: true
  us-content:
    kill_switch: false

Actualizar una contraseña:

bash
$ kongtrol init
# → elige el perfil → "¿Actualizar credenciales?" → ingresa la nueva

Referencia de comandos

Los mismos grupos que kongtrol --help. Cada comando trae su ayuda con ejemplos: kongtrol <comando> --help.

ConexiónQué hace
kongtrol up [perfil...] [opciones] --all --dry-run --fav --group grupoConecta uno o más perfiles VPN (o todos con --all)
kongtrol down [perfil...] [opciones] --all --group grupoDesconecta uno o más perfiles VPN (o un grupo con --group)
kongtrol status [opciones] --dashboard -w, --watchMuestra el estado de todos los túneles VPN
kongtrol routes [perfil] [opciones]Muestra qué sale por cada túnel
kongtrol routes list [opciones]Lista las rutas del sistema que agregó Kongtrol
kongtrol map [destino|app:<exe>] [opciones]Muestra qué VPN usa cada destino
kongtrol dashboard [opciones]Abre el dashboard web en tu navegador
ConfiguraciónQué hace
kongtrol init [opciones]Asistente para crear o actualizar tu configuración
kongtrol config [comando]Valida la configuración y ajusta este equipo
kongtrol config validate [opciones]Valida kongtrol.yaml sin conectar
kongtrol config favorites [comando]Gestiona tus perfiles favoritos
kongtrol config favorites list [opciones]Lista tus perfiles favoritos
kongtrol config favorites add <perfil> [opciones]Agrega un perfil a favoritos
kongtrol config favorites remove <perfil> [opciones]Quita un perfil de favoritos
kongtrol config defaults [comando]Define qué conecta kongtrol up sin argumentos
kongtrol config defaults show [opciones]Muestra el grupo por defecto
kongtrol config defaults set-group <grupo> [opciones]Define el grupo que conecta kongtrol up
kongtrol config lang <es|en> [opciones]Cambia el idioma de Kongtrol en la terminal
kongtrol config dashboard [comando]Ajusta la dirección y el puerto locales del dashboard
kongtrol config dashboard show [opciones]Muestra la dirección y el puerto del dashboard
kongtrol config dashboard set-port <puerto> [opciones]Cambia el puerto local del dashboard (aplica al reiniciar)
kongtrol config dashboard set-bind <dirección> [opciones]Cambia la dirección local del dashboard (aplica al reiniciar)
kongtrol config dashboard reset [opciones]Quita el ajuste local y vuelve a kongtrol.yaml
kongtrol config public-ip <on|off> [opciones]Activa o desactiva la consulta de tu IP pública
kongtrol policy [comando]Revisa y prueba tus políticas de tráfico
kongtrol policy explain <destino|app:<exe>> [opciones]Explica qué política coincide y por qué
kongtrol policy test <archivo> [opciones]Prueba tus políticas con una lista de destinos
kongtrol reload [opciones] --group grupo --policy --tunnel perfilAplica los cambios de kongtrol.yaml sin desconectar
kongtrol restart [opciones]Reinicia Kongtrol para usar perfiles VPN nuevos o editados
kongtrol export [opciones]Imprime tu configuración sin secretos para compartirla
DiagnósticoQué hace
kongtrol doctor [opciones] --fixRevisa tu equipo: programas, certificados, llavero y permisos
kongtrol check [opciones]Consulta ahora tu IP pública y si hay fugas
kongtrol logs [opciones] --daemon -f, --follow --level nivel --profile perfil --tail NMuestra los eventos de Kongtrol
SistemaQué hace
kongtrol service [comando]Instala o revisa el ayudante de Kongtrol (sin terminal de administrador)
kongtrol service install [opciones]Instala el ayudante una sola vez (pide permiso de administrador)
kongtrol service uninstall [opciones]Quita el ayudante de este equipo
kongtrol service status [opciones]Muestra si el ayudante está instalado y responde
kongtrol version [opciones]Muestra la versión de Kongtrol
kongtrol help [comando] [opciones]Muestra la ayuda de un comando
Opciones globalesQué hace
--alert-bellemite un beep en alertas críticas
-c, --config rutaruta del archivo de configuración (por defecto: ~/.kongtrol/kongtrol.yaml)
-h, --helpmuestra la ayuda de kongtrol
--jsonemite salida JSON para automatización
--plainsalida plana ASCII (sin color ni símbolos Unicode)
-q, --quietreduce la salida no esencial (sin banner ni spinner)
10

Solución de problemas

DNS no restaurado después de un crash:

bash
$ sudo cp /etc/resolv.conf.kongtrol.bak /etc/resolv.conf

Kill switch activo sin internet después de desconectar:

bash
$ kongtrol down --all    # desactiva kill switch automáticamente

Si Kongtrol se cerró de golpe: con el ayudante instalado, sus bloqueos se quitan solos en unos 20 segundos (la red queda abierta, nunca cortada). Si siguen ahí, quita solo las reglas de Kongtrol. No uses netsh advfirewall reset: borra todas tus reglas de firewall.

bash
$ sudo iptables -F OUTPUT

El cliente VPN no aparece en la detección automática:

bash
# El wizard pregunta la ruta al binario si no lo detecta:
$ kongtrol init
#   !  Este cliente VPN no fue detectado automáticamente.
#   Ruta al binario (vacío = autodetectar): /ruta/al/binario

# O agrégalo manualmente en ~/.kongtrol/kongtrol.yaml:
# office:
#   type: forticlient
#   app_path: "/ruta/personalizada/FortiClient"

Cloudflare WARP — "not registered":

bash
$ warp-cli register

Contraseña incorrecta / expirada:

bash
$ kongtrol init
# Selecciona el perfil → "Refresh credentials" → ingresa la nueva
Si detecta fallo de sesión/token/credenciales durante connect/reconnect, Kongtrol emite alerta de reauth requerida con hint específico por adapter.

Estructura de archivos:

text
~/.kongtrol/
├── kongtrol.yaml     ← config principal (sin contraseñas)
├── certs/
│   ├── office.crt
│   └── office.key
├── configs/
│   ├── server.ovpn
│   └── aws.ovpn
└── audit.log         ← log firmado de todos los eventos

Contraseñas guardadas en:
  Windows → Windows Credential Manager
  macOS   → Keychain
  Linux   → libsecret / GNOME Keyring