xrayvpn
Herramienta Python+Ansible para desplegar servidores VPN VLESS Xray Reality en VPS Ubuntu/Debian sin dominio propio. Automatiza configuración y genera clientes (Clash Verge, FlClash). Soporta Cloudflare WARP opcional.
Ficha actualizada 22 sept 2026, 15:37 · upstream 22 sept 2026, 11:53 · release v0.4.1
Qué es xrayvpn
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
XrayVPN es una solución de automatización para desplegar servidores VPN personales utilizando el protocolo VLESS con Xray Reality. El proyecto se basa en Ansible para gestionar la infraestructura del servidor objetivo, permitiendo un despliegue idempotente y declarativo que evita configuraciones manuales repetitivas.
La herramienta está diseñada para funcionar sin necesidad de comprar un dominio ni gestionar certificados TLS, ya que utiliza el mecanismo de camuflaje de Reality para parecerse a sitios legítimos (como dl.google.com por defecto). Esto reduce la complejidad operativa y los costes asociados al mantenimiento de infraestructura DNS.
El sistema incluye wrappers en Bash y PowerShell para facilitar la ejecución en diferentes entornos, además de soporte nativo para Python vía `uv`. Genera automáticamente configuraciones compatibles con clientes populares como Clash Verge, FlClash y Amnezia, permitiendo a los usuarios acceder a su red privada desde cualquier dispositivo.
- Despliegue automatizado de servidor VPN en VPS propio usando solo IP y credenciales SSH.
- Generación automática de configuraciones para clientes como Clash Verge o FlClash sin intervención manual.
- Uso de Cloudflare WARP como salida por defecto para ocultar la dirección IP real del VPS.
- Ejecución local o remota mediante CLI Python o scripts de shell en Windows, Linux y macOS.
- No requiere dominio propio ni certificados TLS (usa camuflaje Reality).
- Automatización completa con Ansible (idempotente y declarativo).
- Soporte multiplataforma vía CLI Python (uv) y wrappers de shell.
- Footprint mínimo con instalación nativa de Xray-core (opcional Docker).
- Portabilidad: playbook transmitido por SSH sin clonar repo en servidor.
- Documentación exhaustiva en inglés y ruso con guías de recuperación.
- Licencia AGPL-3.0 con restricciones comerciales explícitas (requiere permiso del autor).
- Dependencia de Python 3.12+ o Ansible 2.14+ para ejecución.
- Amnezia reportado como inestable en la documentación oficial.
- Requiere VPS con IP pública y acceso SSH root/sudo.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Requiere VPS Ubuntu 20.04+/Debian 11+ con IP pública y acceso SSH (clave o password). Ejecutar `xrayvpn deploy` localmente apuntando al host remoto, o usar wrappers de shell/PowerShell. No requiere clonar repo en el servidor objetivo. Verificar VPS antes de pago largo.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.