Documentación de ComusThumbz
Iniciar Sesión

Requisitos del sistema

Para los sitios web basados en vídeo para los mejores resultados debe tener un servidor principal (para ComusThumbz), un servidor de almacenamiento y 1 o más servidores de conversión de vídeo. Para los servidores de almacenamiento y covnersion puede utilizar servicios disponibles, simplemente siga los enlaces en nuestro administrador.

Qué cubre esta página

Esta guía explica lo que su servidor web necesita instalar antes de que pueda ejecutar ComusThumbz. Si ya ha instalado ComusThumbz con éxito, es probable que su servidor cumpla todos estos requisitos. Utilice esta guía al configurar un nuevo servidor o problemas de solución de problemas.

Nota: Si está usando un proveedor de alojamiento como cPanel, HestiaCP o Plesk, muchos de estos requisitos son preconfigurados para usted. Sin embargo, algunos ajustes (especialmente para el procesamiento de vídeo) pueden necesitar ajustes.

¿Conozco los requisitos?

Quick Check

La mayoría de los proveedores de alojamiento que soportan los sitios web PHP modernos pueden ejecutar ComusThumbz. Necesitas:

  • Un servidor Linux (Ubuntu, Debian, CentOS, o similar)
  • PHP versión 8.3 o newer
  • Base de datos MySQL o MariaDB
  • Al menos 2 GB de RAM (4GB+ recomendado para sitios de vídeo)
  • FFmpeg instalado (requerido para el procesamiento de vídeo)
  • IonCube
Advertencia: ComusThumbz no trabaja en alojamiento compartido que bloquea las herramientas de procesamiento de vídeo. Necesitarás un VPS (Virtual Private Server) o un servidor dedicado para obtener mejores resultados.

Qué puede hacer ComusThumbz

Cuando su servidor cumpla con todos los requisitos, tendrá acceso a estas características:

  • Subir y gestionar vídeos con la generación automática de miniaturas y múltiples opciones de calidad
  • Crear galerías de fotos con procesamiento de imágenes y cargas a granel
  • Host webcam streams en vivo utilizando tecnología de vídeo en tiempo real
  • Monetización del Creador incluyendo consejos, suscripciones y contenido de pago por vista
  • Idiomas múltiples apoyar 25 idiomas de árabe a vietnamita
  • Proceso de pago con soporte para Stripe, PayPal, CCBill y otros 7 proveedores
  • Almacenamiento de CDN descargar archivos de vídeo a BunnyCDN, Wasabi, Backblaze y otros servicios
  • Análisis avanzado seguimiento de vistas, clics, ganancias y comportamiento del usuario
  • Herramientas impulsadas por la IA para ayudar a revisar y organizar el contenido más rápido
Nota: No necesitas usar todas las funciones. Por ejemplo, si no estás hospedando corrientes en vivo, puedes saltar los pasos de configuración específicos de streaming.

Tipo de servidor: Lo que funciona mejor

Tipo de alojamientoAdecuado paraNotas
VPS ( Servidor privado virtual)Sitios pequeños a medianosMejor equilibrio de costo y control
Servidor dedicadoGrandes sitios con tráfico pesadoRendimiento máximo
Servidor Cloud (DigitalOcean, Linode, Vultr)Sitios escalablesFácil de actualizar a medida que crece

Especies mínimas del servidor:

  • 2 núcleos de CPU (4+ recomendados)
  • 2GB RAM (4GB+ recomendado)
  • 10GB espacio libre de disco (más si almacena videos localmente)
  • Ubuntu 22.04 o Debian 12
Advertencia: Hosting compartido NO se recomienda porque:
  • Las herramientas de procesamiento de vídeo generalmente se bloquean
  • No suficiente memoria para subidas de vídeo
  • No se pueden realizar tareas de fondo necesarias para el procesamiento
  • No control sobre la configuración del servidor


Si actualmente estás en alojamiento compartido, necesitarás actualizar a un VPS para usar funciones de vídeo.

Requisitos de software

Web Server

Su servidor necesita Apache o Nginx para servir páginas web.

Apache (más común):

  • Debe apoyarse .htaccess archivos para direcciones URL limpias
  • Versión 2.4 o nueva

Nginx:

  • Versión 1.18 o nueva
  • Requiere configuración manual para URL limpias

Sugerencia: Si está usando un panel de control como cPanel o HestiaCP, el servidor web ya está configurado para usted.

Versión PHP

Necesario: PHP 8.3 o newer

ComusThumbz utiliza funciones PHP modernas que solo funcionan en la versión 8.3 y superior. Las versiones más antiguas (PHP 7.x o PHP 8.0-8.2) no funcionarán.

Comprobando su versión de PHP:

Si tiene acceso al servidor, ejecute:

php -v

