Cómo instalar WonderCMS en Debian 12

WonderCMS es un sistema de gestión de contenido (CMS) ligero y de código abierto diseñado para la simplicidad y facilidad de uso. A diferencia de muchas otras plataformas CMS que requieren una configuración extensa o recursos pesados, WonderCMS opera en una única base de datos de archivo plano, lo que significa que no necesita un sistema de base de datos tradicional como MySQL. Esto lo hace extremadamente fácil de instalar y gestionar, a menudo requiriendo no más que subir los archivos del CMS a un servidor. A pesar de su pequeño tamaño, WonderCMS ofrece características esenciales como edición de contenido, opciones de SEO, personalización de temas y soporte de plugins, lo que lo convierte en una opción viable para los usuarios que desean una solución minimalista y directa para construir y gestionar sitios web.

En este tutorial, te mostraremos cómo instalar WonderCMS en un servidor Debian 12 con el servidor web Apache y PHP 8.x.

Requisitos previos

Asegúrate de tener lo siguiente antes de comenzar:

• Un servidor Debian 12.
• Un usuario no root con privilegios de administrador.
• Un nombre de dominio apuntando a una dirección IP del servidor.

Instalando Dependencias

WonderCMS es un sistema de gestión de contenido de código abierto escrito en PHP. Es un CMS plano, lo que significa que no requiere una base de datos como MySQL/MariaDB para instalar. Utiliza archivos de texto como base de datos.

En esta guía, instalarás WonderCMS con el servidor web Apache y PHP 8.2.

Antes de instalar paquetes, actualiza y refresca el repositorio de Debian utilizando el siguiente comando.

sudo apt update

Una vez actualizado, instala las dependencias para WonderCMS ejecutando el siguiente comando. WonderCMS es un CMS plano, no requiere una base de datos. Así que solo instalarás los paquetes del servidor web Apache y PHP.

sudo apt install apache2 php php-common php-mbstring php-curl php-zip unzip

Escribe y para confirmar la instalación.

Después de que la instalación esté completa, verifica el servicio de Apache con el siguiente comando. Apache debería estar en ejecución y habilitado por defecto.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

A continuación, puedes ver el servicio de Apache habilitado y en ejecución.

Por último, verifica la versión de PHP y habilita las extensiones con el siguiente comando.

php -m  
php -v

En la salida a continuación, puedes ver que PHP 8.2 está instalado.

Configurando PHP

Después de instalar las dependencias, necesitas configurar PHP para WonderCMS. Necesitarás modificar la configuración php.ini para el servidor web Apache y cambiar algunos de los ajustes predeterminados, como la zona horaria, el límite de memoria, el tiempo de ejecución y el tamaño máximo de carga de archivos.

Abre la configuración php.ini para el servidor web Apache utilizando el siguiente comando del editor nano.

sudo nano /etc/php/8.2/apache2/php.ini

Cambia la configuración predeterminada de PHP como sigue - Asegúrate de ajustar la zona horaria y memory_limit con tu entorno de servidor actual.

date.timezone = "Europe/Amsterdam"  
memory_limit = 512M  
  
upload_max_filesize = 128MB  
post_max_size = 128MB  
  
max_execution_time = 300  
max_input_vars = 5000

Guarda y cierra el archivo cuando termines.

Ahora reinicia el servicio de Apache para aplicar tu modificación en PHP.

sudo systemctl restart apache2

Configurando el Firewall

En esta guía, ejecutarás WonderCMS con un firewall habilitado. En este ejemplo, utilizarás UFW. Así que ahora necesitas instalar UFW y abrir puertos para los servicios SSH, HTTP y HTTPS.

Instala UFW en tu servidor Debian con el siguiente comando. Escribe y para confirmar y proceder.

sudo apt install ufw

Una vez que la instalación esté completa, habilita el perfil OpenSSH para abrir el puerto 22 y el perfil “WWW Full” para abrir ambos puertos HTTP y HTTPS.

sudo ufw allow OpenSSH  
sudo ufw allow "WWW Full"

Ahora ejecuta el siguiente comando para iniciar y habilitar UFW. Escribe y para confirmar, y luego UFW debería estar en ejecución y habilitado.

sudo ufw enable

Por último, verifica el estado de UFW utilizando el siguiente comando. Ambos perfiles OpenSSH y “WWW Full” están habilitados en UFW.

sudo ufw status

Descargando el Código Fuente de WonderCMS

