terraform-provider-threexui
Proveedor Terraform para 3x-ui que gestiona inbounds, clientes y configuración Xray como código. Permite GitOps para paneles VPN con soporte para VLESS, Reality y WireGuard en múltiples versiones de 3x-ui.
Ficha actualizada 25 sept 2026, 12:26 · upstream 25 sept 2026, 12:03 · release v3.26.0
Qué es terraform-provider-threexui
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este proveedor Terraform permite gestionar la infraestructura del panel 3x-ui (Xray/VLESS/Reality/WireGuard) mediante código, facilitando la automatización de inbounds, clientes y configuraciones Xray. Elimina la necesidad de interacción manual con el panel web para tareas repetitivas como añadir usuarios o rotar claves. Soporta recursos completos desde nodos de cluster hasta ajustes de seguridad del panel y notificaciones vía Telegram o Discord.
La herramienta está construida en Go y se integra con PostgreSQL, permitiendo migraciones seguras entre servidores restaurando la base de datos del panel y verificando el estado con Terraform. Ofrece compatibilidad con múltiples versiones de 3x-ui (desde v3.3.0 hasta v3.8.5) mediante guardado automático de características nuevas, asegurando estabilidad en entornos heterogéneos sin necesidad de forks por versión.
La gestión de secretos es robusta, marcando campos sensibles como claves Reality o tokens de Telegram para evitar su exposición en registros. Incluye ejemplos para flotas multi-servidor y patrones de importación de recursos existentes.
- Automatizar la creación y gestión masiva de clientes VPN sin intervención manual mediante bucles for_each.
- Migrar paneles 3x-ui entre servidores restaurando la base de datos y verificando el estado con terraform plan.
- Gestionar configuraciones Xray complejas (rutas, DNS, observatorios) como código versionado en Git.
- Implementar nodos de cluster para distribuir tráfico entre múltiples instancias del panel 3x-ui.
- Rotar credenciales administrativas o claves Reality en todos los servidores desde un repositorio central.
- Gestión completa de inbounds y clientes con recursos nativos como threexui_inbound y threexui_inbound_client.
- Soporte para protocolos Xray avanzados: VLESS, VMess, Trojan, Shadowsocks y WireGuard en un solo proveedor.
- Integración GitOps que permite auditoría de cambios mediante historial de commits del repositorio.
- Compatibilidad multi-versión con 3x-ui (v3.3.0 a v3.8.5) sin necesidad de mantenimiento manual por versión.
- Recursos para notificaciones externas vía Telegram, Discord y SMTP integrados en el panel.
- Soporte para importación de recursos existentes para unificar infraestructura gestionada manualmente.
- Requiere acceso administrativo al panel 3x-ui (usuario y contraseña) para la autenticación API.
- Dependencia de la base de datos PostgreSQL del panel para migraciones y recuperación de desastres.
- Funcionalidades avanzadas como notificaciones Discord o grupos de hosts requieren versiones específicas de 3x-ui.
- No incluye Dockerfile, requiriendo el uso de docker compose para entornos locales o despliegues personalizados.
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.
Despliegue mediante Docker Compose en puerto 2053. Configurar variables de entorno THREEXUI_* para autenticación. Realizar copias de seguridad periódicas del estado de Terraform y la base de datos del panel antes de aplicar cambios críticos. Compatible con OpenTofu usando el registro completo registry.terraform.io.
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.