Deberías ver algo como: PHP 8.3.x

Si ves una versión inferior (como 7.4 o 8.0), necesitarás actualizar PHP antes de instalar ComusThumbz.

Base de datos

Necesario: MySQL 5.7+ o MariaDB 10.3+

Recomendado: MySQL 8.0+ o MariaDB 11.4+

Su base de datos almacena todo su contenido, usuarios y configuraciones. Las versiones más recientes proporcionan un mejor rendimiento para sitios grandes.

Video Processing Tool (FFmpeg)

Error: FFmpeg está NECESITA para que las funciones de vídeo funcionen. Sin ella:
  • Los vídeos cargados permanecen atrapados en "pendiendo para siempre"
  • No se generan miniaturas ni clips de vista previa
  • Los vídeos no se pueden convertir en formatos de transmisión

¿Qué es FFmpeg?
FFmpeg es una herramienta de línea de comandos que convierte videos a diferentes formatos y crea miniaturas. Se ejecuta en el fondo automáticamente cuando los usuarios suben videos.

Comprobando si FFmpeg está instalado:

ffmpeg -version

Si ves la información de la versión, FFmpeg está instalado. Si ve "no se encuentra el encargado", necesitará instalarlo o pedirle a su proveedor de alojamiento que lo instale.


Configuración de PHP que necesita ajuste

Varias configuraciones de PHP controlan cuántos archivos puede subir y cuánto tiempo puede ejecutar el procesamiento. Estos generalmente necesitan ser aumentados de valores predeterminados.

Ajustes importantes

AjusteLo que haceValor recomendado
memorialímiteCuanta memoria PHP puede usar512M
maxexecutiontiempo¿Cuánto tiempo pueden ejecutar los scripts?600 segundos (10 minutos)
SubirmaxficherosTamaño máximo de carga500M (o más grande)
postmaxtamañoTamaño máximo de la presentación de formularios500M ( igual que subir)
Sugerencia: Si utiliza cPanel, puede ajustar estos ajustes desde MultiPHP INI EditorPara HestiaCP, vaya a Server √≥ Configure √ PHP y editar los ajustes allí.

Cómo comprobar la configuración actual

Crear un archivo llamado phpinfo.php con este contenido:

