Configuración de servidores comunes

Versión del documento: 1.0.0
Última actualización: 2026-01-02
Aplica a: ComusThumbz v1.11.14+

Sinopsis

Esta guía cubre la configuración del servidor paso a paso para los entornos de alojamiento más comunes utilizados con ComusThumbz. Cada sección proporciona instrucciones completas de configuración incluyendo configuración PHP, configuración del servidor web y requisitos específicos de ComusThumbz.

Medios de apoyo

HestiaCP Setup

Hestia CP es un panel de control gratuito popular para servidores VPS. Esta guía de configuración cubre una instalación completa de ComusThumbz.

Prerrequisitos

• Ubuntu 20.04/22.04 o Debian 10/11
• HestiaCP instalado
• Dominio apuntado al servidor
• Acceso SSH

Paso 1: Crear dominio Web

1. Inicia sesión en HestiaCP https://your-server-ip:8083
2. Ve. WEB pestaña
3. Haga clic Agregar dominio Web
4. Introduzca su nombre de dominio
5. Habilitación SSL Support y comprobar Encriptemos
6. Haga clic Guardar

[Screenshot: hestiacp-add-domain]

Paso 2: Configurar PHP

1. Ve. WEB pestaña
2. Haga clic en el icono de llave inglesa junto a su dominio
3. Seleccione PHP 8.3 de la versión PHP desplegable
4. Haga clic Guardar

Paso 3: Activar funciones de PHP requeridas

Opción A: Via HestiaCP Panel

1. Ve. SERVICIOS ■ Configuración ■ PHP-FPM
2. Encuentre su versión PHP (por ejemplo, PHP 8.3)
3. Localizar disablefunctions en la configuración
4. Eliminar estas funciones de la lista de discapacitados:

exec

• shellexec
• passthru
• procopen
• popen

1. Haga clic Guardar
2. Restart PHP: En SSH, ejecutar systemctl restart php8.3-fpm

Opción B: Via SSH (Recomendado)

# Edit PHP configuration
sudo nano /etc/php/8.3/fpm/php.ini

Encontrar deshabilitaciónlínea de funciones (línea 314)

Cambio de:

disablefunctions = exec,passthru,shellexec,system,procopen,popen,...

