Cómo instalar Matomo Web Analytics con Nginx en FreeBSD 12.0
Matomo(antes Piwik) es una aplicación de análisis web , gratuita y de código abierto, desarrollada por un equipo de desarrolladores internacionales, que se ejecuta en un servidor web PHP/MySQL. Hace un seguimiento de las visitas en línea a uno o más sitios web y muestra informes sobre estas visitas para su análisis. Puedes considerarlo como una alternativa a Google Analytics. Matomo es de código abierto y su código está disponible públicamente en Github. Algunas de las funciones que tiene son: pruebas A/B, mapas de calor, embudos, API de seguimiento e informes, Google AdWords, Facebook Ads, Bing Ads, coste por clic (CPC), etc. Este tutorial te mostrará cómo instalar Matomo en un sistema FreeBSD 12.0 utilizando Nginx como servidor web y aseguraremos el sitio web con un certificado SSL de Let’s Encrypt.
Requisitos
Para ejecutar Matomo (Piwik) en tu sistema FreeBSD 12.0 necesitarás un par de cosas:
- Un servidor web como Apache, Nginx, IIS.
- La versión de PHP 5.5.9 o superior con las extensiones pdo y pdo_mysql o mysqli, gd, xml, curl y mbsting. Se recomienda PHP 7+.
- MySQL versión 5.5 o superior, o la versión equivalente de MariaDB. Se recomienda MySQL 5.7+.
Requisitos previos
- Un sistema operativo con FreeBSD 12.0.
- Un usuario no root con privilegios sudo.
Pasos iniciales
Comprueba tu versión de FreeBSD:
uname -ro # FreeBSD 12.0-RELEASE
Configura la zona horaria:
tzsetup
Actualiza los paquetes de tu sistema operativo (software). Este es un primer paso importante porque asegura que tienes las últimas actualizaciones y correcciones de seguridad de los paquetes de software por defecto de tu sistema operativo:
freebsd-update fetch install pkg update && pkg upgrade -y
Instala algunos paquetes esenciales que son necesarios para la administración básica del sistema operativo FreeBSD 12.0:
pkg install -y sudo vim unzip wget bash
Paso 1 – Instalar MySQL y crear una base de datos para Matomo
Matomo es compatible con las bases de datos MySQL y MariaDB. En este tutorial, utilizaremos MySQL como servidor de bases de datos.
Instala el servidor de bases de datos MySQL:
sudo pkg install -y mysql57-server
Comprueba la versión de MySQL:
mysql --version # mysql Ver 14.14 Distrib 5.7.26, for FreeBSD12.0 (amd64) using EditLine wrapper
Habilita e inicia el servicio MySQL:
sudo sysrc mysql_enable="yes" sudo service mysql-server start
Ejecuta el script mysql_secure installation script para mejorar la seguridad de MySQL y establecer la contraseña para el root usuario:
sudo mysql_secure_installation
Responde a cada una de las preguntas:
Would you like to setup VALIDATE PASSWORD plugin? N 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 MySQL como usuario root:
sudo mysql -u root -p # Enter password
Crea una base de datos MySQL vacía y un usuario para Matomo y recuerda las credenciales:
CREATE DATABASE dbname; CREATE USER 'username'@'localhost' IDENTIFIED BY 'password'; GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password'; FLUSH PRIVILEGES;
Sal de MySQL:
exit
Sustituye dbname, username y password por tus propios nombres.
Paso 2 – Instalar PHP y las extensiones PHP necesarias
Instala PHP, así como las extensiones PHP necesarias:
sudo pkg install -y php73 php73-ctype php73-curl php73-dom php73-hash php73-iconv php73-gd php73-json php73-mbstring php73-openssl php73-session php73-simplexml php73-xml php73-zip php73-zlib php73-pdo php73-pdo_mysql php73-mysqli php73-filter php73-ftp php73-tokenizer php73-calendar php73-pecl-APCu php73-opcache
Comprueba la versión de PHP:
php --version
# PHP 7.3.7 (cli) (built: Jul 25 2019 01:28:53) ( NTS ) # Copyright (c) 1997-2018 The PHP Group # Zend Engine v3.3.7, Copyright (c) 1998-2018 Zend Technologies # with Zend OPcache v7.3.7, Copyright (c) 1999-2018, by Zend Technologies
Habilita e inicia el servicio PHP-FPM:
sudo sysrc php_fpm_enable=yes sudo service php-fpm start
Podemos pasar al siguiente paso, que es obtener los certificados SSL gratuitos de Let’s Encrypt CA.
Paso 3 – Instalar el cliente acme.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 pkg install -y acme.sh
Comprueba la versión de Acme.sh:
acme.sh --version # v2.8.2
Obtén certificados RSA y ECC/ECDSA para tu dominio/nombre de host:
# RSA sudo acme.sh --issue --standalone --home /etc/letsencrypt -d example.com --keylength 2048 # ECDSA sudo acme.sh --issue --standalone --home /etc/letsencrypt -d example.com --keylength ec-256
Después de ejecutar los comandos anteriores, tus certificados y claves estarán en:
- Para RSA: directorio
/etc/letsencrypt/example.com. - Para ECC/ECDSA: directorio
/etc/letsencrypt/example.com_ecc.
Paso 3 – Instalar NGINX y configurar NGINX para Matomo
Matomo puede funcionar bien con muchos programas populares de servidores web. En este tutorial, hemos seleccionado Nginx.
Descarga e instala la última versión principal de Nginx desde el repositorio de FreeBSD:
sudo pkg install -y nginx-devel
Comprueba la versión de Nginx:
nginx -v # nginx version: nginx/1.17.2
Habilita e inicia Nginx:
sudo sysrc nginx_enable=yes sudo service nginx start
Configura Nginx para Matomo ejecutando:
sudo vim /usr/local/etc/nginx/matomo.conf
Y rellena el archivo con la siguiente configuración:
server {
listen [::]:443 ssl;
listen 443 ssl;
listen [::]:80;
listen 80;
ssl_certificate /etc/letsencrypt/example.com/fullchain.cer;
ssl_certificate_key /etc/letsencrypt/example.com/example.com.key;
ssl_certificate /etc/letsencrypt/example.com_ecc/fullchain.cer;
ssl_certificate_key /etc/letsencrypt/example.com_ecc/example.com.key;
server_name example.com;
root /usr/local/www/matomo;
index index.php;
location ~ ^/(index|matomo|piwik|js/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;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
fastcgi_param HTTP_PROXY "";
fastcgi_pass 127.0.0.1:9000;
}
location = /plugins/HeatmapSessionRecording/configs.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;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
fastcgi_param HTTP_PROXY "";
fastcgi_pass 127.0.0.1:9000;
}
location ~* ^.+\.php$ {
deny all;
return 403;
}
location / {
try_files $uri $uri/ =404;
}
location ~ /(config|tmp|core|lang) {
deny all;
return 403;
}
location ~ /\.ht {
deny all;
return 403;
}
location ~ \.(gif|ico|jpg|png|svg|js|css|htm|html|mp3|mp4|wav|ogg|avi|ttf|eot|woff|woff2|json)$ {
allow all;
expires 1h;
add_header Pragma public;
add_header Cache-Control "public";
}
location ~ /(libs|vendor|plugins|misc/user) {
deny all;
return 403;
}
location ~/(.*\.md|LEGALNOTICE|LICENSE) {
default_type text/plain;
}
}NOTA: Para una configuración completa y lista para producción de Nginx para Matomo, visita https://github.com/matomo-org/matomo-nginx.
Ejecuta sudo vim /usr/local/etc/nginx/nginx.conf y añade la siguiente línea al bloque http {} para incluir la configuración de Matomo.
include matomo.conf;Comprueba que la configuración de Nginx no tenga errores de sintaxis:
sudo nginx -t
Recarga el servicio Nginx:
sudo service nginx reload
Paso 4 – Instalar Matomo Analytics
Navega al directorio /usr/local/www:
cd /usr/local/www/
Descarga la última versión de Matomo a través de wget y descomprímela:
sudo wget https://builds.matomo.org/matomo.zip && sudo unzip matomo.zip
Elimina el archivo matomo.zip descargado:
sudo rm matomo.zip
Cambia la propiedad del directorio/usr/local/www/matomo al usuariowww :
sudo chown -R www:www /usr/local/www/matomo
Paso 5 – Completa la configuración de Matomo Analytics
Abre tu sitio en un navegador web y sigue el asistente de instalación web de Matomo.
En primer lugar, debería aparecer el mensaje de bienvenida de Matomo. Haz clic en el botón «Siguiente «:
Después, verás una página de «Comprobación del sistema». Si falta algo, verás un aviso. Si todo está marcado con una marca de verificación verde, haz clic en el botón » Siguiente » para pasar al siguiente paso:
A continuación, rellena los datos de la base de datos y haz clic en el botón«Siguiente». y haz clic en el botón «Siguiente»:
Si todo ha ido bien con la configuración de la base de datos deberías ver elmensaje «¡Tablas creadas con éxito!
Crea la cuenta de superusuario de Matomo y haz clic en el botón «Siguiente» y haz clic en el botón «Siguiente»:
A continuación, configura el primer sitio web que quieras rastrear y analizar con Matomo. Más adelante, puedes añadir más sitios para rastrear con Matomo:
A continuación, se te proporcionará el código de seguimiento de JavaScript para tu sitio que debes añadir para comenzar el seguimiento.
A continuación, deberías ver que la instalación de Matomo se ha completado.
¡Enhorabuena! Tu instalación de Matomo se ha completado.