Preguntas Frecuentes (FAQ)

Respuestas a las preguntas más comunes sobre NoxPanel.

General

P: ¿Qué es NoxPanel?

NoxPanel es una plataforma modular de gestión de infraestructura cloud que integra:

  • Hosting compartido (tipo cPanel)

  • Gestión de VPS/VMs con Proxmox

  • Sistema de facturación con Stripe y PayPal

  • Sistema de tickets / helpdesk con soporte IMAP y OAuth2

Diseñado para proveedores de hosting y empresas que necesitan gestionar múltiples clientes y servicios desde un único panel.

P: ¿Qué tecnologías usa NoxPanel?

  • Backend: Django 5.x + Django REST Framework

  • Base de datos: PostgreSQL 15

  • Cola de tareas: Celery + Redis

  • Hosting: Motor de hosting (Apache, Postfix, Dovecot, BIND, Pure-FTPd)

  • Virtualización: Proxmox VE

  • Proxy inverso: Traefik con Let’s Encrypt automático

  • Contenedores: Docker + Docker Compose

  • Frontend: Bootstrap 5 + JavaScript vanilla

P: ¿Es NoxPanel de código abierto?

Sí, NoxPanel es un proyecto open source. Puedes contribuir siguiendo la Guía de Contribución.

Activación Modular

P: ¿Puedo activar solo algunos módulos?

Sí. NoxPanel tiene un sistema de activación modular por usuario. Cada módulo (hosting, VPS, facturación, tickets) se activa individualmente mediante campos booleanos en el modelo de usuario:

  • can_access_hosting

  • can_access_vps

  • can_access_billing

  • can_access_ticketing

Un administrador puede habilitar/deshabilitar módulos desde el Django Admin. Ver Sistema de Módulos para más detalles.

P: ¿Puedo usar solo el módulo de hosting sin VPS?

Sí. Configura can_access_hosting=True y can_access_vps=False para cada usuario. No necesitas tener Proxmox instalado si no usas el módulo VPS.

P: ¿Puedo usar solo facturación y tickets sin hosting ni VPS?

Sí. Puedes activar solo can_access_billing y can_access_ticketing. El sistema funciona como un helpdesk con facturación independiente.

P: ¿Los superusuarios tienen acceso a todos los módulos?

Sí. Los superusuarios (is_superuser=True) siempre tienen acceso a todos los módulos, independientemente de los campos can_access_*.

Multi-Tenant

P: ¿Qué es el modo multi-tenant?

El modo multi-tenant permite alojar múltiples organizaciones (clientes/empresas) en una sola instalación de NoxPanel. Cada tenant tiene:

  • Sus propios recursos (sitios, BBDDs, dominios, buzones)

  • Cuotas individuales configurables

  • Usuarios con roles específicos (admin, member, viewer)

  • Datos completamente aislados de otros tenants

P: ¿Puedo desactivar el modo multi-tenant?

Sí. Configura MULTI_TENANT_ENABLED=False en el archivo .env. En este modo, todos los recursos se gestionan sin separación por tenant.

P: ¿Un usuario puede pertenecer a varios tenants?

Sí. Un usuario puede ser miembro de múltiples tenants con diferentes roles en cada uno. Por ejemplo, puede ser admin en un tenant y viewer en otro.

P: ¿Cómo se garantiza el aislamiento de datos entre tenants?

El middleware TenantIsolationMiddleware filtra automáticamente todas las consultas de base de datos por el tenant del usuario autenticado. Con TENANT_ISOLATION_STRICT=True (por defecto), se aplican validaciones adicionales en cada operación.

Facturación y Precios

P: ¿Qué pasarelas de pago soporta NoxPanel?

Actualmente soporta:

  • Stripe — Tarjetas de crédito/débito, SEPA

  • PayPal — Pagos y suscripciones

  • Transferencia bancaria — Registro manual

  • Pago manual — Para casos especiales

P: ¿Puedo personalizar los precios por cliente?

Sí. Las suscripciones tienen un campo custom_price que permite establecer un precio personalizado que anula el del plan estándar. Esto es útil para clientes enterprise o descuentos especiales.

P: ¿El formato de factura es compatible con mi ERP?