Cambio a (remove exec, passthru, shellexec, procabierto, popen:

disablefunctions = system,...

Guardar y reiniciar PHP-FPM

sudo systemctl restart php8.3-fpm

Paso 4: Ajuste PHP Ajustes

# Edit PHP configuration
sudo nano /etc/php/8.3/fpm/php.ini

Actualizar estos ajustes:

memorylimit = 512M
maxexecutiontime = 600
uploadmaxfilesize = 500M
postmaxsize = 500M
maxinputvars = 10000

Save and restart

sudo systemctl restart php8.3-fpm

Paso 5: Instalar FFmpeg

sudo apt update
sudo apt install ffmpeg

Verificar la instalación

ffmpeg -version
which ffmpeg  # Should return /usr/bin/ffmpeg

Paso 6: Instalar ImageMagick (opcional)

sudo apt install imagemagick php8.3-imagick
sudo systemctl restart php8.3-fpm

Paso 7: Subir Archivos ComusThumbz

Via File Manager:

En HestiaCP, vaya a FILES

1. Navigate a /home/username/web/yourdomain.com/publichtml/
2. Cargar y extraer archivos ComusThumbz

Via SFTP:

# Connect with SFTP client (FileZilla, WinSCP)

Host: su servidor-ip

Nombre de usuario: su usuario HestiaCP

Contraseña: su Hestia CP password

Upload to: /home/username/web/yourdomain.com/publichtml/

Paso 8: Establecer permisos

# SSH into your server
cd /home/username/web/yourdomain.com/publichtml

Establecer la propiedad

chown -R username:username ct/

Establecer permisos de base

find ct/ -type d -exec chmod 755 {} \;
find ct/ -type f -exec chmod 644 {} \;

Hacer directorios de carga/log

chmod -R 775 ct/logs ct/uploads ct/cache
chmod 777 ct/uploads/temp ct/uploads/temp/useruploads

Paso 9: Configurar el trabajo de Cron

1. SSH en tu servidor
2. Corre: crontab -e
3. Añadir esta línea:

     /usr/bin/php /home/username/web/yourdomain.com/publichtml/ct/admin/cron/sitecron.php >> /home/username/web/yourdomain.com/publichtml/ct/logs/cron/sitecron.log 2>&1

Paso 10: Run Installer

1. Navigate a https://yourdomain.com/install/
2. Siga el asistente de instalación
3. Suprímase /install/ carpeta después de la terminación

cPanel/WHM Configuración

c Panel es el panel de control de alojamiento compartido más común. Esta guía cubre la configuración para alojamiento compartido y VPS con cPanel.

Prerrequisitos

• c Cuenta de acogida del Grupo
• PHP 8.0+ disponible
• Acceso SSH (opcional pero recomendado)

Paso 1: Seleccione la versión PHP

1. Inicia sesión en cPanel
2. Ve. Software ■ MultiPHP Manager
3. Seleccione su dominio
4. Elija PHP 8.3 (o más alto disponible 8.x)
5. Haga clic Aplicar

[Screenshot: cpanel-php-version]

Paso 2: Configuración de PHP

1. Ve. Software ■ MultiPHP INI Editor
2. Seleccione Modo de editor
3. Elija su dominio
4. Actualizar estos ajustes:

• memorylimit = 512M
• maxexecutiontime = 600
• uploadmaxfilesize = 500M
• postmaxsize = 500M
• maxinputvars = 10000

1. Haga clic Guardar

Paso 3: Activar PHP Funciones

Si tiene acceso a WHM:

1. Inicie sesión en WHM
2. Ve. Configuración de servicio ■ PHP Configuration Editor
3. Encontrar disablefunctions
4. Quitar: exec, shellexec, passthru, procopen, popen
5. Guardar y reconstruir PHP

En alojamiento compartido:
Póngase en contacto con su proveedor de alojamiento para habilitar estas funciones para su cuenta.

Paso 4: Subir archivos

Ve. Archivos ■ File Manager

1. Navigate a publichtml/
2. Haga clic Subir
3. Cargar y extraer archivos ComusThumbz

O utilice FTP:

• Host: yourdomain.com o ftp.yourdomain.com
• Nombre de usuario: su nombre de usuario cPanel
• Contraseña: contraseña de su cPanel

Paso 5: Configurar la base de datos

1. Ve. Bases de datos ■ Bases de datos MySQL
2. Crear una nueva base de datos (por ejemplo, usernamecomus)
3. Crear un nuevo usuario con una contraseña fuerte
4. Añadir usuario a la base de datos TODOS LOS PRIVILEGADOS

Paso 6: Configurar el trabajo de Cron

Ve. Avances ■ Cron Jobs

1. Calendario del juego: (cada minuto)
2. Comando:

/usr/local/bin/php /home/username/publichtml/ct/admin/cron/sitecron.php >> /home/username/publichtml/ct/logs/cron/sitecron.log 2>&1

1. Haga clic Add New Cron Job

Paso 7: Run Installer

Navigate a https://yourdomain.com/install/ y completar la instalación.

Plesk Setup

Plesk es un panel de control popular para VPS y servidores dedicados.

Paso 1: Agregar el dominio

1. Entra a Plesk
2. Ve. Sitios Web " Dominios "
3. Haga clic Agregar dominio
4. Introduzca su dominio y configure la configuración
5. Habilitación Apoyo SSL/TLS

Paso 2: Configurar PHP

1. Ve. Sitios Web " Dominios " ■ Su dominio Configuración de PHP
2. Set Versión PHP a 8.3
3. Configure:

• memorylimit = 512M
• maxexecutiontime = 600
• uploadmaxfilesize = 500M
• postmaxsize = 500M

1. Haga clic OK

Paso 3: Activar PHP Funciones

1. Ve. Configuración de PHP para su dominio
2. Encontrar Directrices adicionales Sección
3. Añadir:

disablefunctions =

(El valor empleado elimina todas las funciones de discapacidad)

1. O permite de forma selectiva eliminar funciones específicas de la lista de discapacitados

Paso 4: Instalar FFmpeg

Via SSH:

# Ubuntu/Debian

sudo apt install ffmpeg

CentOS

sudo yum install ffmpeg

Paso 5: Configurar el trabajo de Cron

1. Ve. Sitios Web " Dominios " ■ Su dominio Programado Tareas
2. Haga clic Add Task
3. Cuadro: Cada minuto )
4. Comando:

/usr/bin/php /var/www/vhosts/yourdomain.com/httpdocs/ct/admin/cron/sitecron.php

Paso 6: Subir e instalar

