📘 Manual de Usuario

VicVPN - Red Privada Virtual Empresarial

📑 Tabla de Contenidos

1. Introducción

¿Qué es VicVPN?

VicVPN es una solución de Red Privada Virtual (VPN) que permite conectar múltiples dispositivos de forma segura a través de Internet, como si estuvieran en la misma red local.

Casos de Uso

Componentes del Sistema

2. Instalación

2.1 Requisitos del Sistema

Cliente Windows:

Servidor:

2.2 Instalación del Cliente

  1. Descarga VicVPN_Clean.exe
  2. Ejecuta como administrador (clic derecho → "Ejecutar como administrador")
  3. La primera vez instalará WireGuard automáticamente
  4. Acepta la instalación de WireGuard cuando aparezca el diálogo
⚠️ Importante: Debes ejecutar como administrador para que WireGuard funcione correctamente.

2.3 Instalación del Servidor

# Instalar dependencias
sudo apt update
sudo apt install -y python3 python3-pip wireguard iptables

# Descargar VicVPN
cd /opt
sudo git clone https://github.com/tu-usuario/vicvpn.git
cd vicvpn

# Configurar permisos
sudo chmod +x vpn_server_v6.py

# Iniciar servidor
sudo python3 vpn_server_v6.py
💡 Tip: Usa nohup python3 vpn_server_v6.py & para que el servidor siga corriendo después de cerrar SSH.

3. Primer Uso

3.1 Crear tu Primera Red VPN

Hay dos formas de crear una red VPN:

Opción A: Desde el Dashboard (Recomendado)

  1. Abre el navegador y ve a https://tu-servidor.com:8090
  2. Inicia sesión (usuario: admin, contraseña: VicVPN2024)
  3. Haz clic en el botón "➕ Crear VPN"
  4. Ingresa un nombre descriptivo (ej: "Oficina México")
  5. Opcionalmente establece una contraseña
  6. Anota el código de 6 dígitos generado

Opción B: Desde el Cliente (Deprecado)

Las versiones antiguas permitían crear desde el cliente. Ahora solo se puede unir.

3.2 Unirse a una Red VPN

  1. Abre VicVPN_Clean.exe
  2. Haz clic en el botón "🔗" (Unirse a red)
  3. Ingresa:
    • Nombre: Nombre de tu dispositivo (ej: "Laptop María")
    • Código: El código de 6 dígitos de la red
    • Contraseña: Si la red está protegida
  4. Haz clic en "Unirse a Red VPN"
  5. Espera a que aparezca "VPN ACTIVA" en la barra inferior
💡 Tip: Tu IP VPN será del formato 10.XXX.0.Y donde XXX es único por red.

4. Dashboard Web

4.1 Acceso al Dashboard

URL: https://tu-servidor.com:8090

Credenciales por defecto:

⚠️ Advertencia: Cambia la contraseña por defecto editando las constantes ADMIN_USER y ADMIN_PASS en el archivo del servidor.

4.2 Funciones del Dashboard

Estadísticas Generales

Gestión de Redes VPN

Gestión de Clientes

4.3 Proteger Redes con Contraseña

  1. Al crear una red, ingresa una contraseña cuando se solicite
  2. Para cambiar la contraseña de una red existente:
    • Haz clic en el botón "✏️" en la columna Contraseña
    • Ingresa la nueva contraseña
    • Deja vacío para quitar la protección

5. Cliente Windows

5.1 Interfaz del Cliente

Barra Superior

Lista de Dispositivos

Muestra todos los dispositivos conectados a tu red con:

Barra de Estado

Muestra el estado actual:

5.2 Operaciones Comunes

Pausar la VPN

  1. Haz clic en el botón "⏸"
  2. El túnel VPN se desactiva pero sigues en la red
  3. Útil para acceder a recursos locales temporalmente

Reanudar la VPN

  1. Haz clic nuevamente en "⏸" (ahora mostrará ▶)
  2. El túnel se reactiva automáticamente

Desconectar

  1. Haz clic en el botón "⏻"
  2. Confirma la desconexión
  3. El túnel y la conexión al servidor se cierran

5.3 Opciones Avanzadas

Inicio Automático

El cliente puede configurarse para iniciar con Windows y reconectar automáticamente:

  1. Haz clic derecho en el ícono de la bandeja del sistema
  2. Selecciona "Iniciar con Windows"

Minimizar a Bandeja

Al cerrar la ventana con VPN activa, el cliente se minimiza a la bandeja del sistema en lugar de cerrarse.