En esta sección, descargarás el código fuente de WonderCMS y configurarás el directorio de raíz del documento con los permisos y la propiedad adecuados. Antes de comenzar, asegúrate de visitar la página de GitHub de WonderCMS y obtener el último enlace de descarga.

Ve al directorio /var/www y descarga el código fuente de WonderCMS utilizando el comando wget a continuación.

cd /var/www/  
wget https://github.com/WonderCMS/wondercms/releases/download/3.4.3/wondercms-343.zip

Una vez descargado, extrae el código fuente de WonderCMS al directorio /var/www/wondercms utilizando el comando unzip.

unzip wondercms-343.zip -d /var/www/wondercms

Por último, cambia la propiedad del directorio /var/www/wondercms al usuario www-data. Con esto, permites que Apache lea, escriba y ejecute en el directorio raíz del documento de WonderCMS.

sudo chown -R www-data:www-data /var/www/wondercms  
sudo chmod -R 755 /var/www/wondercms

Configurando el Host Virtual de Apache

En este ejemplo, ejecutarás WonderCMS con Apache, así que necesitas crear la configuración del host virtual para eso. Asegúrate de que tu nombre de dominio apunte a la dirección IP de tu servidor Debian.

Primero, utiliza el siguiente comando para habilitar el módulo de reescritura en Apache. WonderCMS requiere que mod_rewrite esté habilitado.

sudo a2enmod rewrite

Una vez habilitado, crea una nueva configuración de host virtual /etc/apache2/sites-available/wondercms.conf utilizando el comando del editor nano.

sudo nano /etc/apache2/sites-available/wondercms.conf

Inserta la siguiente configuración. Asegúrate de cambiar el nombre de dominio, la ruta del directorio raíz del documento y los archivos de registro con tu información.

  
ServerName cms.howtoforge.local  
DirectoryIndex index.php  
DocumentRoot /var/www/wondercms  
Redirect /wondercms/loginURL /loginURL  
  
ErrorLog /var/log/apache2/cms.howtoforge.local-error.log  
CustomLog /var/log/apache2/cms.howtoforge.local-access.log combined  
  
  
Options FollowSymLinks  
AllowOverride All  
Require all granted  
  
  

Guarda y cierra el archivo cuando termines.

A continuación, ejecuta el siguiente comando para habilitar el archivo de host virtual wondercms.conf. Luego, verifica Apache y asegúrate de que tienes la sintaxis correcta.

sudo a2ensite wondercms.conf  
sudo apachectl configtest

Deberías obtener una salida de Sintaxis OK si tienes la sintaxis de Apache correcta.

Por último, ejecuta el siguiente comando para reiniciar el servicio de Apache y aplicar tus cambios. Con esto, tu instalación de WonderCMS debería estar lista.

sudo systemctl restart apache2

Asegurando WonderCMS con Letsencrypt

Una vez que configures el host virtual de Apache, asegura tu instalación de WonderCMS con HTTPS. En este caso, utilizarás Certbot y Letsencrypt.

Puedes generar certificados autofirmados para nombres de dominio locales o redes internas para asegurar tu instalación de WonderCMS.

Instala Certbot y el plugin de Certbot para Apache utilizando el siguiente comando. Escribe y para confirmar la instalación.

sudo apt install certbot python3-certbot-apache

Una vez que la instalación esté completa, genera certificados SSL para tu nombre de dominio de WonderCMS. Además, asegúrate de cambiar el nombre de dominio y la dirección de correo electrónico para que coincidan con tu información.

sudo certbot --apache --agree-tos --no-eff-email --redirect --hsts --staple-oscp --email [email protected] -d cms.howtoforge.local

Una vez que el proceso esté terminado, tu certificado debería estar disponible en el directorio /etc/letsencrypt/live/howtoforge.local. Tu instalación de WonderCMS debería estar automáticamente asegurada con HTTPS.

Accediendo a la Instalación de WonderCMS

Abre el navegador web y visita tu nombre de dominio de WonderCMS, como https://howtoforge.local/. En la página de inicio de WonderCMS, deberías ver la contraseña generada. Copia la contraseña y guárdala en un lugar seguro.

Conclusión

¡Felicidades! Has instalado con éxito WonderCMS en el servidor Debian 12, junto con un servidor web Apache y PHP 8.2. También has asegurado WonderCMS con UFW y certificados SSL de Letsencrypt.