1. Cargar archivos a través de FTP o File Manager
2. Establecer permisos
3. Run installer at https://yourdomain.com/install/

Ubuntu + Apache (Manual Setup)

Para VPS o servidores dedicados sin un panel de control.

Paso 1: Sistema de actualización

sudo apt update
sudo apt upgrade -y

Paso 2: Instalar Apache

sudo apt install apache2 -y
sudo systemctl enable apache2
sudo systemctl start apache2

Paso 3: Instalar PHP 8.3

# Add PHP repository
sudo add-apt-repository ppa:ondrej/php -y
sudo apt update

Instalar PHP y extensiones

sudo apt install php8.3 php8.3-fpm php8.3-mysql php8.3-gd php8.3-curl \
    php8.3-mbstring php8.3-xml php8.3-zip php8.3-imagick php8.3-intl -y

Activar PHP-FPM con Apache

sudo a2enmod proxyfcgi setenvif
sudo a2enconf php8.3-fpm
sudo systemctl restart apache2

Paso 4: Instalar MySQL/MariaDB

sudo apt install mariadb-server -y
sudo mysqlsecureinstallation

Crear base de datos y usuario

sudo mysql -u root -p

CREATE DATABASE comusthumbz CHARACTER SET utf8mb4 COLLATE utf8mb4unicodeci;
CREATE USER 'comususer'@'localhost' IDENTIFIED BY 'YourSecurePassword123!';
GRANT ALL PRIVILEGES ON comusthumbz. TO 'comususer'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Paso 5: Instalar FFmpeg

sudo apt install ffmpeg -y
which ffmpeg  # Should return /usr/bin/ffmpeg

Paso 6: Configurar PHP

sudo nano /etc/php/8.3/fpm/php.ini

Actualizar estos ajustes:

memorylimit = 512M

maxexecutiontime = 600

uploadmaxfilesize = 500M

postmaxsize = 500M

maxinputvars = 10000

date.timezone = America/NewYork

; Ensure exec and related functions are NOT in disablefunctions

sudo systemctl restart php8.3-fpm

Paso 7: Configurar Apache Virtual Host

sudo nano /etc/apache2/sites-available/yourdomain.com.conf

    ServerName yourdomain.com
    ServerAlias www.yourdomain.com
    DocumentRoot /var/www/yourdomain.com

AllowOverride All
Require all granted
Directory>

<FilesMatch \.php$>
SetHandler "proxy:unix:/var/run/php/php8.3-fpm.sock|fcgi://localhost"
FilesMatch>

ErrorLog ${APACHELOGDIR}/yourdomain.com-error.log
CustomLog ${APACHELOGDIR}/yourdomain.com-access.log combined
VirtualHost>

# Enable site and required modules
sudo a2ensite yourdomain.com.conf
sudo a2enmod rewrite headers expires deflate
sudo systemctl restart apache2

Paso 8: Instalar SSL (Encriptamos)

sudo apt install certbot python3-certbot-apache -y
sudo certbot --apache -d yourdomain.com -d www.yourdomain.com

Paso 9: Sube ComusThumbz

# Create document root
sudo mkdir -p /var/www/yourdomain.com

Cargar archivos (a través de SCP, SFTP o wget)

cd /var/www/yourdomain.com

... subir archivos ...

Establecer la propiedad

sudo chown -R www-data:www-data /var/www/yourdomain.com

Establecer permisos

sudo find /var/www/yourdomain.com -type d -exec chmod 755 {} \;
sudo find /var/www/yourdomain.com -type f -exec chmod 644 {} \;
sudo chmod -R 775 /var/www/yourdomain.com/ct/logs /var/www/yourdomain.com/ct/uploads

Paso 10: Configurar el trabajo de Cron

sudo crontab -e

Añadir:

     /usr/bin/php /var/www/yourdomain.com/ct/admin/cron/sitecron.php >> /var/www/yourdomain.com/ct/logs/cron/sitecron.log 2>&1

Ubuntu + Nginx Setup

Nginx se recomienda para sitios de alto tráfico debido a su manejo eficiente de archivos estáticos y conexiones concurrentes.

Paso 1: Instalar Nginx y PHP

sudo apt update
sudo apt install nginx -y

Instalar PHP-FPM

sudo add-apt-repository ppa:ondrej/php -y
sudo apt update
sudo apt install php8.3-fpm php8.3-mysql php8.3-gd php8.3-curl \
    php8.3-mbstring php8.3-xml php8.3-zip php8.3-imagick -y

