Cómo configurar un bot de Telegram para VLESS en tu VPS

Un bot de Telegram para emitir claves VLESS en tu propio VPS automatiza la gestión del acceso VPN, permitiendo distribuir más de 100 configuraciones a familiares o un equipo pequeño sin configuración manual de cada clave, ahorrando hasta 3-5 horas semanales en administración y reduciendo significativamente la probabilidad de errores en la generación y transmisión manual de datos.

Ser propietario de tu propio servidor VPN en un VPS abre amplias posibilidades para garantizar la privacidad y eludir bloqueos. Sin embargo, cuando se trata de proporcionar acceso no solo para ti, sino también para varios amigos, familiares o colegas, la gestión manual de cada clave VLESS, los límites de tráfico y las fechas de vencimiento se convierte en una rutina. Aquí es donde un bot de Telegram para emitir claves VPN viene al rescate. Transforma un proceso complejo en un par de clics, simplificando significativamente la administración de tu servidor y haciéndolo accesible incluso para aquellos sin profundos conocimientos técnicos.

¿Por qué implementar un bot de Telegram para claves VPN en tu VPS?

La razón principal para usar un bot para gestionar claves VPN es la automatización y la escalabilidad. Imagina que necesitas proporcionar acceso VPN a decenas de usuarios. La generación manual de claves VLESS, la configuración de límites de tráfico o tiempo, y luego el envío individual de cada configuración consume una cantidad colosal de tiempo. Además, aumenta el riesgo de errores e inconsistencias. La emisión automática de configuraciones a través de un bot de Telegram resuelve estos problemas, permitiéndote concentrarte en tareas más importantes en lugar de la administración rutinaria.

Ahorro de tiempo y reducción de la carga administrativa

Sin un bot, cada solicitud de una nueva clave, una extensión de acceso o un cambio de límite requiere que el administrador inicie sesión manualmente en el servidor, trabaje con el panel de control (por ejemplo, Marzban o 3x-ui), genere la clave y la envíe al usuario. En promedio, un ciclo de este tipo lleva de 5 a 15 minutos, dependiendo de la complejidad de la tarea y la experiencia del administrador. Con 20-30 usuarios activos y solicitudes periódicas, esto puede consumir varias horas a la semana. El bot, en cambio, realiza estas operaciones al instante, 24/7, sin intervención humana. Esto es especialmente relevante para quienes ofrecen acceso VPN como servicio o para un equipo grande donde se requiere una gestión de acceso operativa.

Comodidad para los usuarios y gestión centralizada

Para los usuarios finales, obtener una clave VLESS a través de un bot de Telegram es un proceso lo más simple e intuitivo posible. Basta con enviar un comando al bot y, en unos segundos, recibirán la configuración lista o un enlace a ella. No es necesario contactar al administrador, esperar una respuesta o descifrar instrucciones complicadas. Todas las claves, sus estados, límites y fechas de vencimiento se almacenan en una base de datos unificada del bot, lo que garantiza una gestión centralizada. El administrador puede, en cualquier momento, ver la lista de usuarios activos, su consumo de tráfico, la fecha de vencimiento de la suscripción, así como realizar renovaciones, bloqueos o revocaciones de claves.

Para aquellos que recién comienzan su camino en el mundo de la VPN autogestionada, recomendamos consultar nuestra guía completa sobre VPN en tu propio VPS, que te ayudará a establecer una base sólida.

¿Cómo funcionan los bots para la emisión automática de configuraciones VLESS?

El principio de funcionamiento de un bot de Telegram para claves VPN se basa en la interacción con la API del panel de control del servidor VPN. La mayoría de los paneles modernos, como Marzban o 3x-ui, proporcionan una API a través de la cual se pueden gestionar usuarios, generar claves, establecer límites y obtener estadísticas de forma programática. El bot actúa como intermediario: recibe comandos del usuario en Telegram, los convierte en solicitudes a la API del panel de control VPN, obtiene una respuesta y la formatea para enviarla de vuelta al usuario.

Arquitectura de interacción: API de Telegram y API del panel VPN

Una arquitectura típica incluye varios componentes clave:

1. Telegram Bot API: El bot se registra en Telegram a través de BotFather y obtiene un token único. A través de esta API, el bot recibe mensajes de los usuarios y les envía respuestas.
2. Servidor donde se ejecuta el bot: Este es tu VPS, donde está instalado el intérprete de Python (u otro lenguaje de programación), las librerías para trabajar con la API de Telegram y la API del panel VPN, así como el propio código del bot.
3. Panel de control VPN: Por ejemplo, Marzban o 3x-ui, instalado en el mismo o en otro VPS. Gestiona el servidor Xray y proporciona una API HTTP para la interacción.
4. Base de datos del bot: Generalmente SQLite, PostgreSQL o MongoDB, donde se almacena información sobre los usuarios de Telegram, las claves VLESS asociadas a ellos, sus estados, fechas de vencimiento, límites y otras configuraciones. Esto permite que el bot "recuerde" el estado y gestione las suscripciones.

Cuando un usuario envía un comando, por ejemplo, /get_key, el bot lo procesa, se comunica con el panel VPN a través de la API (por ejemplo, POST /api/user para crear un nuevo usuario), obtiene la configuración VLESS, guarda la información sobre ella en su base de datos y envía la configuración al usuario en Telegram.

Ciclo de vida de una clave VLESS gestionada por un bot

• Solicitud: El usuario envía un comando al bot (por ejemplo, /start, /get_trial).
• Generación: El bot, después de verificar permisos o pago, se comunica con la API del panel VPN para crear un nuevo usuario con los parámetros especificados (protocolo VLESS, límites, fecha de vencimiento).
• Emisión: El bot envía la clave VLESS obtenida o el enlace de suscripción al usuario en Telegram. La información sobre la clave emitida (ID de usuario de Telegram, ID de clave en el panel, fecha de emisión, fecha de vencimiento, tráfico) se guarda en la base de datos del bot.
• Monitoreo: El bot puede solicitar periódicamente al panel VPN estadísticas de tráfico para cada clave o verificar el tiempo restante de vencimiento.
• Renovación: El usuario envía un comando para renovar. El bot actualiza la fecha de vencimiento o los límites a través de la API del panel VPN y actualiza su base de datos.
• Revocación/Bloqueo: El administrador o el usuario (si esta función está prevista) puede revocar o bloquear una clave. El bot envía una solicitud a la API del panel VPN para eliminar o desactivar al usuario y actualiza su base de datos.

Soluciones populares: bots para Marzban y 3x-ui

Existen varias soluciones y frameworks listos para crear un bot de gestión de servidores VPN. Entre ellos, destacan los proyectos enfocados en los populares paneles Marzban y 3x-ui, que se han convertido en estándares de facto para implementar VPN multiusuario basadas en Xray/VLESS. Estos paneles ofrecen una interfaz web conveniente y una potente API, lo que los convierte en una base ideal para la automatización.

Bot para Marzban: capacidades de gestión avanzadas

Marzban es un potente panel de control para Xray que ofrece una amplia gama de funciones para crear y gestionar proxies VLESS, VMess, Trojan y Shadowsocks. Cuenta con una API bien documentada, lo que facilita la integración con bots de Telegram. Existen varios proyectos de código abierto que ofrecen soluciones listas o plantillas para crear un bot para Marzban. Estos bots suelen soportar:

• Generación automática de claves VLESS con parámetros definidos (velocidad, tráfico, fecha de vencimiento).
• Gestión de usuarios: creación, modificación, eliminación, bloqueo.
• Emisión de acceso de prueba con un tiempo o tráfico limitado.
• Renovación de suscripciones y cambio de límites.
• Obtención de estadísticas de uso de tráfico para cada usuario.
• Soporte para múltiples protocolos y puertos.
• Integración con sistemas de pago para la emisión automática de suscripciones VPN.

Ejemplo de solicitud a la API de Marzban para crear un usuario:

POST /api/user
Authorization: Bearer YOUR_MARZBAN_API_TOKEN
Content-Type: application/json

{
    "username": "user_telegram_id",
    "data_limit": 10737418240, // 10 GB in bytes
    "expire": 1678886400, // Unix timestamp for expiration
    "inbounds": {
        "vless": {
            "flow": "xtls-rprx-vision"
        }
    }
}

Puedes obtener más información sobre el panel en el artículo Marzban en VPS: instalación del panel Xray y multiusuario.