Subirlo a su sitio y visitarlo en un navegador (ejemplo: https://yoursite.com/phpinfo.php). Verás todos los ajustes de PHP. Busque los nombres de configuración anteriores para ver los valores actuales.

Advertencia: Suprimir phpinfo.php después de revisar la configuración - revela información sobre su servidor que no debe ser público.

Funciones PHP que deben ser habilitadas

Algunos proveedores de alojamiento deshabilitan ciertas funciones de PHP para la seguridad. ComusThumbz necesita que estas funciones funcionen:

FunciónPara lo que se utiliza
exec()Corriendo FFmpeg para el procesamiento de vídeo
shellexec()Herramientas de línea de comandos
fileputcontents()Archivos de configuración de ahorro
mkdir()Crear carpetas para subidas
chmod()Configuración de permisos de carpeta

Si estos son discapacitados: Los vídeos no procesarán, las subidas fallarán, y los ajustes no se pueden guardar.

Cómo habilitarlos: Póngase en contacto con su proveedor de alojamiento o editar php.ini si tiene acceso al servidor. Busca una línea empezando con disablefunctions = y eliminar cualquiera de las funciones enumeradas anteriormente.


Tareas de fondo automático (trabajos de hierro)

Error: Un trabajo de cron debe correr o su sitio no funcionará correctamente. Sin ella:
  • Los vídeos permanecen atrapados en "pendiendo"
  • Las ganancias no se calculan
  • Las estadísticas no actualizan

¿Qué es un trabajo de Cron?

Un trabajo de cron es una tarea automática que funciona cada minuto en el fondo. Maneja procesamiento de vídeo, actualiza estadísticas y realiza otras tareas de mantenimiento.

Configuración del trabajo de Cron

Necesitas establecer un trabajo de cron que funcione cada minuto:

El comando:

     php /path/to/your/site/ct/admin/cron/sitecron.php

Reemplazamiento /path/to/your/site/ con su ruta de instalación real.

usuarios de cPanel:

Ve. Trabajos avanzados de Cron

  1. Establecer el tiempo para (cada minuto)
  2. Pruebe el comando arriba con su camino correcto
  3. Haga clic Add New Cron Job

Usuarios HestiaCP:

  1. Inicie sesión vía SSH
  2. Corre: crontab -e
  3. Añadir la línea de cron y guardar

Comprobando si funciona:

  • Los videos deben pasar de "pendiendo" a "activo" en unos minutos de carga
  • Ve. Panel de Admin Cron Manager para ver la última vez


HTTPS / Certificado SSL

Advertencia: HTTPS es muy recomendable y NECESITA para:
  • Pagos aceptados
  • SEO ( ranking de Google)
  • Características de seguridad del navegador

Los proveedores de alojamiento más modernos ofrecen certificados SSL gratuitos a través de Encriptemos.

cPanel: Ve. Estado SSL/TLS y haga clic AutoSSL para obtener un certificado gratuito

HestiaCP: Ve. Web ≤ [su dominio] Editar > SSL y activar Let's Encrypt

Configuración manual: Si administra su propio servidor, utilice Certbot:

sudo certbot --apache -d yourdomain.com

Éxito: Una vez instalado SSL, su sitio redirigirá automáticamente desde http:// a https://.

Planificación espacial

¿Cuánto espacio necesito?

Volumen de contenidoEspacio recomendado
Sitio pequeño (hasta 1.000 vídeos)50GB con CDN
Sitio medio (hasta 10.000 vídeos)500 GB con CDN
Sitio grande (100,000+ videos)CDN requerido - no almacenar localmente
Sugerencia: Utilice un CDN (Content Delivery Network) como BunnyCDN, Wasabi o Backblaze para almacenar videos. Esto mantiene el espacio del disco del servidor libre y ofrece videos más rápido a los usuarios de todo el mundo. ComusThumbz ha incorporado apoyo a todos los CDN importantes.

Donde se almacenan los archivos

Después de la instalación, estas carpetas mantendrán su contenido:

  • ct/uploads/videos/ - Archivos de vídeo cargados
  • ct/uploads/images/ - Imágenes y miniaturas
  • ct/cache/ - Archivos temporales (pueden ser aclarados)
  • ct/logs/ - Registros de sistemas

Estas carpetas deben ser escritas por el servidor web.


Requisitos de transmisión en vivo (opcional)

Nota: Sólo se necesita si desea acoger streams de webcam en vivo. Skip this section if you're not using live streaming features.

Transmisión en vivo requiere Docker y LiveKit para ser instalado en su servidor.

¿Qué es Docker?
Docker es una herramienta que ejecuta LiveKit (el software de streaming) en un contenedor aislado.

¿Qué es LiveKit?
LiveKit maneja streaming de vídeo en tiempo real entre emisoras y espectadores.

Requisitos del sistema:

  • Docker Engine 20.10 o nuevo
  • Puertos abiertos: 7880, 7881 (TCP) y 50000-50020 (UDP)
  • Servidor separado recomendado para streaming de alto tráfico

Sugerencia: Si no estás cómodo configurar Docker, considera usar un servicio de streaming gestionado en su lugar, o salta el streaming en vivo completamente. Aún puedes albergar videos pregrabados sin LiveKit.

Problemas y soluciones comunes

Vídeos Permanezcan "Pendiente" Para siempre

Lo que ves: Subes un vídeo pero nunca aparece en tu sitio. En el panel de administración, muestra el estado "pendiendo".

Causas comunes:

  1. Cron no funciona
  2. FFmpeg no instalado
  3. Funciones PHP desactivadas

Cómo arreglar:

  1. Compruebe si el trabajo de cron está funcionando (ver Panel de Admin Cron Manager)
  2. Prueba FFmpeg: Corre ffmpeg -version vía SSH o pregunte a su anfitrión
  3. Verificar funciones de PHP: Crear un archivo de prueba para verificar exec() obras
  4. Apoyo de contacto si la cuestión persiste

No puede cargar archivos grandes

Lo que ves: Subir fallas para vídeos mayores de 100 MB.

Cómo arreglar:

  1. Aumentar la configuración de PHP (uploadmaxfilesize y postmaxsize) a al menos 500M
  2. Reinicie PHP-FPM después de cambiar la configuración
  3. Si en cPanel, use MultiPHP INI Editor

Errores denegados por permiso

Lo que ves: Errores acerca de archivos o carpetas que no son útiles.

Cómo arreglar:

  1. Asegúrese de que las carpetas tienen permisos correctos:

  • ct/logs/ debe ser escrito
  • ct/uploads/ debe ser escrito
  • ct/cache/ debe ser escrito

  1. Si tienes acceso a SSH, corre: chmod -R 775 ct/logs ct/uploads ct/cache
  2. Contacte con su proveedor de alojamiento si no tiene acceso SSH

Conexión de bases de datos fallado

Lo que ves: Mensaje de error sobre la conexión de la base de datos en cada página.

Cómo arreglar:

  1. Mira que MySQL está corriendo
  2. Verificar las credenciales de la base de datos ct/dat/config.inc.php
  3. Asegúrese de que el usuario de la base de datos tiene permisos completos
  4. Comuníquese con su proveedor de alojamiento para problemas de base de datos


Verificación de su servidor automáticamente

Requisitos Control Script

Guarda esto como checkrequirements.php en su raíz del sitio y visitarlo en su navegador:

ComusThumbz Requirements Check\n";
echo "
\n";

// PHP Version
$phpOk = versioncompare(PHPVERSION, '8.3.0', '>=');
echo "PHP Version: " . PHPVERSION . " " . ($phpOk ? '✅ OK' : '❌ Need 8.3+') . "\n\n";

// Extensions
$extensions = ['pdo', 'pdomysql', 'gd', 'curl', 'mbstring', 'json'];
echo "Required Extensions:\n";
foreach ($extensions as $ext) {
$loaded = extensionloaded($ext);
echo " $ext: " . ($loaded ? '✅ OK' : '❌ MISSING') . "\n";
}

// Functions
$disabled = explode(',', iniget('disablefunctions'));
$required = ['exec', 'shellexec', 'mkdir', 'chmod', 'fileputcontents'];
echo "\nRequired Functions:\n";
foreach ($required as $func) {
$ok = !inarray(trim($func), arraymap('trim', $disabled));
echo " $func: " . ($ok ? '✅ OK' : '❌ DISABLED') . "\n";
}

// Settings
echo "\nPHP Settings:\n";
echo " memorylimit: " . iniget('memorylimit') . "\n";
echo " maxexecutiontime: " . iniget('maxexecutiontime') . " seconds\n";
echo " uploadmaxfilesize: " . iniget('uploadmaxfilesize') . "\n";
echo " postmaxsize: " . iniget('postmaxsize') . "\n";

// FFmpeg
echo "\nExternal Tools:\n";
$ffmpeg = @shellexec('which ffmpeg 2>/dev/null');
echo " FFmpeg: " . ($ffmpeg ? '✅ Found' : '❌ NOT FOUND') . "\n";
echo "
\n"; ?>

Este script comprueba:

  • Versión PHP
  • Extensiones requeridas
  • Funciones habilitadas
  • Ajustes de PHP
  • Instalación FFmpeg

Sugerencia: Marcas de cheques verdes (diga) significa que todo está bien. Las marcas rojas X (hora) indican problemas que necesitan solución.

Obtener ayuda

Donde mirar primero

  1. Revisa el trabajo de cron - La mayoría de los "videos no procesados" se relacionan con cron
  2. Verify FFmpeg is installed - Corre. ffmpeg -version para comprobar
  3. Revisar la configuración de PHP - Asegúrate de que los límites de memoria y carga sean lo suficientemente altos
  4. Consultar permisos de carpeta - Carpeta de cargas debe ser writable

Cuándo contactar soporte

Póngase en contacto con su proveedor de alojamiento si:

  • No puede acceder a los ajustes de PHP o cPanel
  • FFmpeg no está instalado y no puede instalarlo
  • La base de datos no se conectará a pesar de las credenciales correctas
  • Problemas de cortafuegos están bloqueando las conexiones

Contacto ComusThumbz soporte si:

  • Los requisitos se cumplen pero las características todavía no funcionan
  • Usted ve mensajes de error específicos en el panel de administración
  • Las opciones de configuración no están claras


GuíaCuándo utilizarlo
Guía de instalaciónDespués de verificar los requisitos, utilice esto para instalar ComusThumbz
Guía de configuración del servidorInstrucciones específicas para configuraciones de cPanel, HestiaCP, Plesk y CLI
Ajustes Centro de ControlConfiguración ComusThumbz después de la instalación
Configuración del procesador de vídeoProcesamiento de vídeo fino y opciones FFmpeg
Servidores de almacenamientoConfigurar almacenamiento CDN para vídeos
Cron ManagerSupervisar y gestionar tareas de antecedentes

Lista resumida

Antes de instalar ComusThumbz, verifique que tiene:

  • [ ] Servidor Linux (VPS o alojamiento dedicado, no compartido)
  • [ ] PHP 8.3 o newer
  • [ ] MySQL 5.7+ o MariaDB 10.3+
  • [ ] Al menos 2GB RAM (4GB+ recomendado)
  • FFmpeg instalado y trabajando
  • [ ] exec() y funciones relacionadas PHP habilitadas
  • [ ] límite de memoria PHP fijado a 512M o superior
  • [ ] Subir el tamaño máximo fijado a 500M o superior
  • [ ] Carpetas para cargas, registros y caché
  • [ ] Capacidad de trabajo de hierro ( funciona cada minuto)
  • [ ] Certificado SSL (gratuito Vamos a Encrypt funciona genial)
  • [ ] 10GB+ espacio libre de disco
Éxito: Si puede comprobar todas estas cajas, su servidor está listo para la instalación ComusThumbz!

¿Necesita más ayuda? Compruebe la Guía de instalación siguiente, o ponerse en contacto con su proveedor de alojamiento para verificar los requisitos del servidor.