=========================== Preguntas Frecuentes (FAQ) =========================== Respuestas a las preguntas más comunes sobre NoxPanel. .. contents:: En esta página :local: :depth: 2 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 :doc:`contributing`. 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 :doc:`../admin/modules` 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 :doc:`../deployment/upgrade` 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