Cómo instalar MediaWiki con Nginx y Let’s Encrypt SSL en Ubuntu 20.04

MediaWiki es un software wiki de código abierto escrito en PHP. Te permite crear tu propio sitio web wiki autoalojado en el servidor. Es una de las plataformas wiki más populares debido a su simplicidad y personalización. Actualmente, es utilizada por muchas empresas para gestionar sus páginas wiki. Proporciona una herramienta versátil y gratuita para publicar contenidos en Internet.

En este tutorial, te mostraremos cómo instalar MediaWiki con el servidor web Nginx y Let’s Encrypt SSL en Ubuntu 20.04.

Requisitos previos

  • Un servidor con Ubuntu 20.04.
  • Un nombre de dominio válido apuntado con la IP de tu servidor.
  • Una contraseña de root configurada en el servidor.

Cómo empezar

En primer lugar, actualiza los paquetes del sistema a la versión actualizada ejecutando el siguiente comando:

apt-get update -y

Una vez actualizados todos los paquetes, puedes pasar al siguiente paso.

Instalar Nginx, MariaDB y PHP

MediaWiki requiere el servidor web Nginx, el servidor de base de datos MariaDB, PHP y otras extensiones. Puedes instalarlos todos con el siguiente comando:

apt-get install nginx mariadb-server php php-fpm php-mbstring php-xml php-json php-mysql php-curl php-intl php-gd php-mbstring texlive imagemagick unzip -y

Una vez instalados todos los paquetes, instala el Compositor con el siguiente comando:

apt-get install composer -y

A continuación, edita el archivo php.ini y cambia la configuración por defecto:

nano /etc/php/7.4/fpm/php.ini

Cambia las siguientes líneas:

memory_limit = 512M
post_max_size =32M
upload_max_filesize = 32M
date.timezone = Asia/Kolkata

Guarda y cierra el archivo y luego reinicia el PHP-FPM para aplicar los cambios:

systemctl restart php7.4-fpm

Una vez que hayas terminado, puedes pasar al siguiente paso.

Crear una base de datos MariaDB

MediaWiki utiliza MariaDB como base de datos, por lo que tendrás que crear una base de datos y un usuario para MediaWiki.

Primero, conéctate a MariaDB con el siguiente comando:

mysql

Una vez conectado, crea una base de datos y un usuario con el siguiente comando:

MariaDB [(none)]> CREATE DATABASE mediadb;
MariaDB [(none)]> GRANT ALL PRIVILEGES ON mediadb.* TO 'mediauser'@'localhost' IDENTIFIED BY 'password';

A continuación, vacía los privilegios y sal del MariaDB con el siguiente comando:

MariaDB [(none)]> FLUSH PRIVILEGES;
MariaDB [(none)]> EXIT;

Una vez que hayas terminado, puedes pasar al siguiente paso.

Descarga MediaWiki

Primero, ve al sitio web de MediaWiki y elige la última versión de MediaWiki. A continuación, ejecuta el siguiente comando para descargarlo en tu servidor:

wget https://releases.wikimedia.org/mediawiki/1.35/mediawiki-1.35.2.zip

Una vez completada la descarga, descomprime el archivo descargado con el siguiente comando:

unzip mediawiki-1.35.2.zip

A continuación, mueve el directorio extraído al directorio raíz de la web Nginx con el siguiente comando:

mv mediawiki-1.35.2 /var/www/html/mediawiki

A continuación, cambia el directorio a la MediaWiki e instala todas las dependencias de PHP con el siguiente comando:

cd /var/www/html/mediawiki
composer install --no-dev

Una vez instaladas todas las dependencias, establece el permiso y la propiedad adecuados con el siguiente comando:

chown -R www-data:www-data /var/www/html/mediawiki
chmod -R 755 /var/www/html/mediawiki

Una vez que hayas terminado, puedes pasar al siguiente paso.

Configurar Nginx para MediaWiki

A continuación, tendrás que crear un archivo de configuración del host virtual Nginx para MediaWiki. Puedes crearlo con el siguiente comando:

nano /etc/nginx/conf.d/wiki.conf

Añade las siguientes líneas:

server {
        listen 80;
        server_name wiki.example.com;

        root /var/www/html/mediawiki;
        index index.php;
   
        error_log /var/log/nginx/mediawiki.error;
        access_log /var/log/nginx/mediawiki.access;

        location / {
                try_files $uri $uri/ /index.php;
        }


        location ~ /\.ht {
          deny all;
         }

        location ~ \.php$ {
            fastcgi_pass unix:/run/php/php7.4-fpm.sock;
            fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
            include fastcgi_params;
            include snippets/fastcgi-php.conf;
        }
}

Guarda y cierra el archivo y luego verifica que Nginx no tenga ningún error de sintaxis con el siguiente comando:

nginx -t

Deberías ver la siguiente salida:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

A continuación, reinicia el servicio Nginx para aplicar los cambios:

systemctl restart nginx

También puedes verificar el estado del Nginx con el siguiente comando:

systemctl status nginx

Deberías ver la siguiente salida:

? nginx.service - A high performance web server and a reverse proxy server
     Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
     Active: active (running) since Wed 2021-06-02 05:06:48 UTC; 3s ago
       Docs: man:nginx(8)
    Process: 24594 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
    Process: 24605 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
   Main PID: 24606 (nginx)
      Tasks: 2 (limit: 2353)
     Memory: 2.8M
     CGroup: /system.slice/nginx.service
             ??24606 nginx: master process /usr/sbin/nginx -g daemon on; master_process on;
             ??24607 nginx: worker process

Jun 02 05:06:48 ubuntu2004 systemd[1]: Starting A high performance web server and a reverse proxy server...
Jun 02 05:06:48 ubuntu2004 systemd[1]: Started A high performance web server and a reverse proxy server.