Las facturas incluyen campos estándar para integración ERP/CRM: number, tax_id, billing_name, billing_address, subtotal, tax_rate, tax_amount, total, currency, y items[] con líneas detalladas. El formato JSON es parseable por cualquier sistema.

P: ¿Soporta facturación por horas?

Sí. Los planes pueden configurarse con billing_period='hourly' para facturación por consumo, típica de VPS. El sistema registra automáticamente el uso (UsageRecord) y genera facturas periódicas.

P: ¿Qué monedas soporta?

La moneda se configura por plan de precios y por perfil de facturación. El campo currency usa código ISO 4217 (EUR, USD, GBP, etc.). Por defecto es EUR.

Integraciones

P: ¿Qué versiones de Proxmox son compatibles?

NoxPanel es compatible con Proxmox VE 7.x y 8.x. Se comunica mediante la API REST de Proxmox.

P: ¿Qué motor de hosting se utiliza?

El motor de hosting se instala automáticamente dentro del contenedor hosting-core. La comunicación se realiza mediante la API REST del motor de hosting.

P: ¿Puedo usar NoxPanel sin Proxmox?

Sí. Si no necesitas el módulo de VPS, simplemente no configures las variables PROXMOX_* y deshabilita el módulo VPS para los usuarios.

P: ¿Puedo usar NoxPanel sin el motor de hosting?

Sí. Configura HOSTING_PROVIDER=mock en .env. En este modo, las operaciones de hosting se simulan localmente sin crear recursos reales en un servidor de hosting.

P: ¿Soporta integración con Microsoft 365 / Google Workspace para tickets?

Sí. El módulo de tickets soporta recepción de email via:

  • IMAP/POP3 tradicional

  • OAuth2 Microsoft 365 (Exchange Online)

  • OAuth2 Google (Gmail / Google Workspace)

Despliegue y Rendimiento

P: ¿Cuáles son los requisitos mínimos de hardware?

Para un despliegue básico:

  • CPU: 2 cores

  • RAM: 4 GB (8 GB recomendado con el motor de hosting)

  • Disco: 20 GB SSD

  • OS: Ubuntu 22.04+ o Debian 12+

Para producción con carga:

  • CPU: 4+ cores

  • RAM: 16+ GB

  • Disco: 100+ GB SSD/NVMe

P: ¿Puedo ejecutar NoxPanel y Proxmox en el mismo servidor?

Sí, pero no es recomendado para producción. Proxmox consume recursos significativos para las VMs. Lo ideal es tener NoxPanel en un servidor dedicado que se comunique con Proxmox via API.

P: ¿Cómo actualizo NoxPanel?

Consulta la Guía de Actualización para el proceso detallado. En resumen: git pull, docker-compose up -d, migrate, collectstatic.

P: ¿NoxPanel soporta alta disponibilidad?

El panel en sí puede desplegarse detrás de un balanceador de carga. La base de datos PostgreSQL soporta réplicas de lectura. Redis puede configurarse en modo Sentinel/Cluster. El motor de hosting soporta mirrors para los servidores de hosting.

Seguridad

P: ¿Cómo se almacenan las contraseñas del hosting y FTP?

Las contraseñas se almacenan cifradas. Las contraseñas de cuentas de email del módulo de tickets se cifran con Fernet (symmetric encryption).

P: ¿Soporta autenticación de dos factores (2FA)?

Actualmente se autentica via JWT con tokens de corta vida (60 min). La implementación de 2FA con TOTP está en el roadmap del proyecto.

P: ¿Las comunicaciones son seguras?

  • Panel web: HTTPS con certificados Let’s Encrypt (via Traefik)

  • API: JWT sobre HTTPS

  • Comunicación interna: Red Docker aislada

  • CSRF: Protección contra Cross-Site Request Forgery

  • CORS: Configuración estricta de orígenes permitidos

Soporte

P: ¿Dónde puedo reportar bugs?

Abre un issue en el repositorio de GitHub: https://github.com/ocentelles/NoxPanel/issues

P: ¿Dónde puedo obtener soporte técnico?

  • GitHub Issues: Para bugs y peticiones de funcionalidades

  • Documentación: Esta documentación que estás leyendo

  • Código fuente: El código está bien documentado con docstrings en español