Paso 2: Configure Nginx

sudo nano /etc/nginx/sites-available/yourdomain.com

server {
    listen 80;
    listen [::]:80;
    servername yourdomain.com www.yourdomain.com;
    root /var/www/yourdomain.com;
    index index.php index.html;

# Cabeceras de seguridad
añadirheader X-Frame-Options "SAMEORIGIN" siempre;
añadirheader X-Content-Type-Options "nosniff" siempre;
añadirheader X-XSS-Protección "1; mode=block" siempre;

# Bloque de ubicación principal
ubicación / {
Pruebearchivos $uri $uri /index.php?$querycuerda;
}

# REST API rewrite
ubicación /ct/api/v1 {
Pruebearchivos $uri $uri//ct/api/v1/index.php?$querycuerda;
}

# PHP processing
ubicación ~ \.php$ {
incluir snippets/fastcgi-php.conf;
Fastcgipasar unix:/var/run/php/php8.3-fpm.sock;
Fastcgiparam SCRIPTFILENAME $documentroot$fastcgiscriptNombre;
incluyen fastcgiparams;
}

# Negar acceso a directorios sensibles
ubicación ~ ^/ct/(dat sufrimientologs)/ {
negar todo;
retorno 404;
}

# Cache archivos estáticos
ubicación ~ \.(jpg sometidajpeg sometidapng sometidagif sometidawebp sometidaico soportacss habitjs habitmp4 vidaswebm intimidadm3u8 vidasts)$ {
expira 30d;
añadirheader Cache-Control "public, immutable";
}

# Deny access to hidden files
location ~ /\. {
deny all;
}
}

# Enable site
sudo ln -s /etc/nginx/sites-available/yourdomain.com /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

Paso 3: Configurar PHP-FPM

sudo nano /etc/php/8.3/fpm/php.ini

Ajustes de actualización como se muestra en la sección Apache, a continuación:

sudo systemctl restart php8.3-fpm

Paso 4: Instalar SSL

sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d yourdomain.com -d www.yourdomain.com

Paso 5: Continuar con los pasos 4-10 de la guía de Apache

(Configuración de bases de datos, FFmpeg, subir archivos, permisos, cron)

CentOS / Configuración AlmaLinux

Paso 1: Instalar EPEL y repositorios obligatorios

# CentOS/RHEL 8+
sudo dnf install epel-release -y
sudo dnf install https://rpms.remirepo.net/enterprise/remi-release-8.rpm -y

Activar Remi PHP 8.3

sudo dnf module reset php -y
sudo dnf module enable php:remi-8.3 -y

Paso 2: Instalar Apache, PHP y Extensiones

sudo dnf install httpd php php-fpm php-mysqlnd php-gd php-curl \
    php-mbstring php-xml php-zip php-imagick -y

sudo systemctl enable httpd php-fpm
sudo systemctl start httpd php-fpm

Paso 3: Instalar MariaDB

sudo dnf install mariadb-server -y
sudo systemctl enable mariadb
sudo systemctl start mariadb
sudo mysqlsecureinstallation

Paso 4: Instalar FFmpeg

# Enable RPM Fusion
sudo dnf install https://download1.rpmfusion.org/free/el/rpmfusion-free-release-$(rpm -E %rhel).noarch.rpm -y

sudo dnf install ffmpeg -y

Paso 5: Configurar PHP

sudo nano /etc/php.ini

Actualizar la configuración como se describe en secciones anteriores.

sudo systemctl restart php-fpm

Paso 6: Configure SELinux (si está habilitado)

# Allow Apache to connect to network (for API calls)
sudo setsebool -P httpdcannetworkconnect 1

Permitir que Apache escriba para subir directorios

sudo chcon -R -t httpdsysrwcontentt /var/www/yourdomain.com/ct/uploads
sudo chcon -R -t httpdsysrwcontentt /var/www/yourdomain.com/ct/logs

Paso 7: Configure Firewall

sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --reload

Docker Setup (Development)

Para entornos de desarrollo o despliegues escalables.

docker-compose.yml

version: '3.8'

servicios:
web:
imagen: php:8.3-apache
contenedornombre: comusthumbz-web
puertos:

• "80:80"
• "443:443"

    volumes:

• ./:/var/www/html
• ./docker/php.ini:/usr/local/etc/php/php.ini
• ./docker/apache.conf:/etc/apache2/sites-available/000-default.conf

    dependson:

• db

    environment:

• APACHERUNUSER=www-data
• APACHERUNGROUP=www-data

    command: >

      bash -c "docker-php-ext-install mysqli pdo pdomysql gd

      && a2enmod rewrite

      && apache2-foreground"

db:
imagen: mariadb:11.4
contenedornombre: comusthumbz-db
puertos:

• "3306:3306"

    environment:

      MYSQLROOTPASSWORD: rootpassword

      MYSQLDATABASE: comusthumbz

      MYSQLUSER: comususer

      MYSQLPASSWORD: comuspassword

    volumes:

• dbdatos:/var/lib/mysql

ffmpeg:
imagen: jrottenberg/ffmpeg:4.4-alpine
contenedornombre: comusthumbz-ffmpeg
volúmenes:

• ./ct/uploads:/uploads

volumes:
dbdata:

docker/php.ini

memorylimit = 512M
maxexecutiontime = 600
uploadmaxfilesize = 500M
postmaxsize = 500M
maxinputvars = 10000
date.timezone = UTC

Running Docker Setup

# Build and start containers
docker-compose up -d

Correr instalador

Navigate to http://localhost/install/

Configuración de Cloudways

Cloudways proporciona alojamiento gestionado en la nube con fácil configuración.

Paso 1: Aplicación de lanzamiento

1. Inicia sesión en Cloudways
2. Haga clic Lanzamiento ■ Aplicación
3. Seleccione PHP personalizado app
4. Seleccione el tamaño del servidor y proveedor de nube
5. Introduzca los nombres de aplicaciones y servidores
6. Haga clic Lanzamiento

Paso 2: Configurar PHP

1. Ve. Aplicación ■ Ajustes de aplicaciones ■ Configuración de PHP
2. Actualización:

• Versión PHP: 8.3
• Límite de memoria: 512M
• Hora de ejecución máxima: 600
• Descargar Max Filesize: 500M
• Tamaño máximo del post: 500M

Paso 3: Activar PHP Funciones

1. Ve. Servidor ■ Ajustes " Paquetes ■ Avances
2. Encontrar PHP FPM Ajustes
3. Eliminar las funciones deshabilitadas según sea necesario

Paso 4: Acceso SSH

1. Ve. Servidor ■ Credenciales maestras
2. Nota SSH detalles
3. Conectar a través de SSH para instalar FFmpeg:

sudo apt install ffmpeg -y

Paso 5: Cargar archivos

1. Ve. Aplicación ■ Detalles de acceso
2. Nota SFTP credenciales
3. Cargar archivos a través de SFTP publichtml/

Paso 6: Configurar Cron

1. Ve. Aplicación ■ Cron Job Management
2. Añadir nuevo cron:

Cuadro:

• Comando: php ~/publichtml/ct/admin/cron/sitecron.php

Verificación posterior a la fase

Después de completar la configuración en cualquier plataforma, verifique estos elementos:

1. PHP Configuration Check

Navegue a su sitio y crear un archivo de prueba:

Verificar:

• [ ] Versión PHP 8.0+
• [ ] Extensiones requeridas cargadas
• límite de memoria 256M+
• Hora de ejecución máxima 300+

Eliminar este archivo después de comprobar!

2. FFmpeg Check

ffmpeg -version
ffprobe -version

3. Cron Check

Después de unos minutos:

tail -f /path/to/ct/logs/cron/sitecron.log

Debería ver actividad regular.

4. Verificación de permisos

ls -la /path/to/ct/logs/
ls -la /path/to/ct/uploads/

El servidor web debe poseer estos directorios.

5. Corre Installer

Navigate a https://yourdomain.com/install/ e instalación completa.

Solución de problemas de configuración común

"exec() ha sido deshabilitado" Error

Errores "Permiso negado"

chown -R www-data:www-data /path/to/ct/

chmod -R 775 /path/to/ct/logs /path/to/ct/uploads

Cron Job no corre

# Check cron is running

systemctl status cron

grep CRON /var/log/syslog

Prueba manualmente

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

500 Error de servidor interno

API Returns 404

location /ct/api/v1 {

    tryfiles $uri $uri/ /ct/api/v1/index.php?$querystring;

}

Documentación relacionada

• Guía de necesidades - Requisitos completos del sistema
• Guía de bienvenida - Comenzar vista general
• Guía de instalación - Instalación paso a paso
• Ajustes Centro de Control - Configuración maestra

Cambio

Guía de configuración de servidores comunes