Accede a la interfaz web de MediaWiki

Ahora, abre tu navegador web y escribe la URL http://wiki.example.com. Serás redirigido a la siguiente página:

MediaWiki

Ahora, haz clic en el botón de configurar el wiki. Deberías ver la siguiente página:

Selecciona el idioma

Aquí, elige el idioma de tu wiki y haz clic en el botón Continuar. Deberías ver la siguiente página:

Acepta la licencia

Ahora, haz clic en el botón Continuar. Deberías ver la siguiente página:

Configuración de la base de datos MySQL

Ahora, proporciona los detalles de tu base de datos y haz clic en el botón Continuar. Deberías ver la siguiente página:

Instalación de MediaWiki

Selecciona utilizar la misma cuenta que para la instalación y haz clic en el botón Continuar. Deberías ver la siguiente página:

Nombre Wiki

Ahora, proporciona el nombre de tu sitio wiki, el nombre de usuario y la contraseña. A continuación, haz clic en el botón Continuar. Deberías ver la siguiente página:

Inicia el procedimiento de instalación

Haz clic en el botón Continuar para iniciar la instalación. Deberías ver la siguiente página:

La instalación ha finalizado con éxito

Haz clic en el botón Continuar. Una vez finalizada la instalación, deberías ver la siguiente página:

Ajustes locales

Ahora, haz clic en el botón de descarga para descargar el archivo LocalSettings.php en tu sistema. A continuación, copia este archivo en tu servidor dentro del directorio raíz de MediaWiki y establece los permisos adecuados con el siguiente comando:

chown www-data:www-data /var/www/html/mediawiki/LocalSettings.php

A continuación, vuelve a tu navegador web y haz clic en entrar en tu wiki. Deberías ver el panel de control de MediaWiki en la siguiente página:

MediaWiki instalado

Asegura MediaWiki con Let’s Encrypt SSL

A continuación, tendrás que instalar el paquete cliente Certbot para instalar la gestión de Let’s Encrypt SSL.

Primero, instala el Certbot con el siguiente comando:

apt-get install python3-certbot-nginx -y

Una vez terminada la instalación, ejecuta el siguiente comando para instalar el SSL de Let’s Encrypt en tu sitio web:

certbot --nginx -d wiki.example.com

Se te pedirá que proporciones una dirección de correo electrónico válida y que aceptes las condiciones del servicio, como se muestra a continuación:

Saving debug log to /var/log/letsencrypt/letsencrypt.log
Plugins selected: Authenticator nginx, Installer nginx
Enter email address (used for urgent renewal and security notices) (Enter 'c' to
cancel): [email protected]

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Please read the Terms of Service at
https://letsencrypt.org/documents/LE-SA-v1.2-November-15-2017.pdf. You must
agree in order to register with the ACME server at
https://acme-v02.api.letsencrypt.org/directory
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(A)gree/(C)ancel: A

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Would you be willing to share your email address with the Electronic Frontier
Foundation, a founding partner of the Let's Encrypt project and the non-profit
organization that develops Certbot? We'd like to send you email about our work
encrypting the web, EFF news, campaigns, and ways to support digital freedom.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: Y
Obtaining a new certificate
Performing the following challenges:
http-01 challenge for wiki.example.com
Waiting for verification...
Cleaning up challenges
Deploying Certificate to VirtualHost /etc/nginx/conf.d/wiki.conf

A continuación, elige si quieres redirigir el tráfico HTTP a HTTPS como se muestra a continuación:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
1: No redirect - Make no further changes to the webserver configuration.
2: Redirect - Make all requests redirect to secure HTTPS access. Choose this for
new sites, or if you're confident your site works on HTTPS. You can undo this
change by editing your web server's configuration.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Select the appropriate number [1-2] then [enter] (press 'c' to cancel): 2

Escribe 2 y pulsa Enter para finalizar la instalación. Deberías ver el siguiente resultado:

Redirecting all traffic on port 80 to ssl in /etc/nginx/conf.d/wiki.conf

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Congratulations! You have successfully enabled https://wiki.example.com

You should test your configuration at:
https://www.ssllabs.com/ssltest/analyze.html?d=wiki.example.com
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

IMPORTANT NOTES:
 - Congratulations! Your certificate and chain have been saved at:
   /etc/letsencrypt/live/wiki.example.com/fullchain.pem
   Your key file has been saved at:
   /etc/letsencrypt/live/wiki.example.com/privkey.pem
   Your cert will expire on 2021-12-30. To obtain a new or tweaked
   version of this certificate in the future, simply run certbot again
   with the "certonly" option. To non-interactively renew *all* of
   your certificates, run "certbot renew"
 - Your account credentials have been saved in your Certbot
   configuration directory at /etc/letsencrypt. You should make a
   secure backup of this folder now. This configuration directory will
   also contain certificates and private keys obtained by Certbot so
   making regular backups of this folder is ideal.
 - If you like Certbot, please consider supporting our work by:

   Donating to ISRG / Let's Encrypt:   https://letsencrypt.org/donate
   Donating to EFF:                    https://eff.org/donate-le

 - We were unable to subscribe you the EFF mailing list because your
   e-mail address appears to be invalid. You can try again later by
   visiting https://act.eff.org.

Ahora, tu sitio web está protegido con Let’s Encrypt SSL. Puedes acceder a él de forma segura utilizando la URL https://wiki.example.com.

Conclusión

Enhorabuena! has instalado con éxito MediaWiki con Nginx y Let’s Encrypt SSL en Ubuntu 20.04. Ahora puedes alojar fácilmente tu propio sitio wiki con MediaWiki.

También te podría gustar...