Bot para 3x-ui: simplicidad y funcionalidad

3x-ui es otro panel de control popular para Xray, conocido por su facilidad de instalación y uso. También proporciona una API, aunque menos extensa que la de Marzban, pero suficiente para operaciones básicas de gestión de claves VLESS. Los bots para 3x-ui suelen centrarse en las siguientes funciones:

• Generación de claves VLESS.
• Configuración y modificación de límites de tráfico.
• Configuración y modificación de fechas de vencimiento.
• Obtención de la lista de usuarios y sus estados.
• Eliminación de usuarios.

Gracias a su ligereza y simplicidad, 3x-ui se elige a menudo para proyectos pequeños o uso individual donde no se requiere un sistema de facturación complejo. Un bot para 3x-ui puede implementarse con una cantidad mínima de código, lo que lo convierte en una excelente opción para quienes desean lanzar rápidamente un sistema de emisión automática. La gestión de límites de tráfico y cuotas para usuarios en 3x-ui y Marzban es un aspecto importante, sobre el cual puedes leer aquí: Límites y cuotas para usuarios en 3x-ui y Marzban.

Cómo instalar y configurar un bot de Telegram para claves VPN en tu VPS

El despliegue de un bot de Telegram para claves VPN en tu propio VPS es un paso clave hacia la automatización completa de la gestión de acceso VPN. El proceso incluye varias etapas: preparación del VPS, instalación de las dependencias necesarias, despliegue del código del bot y su lanzamiento. A modo de ejemplo, consideraremos una instalación típica de un bot en Python que interactúa con la API de Marzban.

Preparación del VPS e instalación de dependencias

Antes de desplegar el bot, asegúrate de que tu VPS cumple con los requisitos mínimos (generalmente 1 vCPU, 512 MB de RAM, 10 GB de disco para el bot, sin contar el servidor VPN). El VPS debe tener instalado un sistema operativo basado en Linux (por ejemplo, Ubuntu 20.04+ o Debian 11+). Necesitarás Python 3.8+ y pip.

# Обновление системы
sudo apt update && sudo apt upgrade -y

# Установка Python3 и pip
sudo apt install python3 python3-pip -y

# Создание виртуального окружения (рекомендуется)
mkdir ~/vpn_bot && cd ~/vpn_bot
python3 -m venv venv
source venv/bin/activate

# Установка библиотек для бота (примерно)
pip install python-telegram-bot requests SQLAlchemy

También es necesario obtener el API-token de tu bot de Telegram a través de BotFather y el API-token de tu panel Marzban/3x-ui (generalmente se genera en la configuración del panel).

Configuración y lanzamiento del bot

Después de instalar las dependencias, deberás configurar el bot. Esto se suele hacer a través de un archivo de configuración (por ejemplo, config.ini o config.py), donde se especifican los siguientes parámetros:

• TELEGRAM_BOT_TOKEN: El token obtenido de BotFather.
• MARZBAN_API_URL o 3XUI_API_URL: La dirección de tu API del panel (por ejemplo, https://your_marzban_ip:8000/api).
• MARZBAN_API_TOKEN o 3XUI_API_TOKEN: El API-token para la autorización en el panel.
• ADMIN_TELEGRAM_ID: Tu ID de Telegram para recibir notificaciones y administrar el bot.
• Configuración de la base de datos (por ejemplo, la ruta al archivo SQLite).

Ejemplo de archivo config.py:

# config.py
TELEGRAM_BOT_TOKEN = "YOUR_TELEGRAM_BOT_TOKEN"
MARZBAN_API_URL = "https://your_marzban_domain_or_ip:8000/api"
MARZBAN_API_TOKEN = "YOUR_MARZBAN_JWT_TOKEN"
ADMIN_TELEGRAM_ID = [123456789, 987654321] # Список ID администраторов
DATABASE_URL = "sqlite:///bot_database.db"

Después de guardar la configuración, puedes iniciar el bot. Para un funcionamiento estable, se recomienda usar systemd para el inicio y reinicio automático del bot.

# Пример systemd service файла: /etc/systemd/system/vpn_bot.service
[Unit]
Description=Telegram VPN Bot
After=network.target

[Service]
User=your_user
WorkingDirectory=/home/your_user/vpn_bot
ExecStart=/home/your_user/vpn_bot/venv/bin/python /home/your_user/vpn_bot/main.py
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

# Активация и запуск сервиса
sudo systemctl daemon-reload
sudo systemctl enable vpn_bot
sudo systemctl start vpn_bot
sudo systemctl status vpn_bot

Funcionalidades del bot: desde acceso de prueba hasta revocación de claves

Un bot de Telegram para claves VPN moderno posee una rica funcionalidad que permite automatizar completamente el proceso de gestión de acceso VPN. No se trata solo de emitir claves, sino de un espectro completo de posibilidades para un control flexible sobre las suscripciones.

Gestión de suscripciones: acceso de prueba, renovación, límites

Una de las funciones más demandadas es la posibilidad de ofrecer acceso de prueba. Esto permite a los nuevos usuarios probar el servicio VPN antes de una suscripción completa. El bot puede emitir automáticamente claves VLESS con un período de validez limitado (por ejemplo, 3 días) o un límite de tráfico (por ejemplo, 1 GB). Una vez finalizado el período de prueba, el bot puede notificar al usuario y ofrecerle adquirir una suscripción completa.

• Emisión de acceso de prueba: El comando /trial genera una clave por 1-3 días con un límite de 1-5 GB.
• Renovación de suscripción: Los usuarios pueden renovar su acceso seleccionando un plan de tarifas a través del bot. El bot actualiza la fecha de vencimiento y los límites de tráfico para la clave correspondiente a través de la API del panel.
• Configuración de límites de tráfico: Para cada usuario se pueden establecer límites de tráfico individuales (por ejemplo, 50 GB/mes) y de velocidad. El bot monitoreará el consumo y, al alcanzar el límite, bloqueará automáticamente el acceso o reducirá la velocidad.
• Configuración de límites de tiempo: Además del tráfico, se puede establecer un período de validez para la suscripción (por ejemplo, 30 días). El bot desactiva automáticamente la clave al finalizar el período.

Esta flexibilidad permite al administrador crear diversos planes de tarifas y gestionar eficazmente los recursos del servidor.

Revocación de claves y gestión de sesiones activas

La capacidad de revocar una clave o bloquear el acceso de un usuario es extremadamente importante para la seguridad y el control. El bot debe proporcionar al administrador una interfaz conveniente para realizar estas operaciones:

• Revocación de clave: El administrador puede enviar un comando al bot (por ejemplo, /revoke user_id) para desactivar inmediatamente la clave VLESS de un usuario. Esto es útil si el usuario incumple las reglas de uso o si la suscripción ha sido cancelada.
• Bloqueo/desbloqueo: Bloqueo temporal del acceso sin eliminar completamente la clave. Por ejemplo, si un usuario ha excedido el límite, se le puede bloquear temporalmente hasta que renueve su suscripción.
• Visualización de sesiones activas: Algunos bots pueden mostrar información sobre las conexiones activas al servidor VPN para cada clave, permitiendo al administrador ver quién está utilizando la VPN en ese momento.

Además, el bot puede configurarse para notificar automáticamente a los usuarios sobre la próxima finalización de su suscripción o el agotamiento del tráfico, lo que mejora significativamente la experiencia del usuario y reduce la cantidad de preguntas al administrador.

Para una comprensión más profunda de cómo automatizar la emisión y gestión de claves, puede ser útil el artículo sobre tu propia suscripción para VLESS en un VPS, que aborda cuestiones de actualización automática de configuraciones.

Recursos óptimos para un bot de gestión de servidores VPN

Una de las ventajas significativas de ejecutar un bot de gestión de servidores VPN es su bajo consumo de recursos. En la mayoría de los casos, el bot puede coexistir tranquilamente en el mismo VPS que el propio servidor VPN, sin afectar notablemente su rendimiento. Esto permite optimizar los costos de hosting, utilizando un solo servidor para varias tareas.

¿Por qué el bot puede coexistir en el mismo servidor que el VPN?

Los bots de Telegram, especialmente los escritos en Python, son aplicaciones ligeras. La mayor parte del tiempo están en modo de espera, consumiendo recursos mínimos de CPU y RAM. La actividad del bot se manifiesta solo al procesar solicitudes de los usuarios o al realizar tareas periódicas (por ejemplo, verificar suscripciones que expiran). Estas operaciones suelen tardar fracciones de segundo y no crean una carga significativa. El propio servidor VPN (Xray) es un componente mucho más intensivo en recursos, consumiendo CPU y tráfico de red según el número de usuarios activos y su actividad.

Las principales razones del bajo consumo de recursos por parte del bot:

• Arquitectura orientada a eventos: El bot se activa solo al recibir un mensaje o por un temporizador.
• Operaciones de disco mínimas: La base de datos del bot (a menudo SQLite) es pequeña y se actualiza con poca frecuencia.
• Baja carga de CPU: El procesamiento de comandos y solicitudes a las API de los paneles no requiere cálculos intensivos.
• Consumo insignificante de RAM: Para la mayoría de los bots, 50-100 MB de memoria RAM son suficientes.

Tabla: Recomendaciones de VPS para un servidor VPN con bot

Para 50 usuarios simultáneos, son suficientes 4 vCPU, 8 GB de RAM y un disco NVMe de 80 GB.

Como se desprende de la tabla, incluso para un número significativo de usuarios de VPN, los requisitos de VPS siguen siendo bastante moderados. El bot, que funciona con Python, ocupará solo una pequeña parte de estos recursos, lo que hace que su alojamiento conjunto con el servidor VPN sea una solución económicamente ventajosa. Es importante elegir un VPS con un disco rápido (NVMe) y suficiente memoria RAM para un funcionamiento cómodo de la VPN y el panel de control.

Seguridad y almacenamiento de datos: copia de seguridad de la base de datos del bot

La seguridad de los datos y la fiabilidad de un bot de Telegram para emitir claves VPN son aspectos de importancia crítica. Un almacenamiento incorrecto de información confidencial o la falta de copias de seguridad pueden provocar fugas de datos de los usuarios, pérdida de información sobre suscripciones o la inoperatividad total del servicio.

Protección de tokens API y datos confidenciales

Los datos más sensibles son el API-token del bot de Telegram y el API-token del panel de control VPN (Marzban/3x-ui). Estos tokens otorgan control total sobre el bot y el servidor VPN, respectivamente. Sigue estas recomendaciones:

1. No almacenes los tokens en acceso público: Nunca subas los tokens a repositorios Git públicos. Utiliza variables de entorno o archivos de configuración protegidos (por ejemplo, un archivo .env que sea ignorado por Git).
2. Restringe el acceso a los archivos de configuración: Asegúrate de que solo el usuario bajo el cual se ejecuta el bot tenga permisos de lectura para el archivo de configuración.
3. Usa HTTPS para la API del panel: Si el panel de control VPN es accesible por HTTP, configura Nginx u otro proxy inverso para que funcione con HTTPS, a fin de proteger la transmisión de datos entre el bot y el panel.
4. Configura un firewall: Restringe el acceso a los puertos de la API del panel de control VPN solo desde la dirección IP de tu VPS donde se ejecuta el bot.
5. Actualiza regularmente las dependencias: La actualización oportuna de Python, las librerías y el propio código del bot ayudará a cerrar vulnerabilidades conocidas.

Almacenamiento de estado y copia de seguridad de la base de datos del bot

El bot almacena información importante sobre los usuarios, sus suscripciones, fechas de vencimiento y tráfico utilizado en su base de datos. La pérdida de esta base de datos significa la pérdida de todos los datos de suscripción y la necesidad de restaurar todo manualmente. Por lo tanto, la copia de seguridad regular de la base de datos del bot es obligatoria.

Si el bot utiliza SQLite (la opción más común para proyectos pequeños), la base de datos se almacena en un solo archivo (por ejemplo, bot_database.db). Para la copia de seguridad, basta con copiar este archivo a un lugar seguro.

# Ejemplo скрипта para бэкапа SQLite базы данных
#!/bin/bash
DB_PATH="/home/your_user/vpn_bot/bot_database.db"
BACKUP_DIR="/home/your_user/backups/vpn_bot_db"
TIMESTAMP=$(date +"%Y%m%d_%H%M%S")
BACKUP_FILE="${BACKUP_DIR}/bot_database_${TIMESTAMP}.db"

mkdir -p $BACKUP_DIR
cp $DB_PATH $BACKUP_FILE

# Удаление старых бэкапов (оставить 7 последних)
find $BACKUP_DIR -name "bot_database_*.db" -mtime +7 -delete

echo "Backup created: $BACKUP_FILE"

Este script puede configurarse para ejecutarse según un horario a través de cron (por ejemplo, diariamente a las 3 de la mañana).

# Добавление задачи в crontab
crontab -e
# Добавить строку:
0 3 * * * /bin/bash /home/your_user/vpn_bot/backup_script.sh >> /var/log/vpn_bot_backup.log 2>&1

Para un almacenamiento más fiable, se recomienda utilizar almacenamientos remotos (servicios compatibles con S3, Google Drive, Dropbox) u otros VPS para guardar las copias de seguridad. Puedes obtener más información sobre las copias de seguridad en el artículo Copia de seguridad automática de configuraciones VPN desde un VPS.

Preguntas frecuentes

Aquí hemos recopilado las respuestas a las preguntas más frecuentes sobre el uso de un bot de Telegram para emitir claves VLESS.

¿Se puede usar un solo bot para múltiples servidores VPN?

Sí, es totalmente posible. Si el bot está diseñado con soporte para arquitectura multiservidor, puede gestionar múltiples paneles Marzban o 3x-ui, ubicados en diferentes VPS. Esto es conveniente para equilibrar la carga o proporcionar acceso a servidores VPN en diferentes ubicaciones geográficas. Generalmente, esto requiere configuraciones adicionales en el bot, donde se especifican los API-tokens y las direcciones de todos los paneles gestionados. Algunos proyectos permiten vincular al usuario a un servidor específico o seleccionar automáticamente el menos cargado.

¿Qué lenguajes de programación se utilizan para crear estos bots?

El lenguaje más popular para el desarrollo de bots de Telegram es Python, gracias a su simplicidad, sus amplias librerías (como python-telegram-bot y requests) y su gran comunidad. Sin embargo, los bots pueden escribirse en otros lenguajes, incluyendo Node.js (con librerías como node-telegram-bot-api), Go, PHP o Ruby. La elección del lenguaje a menudo depende de las preferencias del desarrollador y de las especificidades de los paneles VPN utilizados, así como de la disponibilidad de SDKs listos para su API.

¿Se necesita una dirección IP dedicada para el funcionamiento del bot?

Para el funcionamiento del bot de Telegram en sí, no se requiere una dirección IP dedicada. El bot interactúa con la API de Telegram a través de conexiones HTTPS salientes, y con el panel VPN, también a través de conexiones salientes o por IP interna, si se encuentran en el mismo VPS. Sin embargo, para el funcionamiento del servidor VPN (Marzban, 3x-ui, Xray), una dirección IP pública dedicada en tu VPS es un requisito obligatorio para garantizar la disponibilidad del servicio VPN desde internet. Sin una IP pública, los usuarios no podrán conectarse a tu VPN.

¿Cuánto cuesta un VPS para ejecutar VPN y el bot?

El costo de un VPS para ejecutar un servidor VPN y el bot puede variar de $5 a $80+ al mes, dependiendo del número de usuarios y los recursos requeridos. Para un número pequeño de usuarios (hasta 10-15 personas), un VPS con 1-2 vCPU, 1-2 GB de RAM y un disco NVMe de 20-40 GB es suficiente, con un costo aproximado de $5-10/mes. Para 50-100 usuarios, se necesitará un servidor más potente con 4-6 vCPU, 8-16 GB de RAM y un disco NVMe de 80+ GB, cuyo costo puede oscilar entre $40-80/mes. El bot, por su parte, prácticamente no aumenta el costo total, ya que sus requisitos son mínimos.

Conclusiones

El uso de un bot de Telegram para emitir claves VLESS en tu propio VPS no es solo una comodidad, sino una herramienta eficaz para la automatización y escalabilidad de la gestión de acceso VPN. Reduce significativamente el tiempo de administración, simplifica el proceso para los usuarios finales y proporciona un control centralizado sobre las suscripciones. Recomendamos implementar esta solución, especialmente si gestionas el acceso para más de 5-10 usuarios, para optimizar los recursos y aumentar la eficiencia general de tu servicio VPN.