6. Compartir Archivos

6.1 Servidor de Archivos Integrado

VicVPN incluye un servidor HTTP simple para compartir archivos entre dispositivos de la red.

Activar el Servidor

El servidor se inicia automáticamente en el puerto 8000 cuando estás conectado a una red VPN.

Acceder a Archivos de Otros Dispositivos

  1. En la lista de dispositivos, localiza el dispositivo objetivo
  2. Haz clic derecho sobre él
  3. Selecciona "Abrir carpeta compartida"
  4. Se abrirá tu navegador en http://IP_VPN:8000

Compartir tus Archivos

Los archivos en la carpeta %APPDATA%\VicVPN\shared\ son accesibles para otros dispositivos.

💡 Tip: Crea accesos directos a esta carpeta para facilitar el acceso.

7. Seguridad

7.1 Cifrado

VicVPN utiliza WireGuard, que implementa:

7.2 Autenticación

7.3 Mejores Prácticas

8. Solución de Problemas

8.1 No se puede conectar al servidor

Síntomas:

"✗ No se pudo conectar al servidor"

Soluciones:

8.2 WireGuard no inicia

Síntomas:

"WireGuard: Admin requerido" o "WireGuard: Error"

Soluciones:

  1. Cierra completamente VicVPN
  2. Ejecuta como administrador
  3. Si persiste, instala WireGuard manualmente desde https://www.wireguard.com/install/
  4. Verifica que el servicio de WireGuard no esté marcado para eliminación: 
    sc query WireGuardTunnel$vicvpn

8.3 Código de red no encontrado

Síntomas:

"❌ Código de red no encontrado"

Soluciones:

8.4 Contraseña incorrecta

Síntomas:

"❌ Contraseña incorrecta"

Soluciones:

8.5 No puedo acceder a otros dispositivos

Síntomas:

No puedes hacer ping ni conectarte a otros dispositivos de la VPN

Soluciones:

  1. Verifica que ambos dispositivos muestren "VPN ACTIVA"
  2. Verifica las IPs VPN asignadas
  3. Prueba hacer ping: ping 10.XXX.0.Y
  4. Verifica que el firewall de Windows permita tráfico en la interfaz WireGuard
  5. Si el otro dispositivo muestra 🔴 Offline, espera a que se reconecte

8.6 Dashboard muestra 502 Bad Gateway

Síntomas:

Nginx devuelve error 502

Soluciones:

  1. Verifica que el servidor Python esté corriendo: 
    ps aux | grep vpn_server
  2. Reinicia el servidor: 
    pkill -9 python3
cd /opt/vicVPN
nohup python3 vpn_server_v6.py > vpn.log 2>&1 &
  3. Revisa los logs: 
    tail -50 /opt/vicVPN/vpn.log
  4. Reinicia nginx: 
    systemctl restart nginx

9. Preguntas Frecuentes

¿Cuántos dispositivos puedo conectar?

No hay límite. Puedes conectar tantos dispositivos como necesites a una red VPN.

¿Puedo tener múltiples redes VPN?

Sí, puedes crear tantas redes como necesites. Cada una tendrá su propio código y subred.

¿Se pueden conectar dispositivos de diferentes redes?

No, cada red VPN está aislada. Los dispositivos solo pueden comunicarse dentro de su propia red.

¿Qué pasa si cierro el cliente con VPN activa?

El cliente se minimiza a la bandeja del sistema y la VPN sigue activa en segundo plano.

¿Se registra mi tráfico de Internet?

No. VicVPN NO registra tráfico, solo datos de conexión (IP, fecha/hora) con fines técnicos.

¿Funciona en Linux/Mac?

Actualmente solo cliente Windows. El servidor funciona en Linux. Clientes para otros sistemas operativos están en desarrollo.

¿Es gratis?

Sí, la versión Community es completamente gratuita y de código abierto. Solo pagas si contratas hosting administrado.

¿Necesito IP pública?

Solo el servidor necesita IP pública. Los clientes pueden estar detrás de NAT/CGNAT.

¿Afecta la velocidad de mi Internet?

WireGuard es muy eficiente. El impacto en velocidad es mínimo (típicamente <5%).

¿Puedo usar VicVPN para Netflix/streaming?

VicVPN no es un servicio de VPN comercial para streaming. Está diseñado para redes privadas entre dispositivos conocidos.

💡 ¿No encuentras tu respuesta? Contacta a soporte en contacto@sicaja.com
← Volver al inicio