Cómo instalar Vanilla Forum en CentOS 7
Vanilla es un foro de discusión gratuito y de código abierto escrito en PHP. El software del Foro Vanilla se distribuye bajo la licencia GNU GPL2. Su código fuente está disponible a través de Github. Tiene un rico sistema de complementos que puedes aprovechar para añadir funciones personalizadas a tu foro Vanilla.El contenido de Vanilla Forum se puede escribir utilizando el lenguaje Markdown.En este tutorial, vamos a pasar por la instalación y configuración de Vanilla Forum en un sistema CentOS 7 utilizando Nginx como servidor web, MySQL como servidor de base de datos, y opcionalmente puedes asegurar la capa de transporte utilizando el cliente acme.sh y la autoridad de certificados Let’s Encrypt para añadir soporte SSL.
Requisitos
Vanilla requiere un servidor con PHP, MySQL y software de servidor web (como Apache o Nginx). Probablemente necesitarás tener un dominio y tenerlo ya configurado en tu servidor con DNS si quieres instalarlo en un servidor de producción, pero si no es así, no necesitas un dominio.
Los requisitos mínimosde Vanilla Forumson
- PHP versión 7.0 o más reciente.
- Extensiones PHP mbstring, cURL, GD y PDO, MySQLi,OpenSSL.
- MySQL versión 5.0 o más reciente (o el equivalente a Percona/MariaDB).
- Software de servidor web (Nginx, Apache…).
- Modo estricto de MySQL desactivado.
Vanilla Forum recomienda encarecidamente:
- PHP versión 7.2 o más reciente.
- Extensiones PHP mbstring, cURL, GD y PDO, MySQLi,OpenSSL.
- MySQL versión 5.7 o más reciente (o el equivalente dePercona/MariaDB).
- Software de servidor web (Nginx, Apache…).
- Encriptación SSL.
NOTA: PHP 7.0 ha llegado al final de su vida útil y ya no recibirá parches de seguridad, por lo que se recomienda encarecidamente utilizar versiones más recientes de PHP. ¡Elsoportede Vanillapara PHP 7.0 terminará pronto!
Requisitos previos
- Un sistema operativo con CentOS 7.
- Un usuario no root con privilegios sudo.
Pasos iniciales
Comprueba tu versión de CentOS:
cat /etc/centos-release
# CentOS Linux release 7.6.1810 (Core)
Configura la zona horaria:
timedatectl list-timezones
sudo timedatectl set-timezone 'Region/City'
Actualiza los paquetes de tu sistema operativo (software). Este es un primer paso importante porque garantiza que tienes las últimas actualizaciones y correcciones de seguridad de los paquetes de software por defecto de tu sistema operativo:
sudo yum update -y
Instala algunos paquetes esenciales que son necesarios para la administración básica del sistema operativo CentOS:
sudo yum install -y curl wget vim git unzip socat bash-completion epel-release
Paso 1 – Instalar PHP y las extensiones PHP necesarias
Instala el repositorio YUM de Webtatic:
sudo rpm -Uvh https://mirror.webtatic.com/yum/el7/webtatic-release.rpm
Instala PHP, así como las extensiones PHP necesarias:
sudo yum install -y php72w php72w-cli php72w-fpm php72w-common php72w-mbstring php72w-curl php72w-gd php72w-mysql
Para mostrar el PHP compilado en módulos, puedes ejecutar:
php -m
ctype
curl
exif
fileinfo
. . .
. . .
Comprobar la versión de PHP:
php --version
# PHP 7.2.14 (cli) (built: Jan 12 2019 12:47:33) ( NTS )
# Copyright (c) 1997-2018 The PHP Group
# Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
Iniciar y habilitar el servicio PHP-FPM:
sudo systemctl start php-fpm.service
sudo systemctl enable php-fpm.service
Podemos pasar al siguiente paso, que es la instalación y configuración de la base de datos.
Paso 2 – Instalar MariaDB y crear una base de datos para Vanilla Forum
Vanilla Forum admite bases de datos MySQL, MariaDB y Percona. En este tutorial, utilizaremos MariaDB como servidor de base de datos. Dado que los repositorios por defecto de CentOS 7 contienen una versión muy antigua de MariaDB que no es compatible con Vanilla Forum, tendremos que utilizar el repo oficial de MariaDB para instalar una versión más reciente.
Crea el repositorio YUM de MariaDB 10.2 para CentOS:
sudo vim /etc/yum.repos.d/MariaDB.repo
Copia y pega el siguiente texto en él:
# MariaDB 10.2 CentOS repository list - created 2017-12-11 23:19 UTC
# http://downloads.mariadb.org/mariadb/repositories/
[mariadb]
name=MariaDB
baseurl=https://yum.mariadb.org/10.2/centos7-amd64
gpgkey=https://yum.mariadb.org/RPM-GPG-KEY-MariaDB
gpgcheck=1
Una vez colocado el archivo, instala MariaDB ejecutando:
sudo yum install -y MariaDB-server MariaDB-client
Comprueba la versión de MariaDB:
mysql --version
# mysql Ver 15.1 Distrib 10.2.21-MariaDB, for Linux (x86_64) using readline 5.1
Inicia y activa el servicio MariaDB:
sudo systemctl start mariadb.service
sudo systemctl enable mariadb.service
Ejecutamysql_secure installation
script para mejorar la seguridad de MariaDB y establecer la contraseña de MariaDBroot
:
sudo mysql_secure_installation
Responde a cada una de las preguntas:
Enter current password for root (enter for none): Press Enter
Set root password? [Y/n] Y
New password: your_secure_password
Re-enter new password: your_secure_password
Remove anonymous users? [Y/n] Y
Disallow root login remotely? [Y/n] Y
Remove test database and access to it? [Y/n] Y
Reload privilege tables now? [Y/n] Y
Conéctate al shell de MariaDB como usuario root:
sudo mysql -u root -p
# Enter password
Crea una base de datos MariaDB vacía y un usuario para Vanilla Forum y recuerda las credenciales:
MariaDB [(none)]> CREATE DATABASE dbname;
MariaDB [(none)]> GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
MariaDB [(none)]> FLUSH PRIVILEGES;
Sal de MariaDB:
MariaDB [(none)]> exit
Sustituyedbname
,username
ypassword
por tus propios nombres.
Paso 3 – Instalar el clienteacme.sh
y obtener el certificado Let’s Encrypt (opcional)
Asegurar tu sitio web con HTTPS no es necesario, pero es una buena práctica para asegurar el tráfico de tu sitio. Para obtener el certificado TLS de Let’s Encrypt utilizaremos el cliente acme.sh. Acme.sh es un software de shell unix puro para obtener certificados TLS de Let’s Encrypt con cero dependencias.
Descarga e instala acme.sh:
sudo su - root
git clone https://github.com/Neilpang/acme.sh.git
cd acme.sh
./acme.sh --install --accountemail [email protected]
source ~/.bashrc
cd ~
Comprueba la versión de acme.sh:
acme.sh --version
# v2.8.0
Obténcertificados RSAy ECC/ECDSA paratu dominio/nombre de host:
# RSA 2048
acme.sh --issue --standalone -d example.com --keylength 2048
# ECDSA
acme.sh --issue --standalone -d example.com --keylength ec-256
Si quieres certificados falsos para hacer pruebas, puedes añadir--staging
flage a los comandos anteriores.
Después de ejecutar los comandos anteriores, tuscertificados y claves estarán en:
- Para RSA:
/home/username/example.com
directorio. - Para ECC/ECDSA: directorio
/home/username/example.com_ecc
.
Para listar tus certificados emitidos puedes ejecutar:
acme.sh --list
Crea un directorio para almacenar tus certificados. Nosotros utilizaremos el directorio/etc/letsencrypt
.
mkdir -p /etc/letsecnrypt/example.com
sudo mkdir -p /etc/letsencrypt/example.com_ecc
Instala/copia los certificados en/etc/letsencryptdirectorio.
# RSA
acme.sh --install-cert -d example.com --cert-file /etc/letsencrypt/example.com/cert.pem --key-file /etc/letsencrypt/example.com/private.key --fullchain-file /etc/letsencrypt/example.com/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service"
# ECC/ECDSA
acme.sh --install-cert -d example.com --ecc --cert-file /etc/letsencrypt/example.com_ecc/cert.pem --key-file /etc/letsencrypt/example.com_ecc/private.key --fullchain-file /etc/letsencrypt/example.com_ecc/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service"
Todos los certificados se renovarán automáticamente cada 60 días.
Después de obtener los certificados sal del usuario root y vuelve al usuario sudo normal:
exit
Paso 4 – Instalar NGINX y configurar NGINX para Vanilla Forum
Vanilla Forum puede funcionar bien con muchos servidores web populares. En este tutorial, hemos seleccionado Nginx. Si prefieres el servidor web Apache en lugar de Nginx, visita https://docs.vanillaforums.com/developer/backend/server-apache/para obtener más información.
Descarga e instala Nginx desde el repositorio de CentOS:
sudo yum install -y nginx
Comprueba la versión de Nginx:
nginx -v
# nginx version: nginx/1.12.2
Inicia y activa el servicio Nginx:
sudo systemctl start nginx.service
sudo systemctl enable nginx.service
Configura Nginx para Vanilla ejecutando:
sudo vim /etc/nginx/conf.d/vanilla.conf
Y rellena el archivo con la siguiente configuración:
server { listen 80; listen 443 ssl http2; server_name forum.example.com; root /var/www/vanilla; index index.php; # RSA ssl_certificate /etc/letsencrypt/example.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/example.com/private.key; # ECC/ECDSA ssl_certificate /etc/letsencrypt/example.com_ecc/fullchain.pem; ssl_certificate_key /etc/letsencrypt/example.com_ecc/private.key; location ~* /\.git { deny all; return 403; } location /build/ { deny all; return 403; } location /cache/ { deny all; return 403; } location /cgi-bin/ { deny all; return 403; } location /uploads/import/ { deny all; return 403; } location /conf/ { deny all; return 403; } location /tests/ { deny all; return 403; } location /vendor/ { deny all; return 403; } location ~* ^/index\.php(/|$) { fastcgi_split_path_info ^(.+\.php)(/.+)$; try_files $fastcgi_script_name =404; set $path_info $fastcgi_path_info; fastcgi_param PATH_INFO $path_info; fastcgi_index index.php; include fastcgi.conf; fastcgi_param SCRIPT_NAME /index.php; fastcgi_param SCRIPT_FILENAME $realpath_root/index.php; fastcgi_param X_REWRITE 1; fastcgi_pass 127.0.0.1:9000; } location ~* \.php(/|$) { rewrite ^ /index.php$uri last; } location / { try_files $uri $uri/ @vanilla; } location @vanilla { rewrite ^ /index.php$uri last; } }
NOTA:Para una configuración completa y lista para producción de Nginx para Vanilla visitahttps://docs.vanillaforums.com/developer/backend/server-nginx/.
Comprueba que la configuración de Nginx no tenga errores de sintaxis:
sudo nginx -t
Recarga el servicio Nginx:
sudo systemctl reload nginx.service
Paso 5 – Instalar Vanilla Forum
Crea un directorio raíz de documentos en el que deba residir Vanilla Forum:
sudo mkdir -p /var/www/vanilla
Cambia la propiedad del directorio/var/www/vanilla
a {jour_user}
:
sudo chown -R {your_user}:{your_user} /var/www/vanilla
NOTA: Sustituye{jour_user}
por tunombre de usuario no root creado inicialmente.
Navega hasta el directorio raíz del documento:
cd /var/www/vanilla
Descarga el archivo zip de Vanilla Forum:
wget https://open.vanillaforums.com/get/vanilla-core-2.6.4.zip
Extrae y elimina el archivo zip de Vanilla:
unzip vanilla-core-2.6.4.zip
rm vanilla-core-2.6.4.zip
Proporciona la propiedad adecuada:
sudo chown -R nginx:nginx /var/www/vanilla
Ejecutasudo vim /etc/php-fpm.d/www.conf
y estableceel usuario y el grupo comonginx
. Inicialmente, estarán configurados comoapache:
sudo vim /etc/php-fpm.d/www.conf
# user = nginx
# group = nginx
Navega hasta la carpeta donde has subido Vanilla en tu navegador web ysigue las instrucciones que aparecen en pantalla.
Paso 6 – Completa la instalación y configuración del Foro Vanilla
Tras abrir tu sitio en un navegador web, deberías ser redirigido a la siguiente página:
Rellena la información requerida y haz clic en el botón«Continuar → » para finalizarla instalación y la configuración. Después debería aparecer la interfaz de administración de Vanilla Forum.