Come installare MediaWiki su Debian 12

MediaWiki è un software wiki open-source utilizzato dai più grandi siti wiki come Wikipedia e Wikimedia. È un software wiki gratuito che può essere utilizzato come piattaforma di collaborazione e documentazione. È un’implementazione wiki potente, scalabile e ricca di funzionalità.

Questo tutorial ti mostrerà come installare MediaWiki con il LAMP Stack (Apache, MariaDB e PHP) sul server Debian 12. Inoltre, ti mostreremo anche come proteggere MediaWiki con HTTPS tramite Certbot e Letsencrypt.

Prerequisiti

Prima di iniziare, assicurati di avere i seguenti requisiti:

• Un server Debian 12.
• Un utente non root con privilegi di amministratore.
• Un nome di dominio puntato a un indirizzo IP del server.

Installazione del LAMP Stack

MediaWiki è un software open-source basato su PHP con MySQL/MariaDB come archivio dati. Attualmente, l’ultima versione stabile di MediaWiki (1.41) richiede almeno PHP 7.3.4 o superiore e MariaDB 10.3.0. Per quanto riguarda i server web, puoi utilizzare Apache o Nginx.

In questa sezione, installerai il LAMP Stack (Apache, MariaDB e PHP) che sarà utilizzato per eseguire la tua installazione di MediaWiki.

Per prima cosa, aggiorna il tuo repository Debian con il seguente comando.

sudo apt update

Una volta aggiornato il repository, installa le dipendenze del LAMP Stack con il comando qui sotto. Inserisci Y per confermare l’installazione.

sudo apt install apache2 mariadb-server imagemagick libapache2-mod-php php php-common php-intl php-xml php-curl php-gd php-mbstring php-mysql php-apcu

Una volta completata l’installazione, verifica il servizio Apache e MariaDB per assicurarti che entrambi i servizi siano in esecuzione.

Verifica il server web Apache con il comando qui sotto. Se ottieni l’output abilitato, questo conferma che Apache è abilitato e si avvierà automaticamente all’avvio. Quando in esecuzione, vedrai l’output attivo (in esecuzione).

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Successivamente, verifica il server di database MariaDB con il comando qui sotto. L’output dovrebbe essere simile, un output abilitato conferma che MariaDB è abilitato, e attivo (in esecuzione) conferma che MariaDB è in esecuzione.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Infine, verifica la versione di PHP e l’elenco dei moduli abilitati con il comando qui sotto. Vedrai PHP 8.2 installato sul tuo server Debian.

php -v  
php -m

Configurazione di PHP

Dopo aver installato il LAMP Stack, configurerai la tua installazione di PHP modificando il file php.ini e cambiando alcuni parametri predefiniti per MediaWiki.

Per configurare PHP, apri la configurazione PHP /etc/php/8.2/apache2/php.ini con il seguente comando dell’editor nano.

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

Cambia la configurazione predefinita con la seguente e assicurati di regolare sia date.timezone che memory_limit con il tuo ambiente attuale.

date.timezone = Europe/Amsterdam  
upload_max_filesize = 80M  
memory_limit = 512M  
max_execution_time = 360

Salva ed esci dal file.

Ora esegui il comando qui sotto per riavviare il servizio Apache e applicare le tue modifiche.

sudo systemctl restart apache2

Configurazione del server MariaDB

Con PHP configurato, il passo successivo è proteggere il server MariaDB e creare un nuovo database e utente per MediaWiki. In questo esempio, proteggerai il server MariaDB utilizzando il comando mariadb-secure-installation e creerai un nuovo database e utente tramite il client MariaDB.

Per proteggere l’installazione del server MariaDB, esegui il comando mariadb-secure-installation qui sotto.

sudo mariadb-secure-installation

Ora inserisci Y per accettare o n per rifiutare la nuova configurazione sul server MariaDB:

• L’installazione predefinita di MariaDB viene fornita senza password. Premi INVIO quando ti viene chiesta la password.
• Ora inserisci Y per impostare la password di root di MariaDB. Quindi, digita la nuova password per MariaDB e ripeti la password.
• Inserisci Y per rimuovere l’utente anonimo dalla tua installazione di MariaDB.
• Inserisci di nuovo Y quando ti viene chiesto di disabilitare il login remoto per l’utente root di MariaDB.
• Inserisci Y per rimuovere il database di test predefinito dalla tua MariaDB.
• Infine, inserisci Y per ricaricare i privilegi delle tabelle e applicare le nuove modifiche.

Dopo aver protetto il deployment del server MariaDB, accedi al server MariaDB utilizzando il comando mariadb qui sotto. Inserisci la tua password di root di MariaDB quando ti viene chiesto.

sudo mariadb -u root -p

Ora esegui le seguenti query per creare un nuovo database MariaDB e un utente per MediaWiki. In questo esempio, creerai un nuovo database mediawikidb, un utente mediawiki con la password mediawikipassdb. Puoi regolare quanto segue con le tue credenziali.

CREATE DATABASE mediawikidb;  
CREATE USER mediawiki@localhost IDENTIFIED BY 'mediawikipassdb';  
GRANT ALL ON mediawikidb.* TO mediawiki@localhost WITH GRANT OPTION;  
FLUSH PRIVILEGES;

Successivamente, esegui la seguente query per verificare i privilegi dell’utente MariaDB mediawiki. Assicurati che l’utente mediawiki possa accedere al database mediawikidb.

SHOW GRANTS FOR mediawiki@localhost;

Infine, digita quit per uscire da MariaDB quando hai finito.

Download del codice sorgente di MediaWiki

Ora che le dipendenze sono installate e configurate, puoi installare MediaWiki. Ci sono più versioni di MediaWiki: stabile, legacy e LTS. In questo caso, installerai l’ultima versione stabile di MediaWiki 1.41.

Spostati nella directory /var/www e scarica il codice sorgente di MediaWiki tramite il comando wget qui sotto. Assicurati di visitare la pagina di download di MediaWiki per ottenere l’ultima versione.

cd /var/www/  
wget https://releases.wikimedia.org/mediawiki/1.41/mediawiki-1.41.0.tar.gz

Una volta scaricato, estrai il codice sorgente con il comando qui sotto. Quindi, rinomina la directory estratta in mediawiki. Così, la directory DocumentRoot per MediaWiki sarà in /var/www/mediawiki.

tar -xvzf mediawiki-*.tar.gz  
mv mediawiki-*/ mediawiki/

Infine, cambia la proprietà della directory /var/www/mediawiki all’utente www-data e cambia i permessi in 0755.

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

Configurazione dell’host virtuale Apache

Quindi ora hai scaricato il codice sorgente di MediaWiki, creerai un nuovo file di configurazione dell’host virtuale Apache per eseguire MediaWiki in questa sezione. Assicurati di avere il nome di dominio puntato al tuo indirizzo IP del server. Per la produzione, acquista il dominio pubblico, oppure puoi anche utilizzare il nome di dominio locale.

Prima di iniziare, abilita il modulo di riscrittura di Apache con il comando qui sotto.

sudo a2enmod rewrite

Ora crea una nuova configurazione dell’host virtuale Apache /etc/apache2/sites-available/mediawiki.conf con il comando dell’editor nano qui sotto.

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

Inserisci la seguente configurazione e assicurati di cambiare l’opzione ServerName con il tuo nome di dominio e il percorso di entrambi i log di accesso e di errore.

  
  
 ServerName wiki.howtoforge.local  
  
 ServerAdmin [email protected]  
 DocumentRoot /var/www/mediawiki  
  
 ErrorLog /var/log/apache2/wiki.howtoforge.local_error.log  
 CustomLog /var/log/apache2/wiki.howtoforge.local_access.log combined  
  
   
 Options FollowSymlinks  
 AllowOverride All  
 Require all granted  
   
  

Salva il file ed esci dall’editor.

Successivamente, attiva il file dell’host virtuale mediawiki.conf e verifica la sintassi di Apache con il comando qui sotto. Se hai una sintassi Apache corretta, vedrai un output come Syntax OK.

sudo a2ensite mediawiki.conf  
sudo apachectl configtest

Infine, riavvia il server web Apache per applicare il nuovo host virtuale per MediaWiki. Una volta riavviato, la tua installazione di MediaWiki dovrebbe essere pronta.

sudo systemctl restart apache2

Proteggere MediaWiki con HTTPS

Ora che hai creato una configurazione dell’host virtuale Apache per MediaWiki, proteggiamo la tua installazione con HTTPS tramite Certbot e letsencrypt. Questo si applica solo se stai utilizzando il dominio pubblico, ma se stai utilizzando il dominio locale, puoi generare certificati autofirmati e applicare l’HTTPS manualmente.

Installa Certbot e il plugin Certbot Apache con il comando qui sotto. Digita Y per confermare l’installazione.

sudo apt install certbot python3-certbot-apache

Una volta completata l’installazione, esegui il comando certbot qui sotto per generare certificati SSL/TLS per il tuo nome di dominio MediaWiki. Assicurati di cambiare il nome di dominio e l’indirizzo email con le tue informazioni.

sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d wiki.howtoforge.local

Dopo che il processo è terminato, il tuo certificato sarà disponibile nella directory /etc/letsencrypt/live/domain.com, mentre il tuo host virtuale sarà anche configurato con HTTPS.

Installazione di MediaWiki

Apri il tuo browser web preferito e visita il tuo nome di dominio, come http://wiki.howtoforge.local/. Se tutto va bene, dovresti vedere la pagina di benvenuto di MediaWiki. Clicca sul link configura il wiki.

Seleziona la lingua predefinita per il tuo MediaWiki e clicca su Continua.

Per i controlli ambientali, assicurati che il tuo sistema soddisfi i requisiti di MediaWiki. Quindi, clicca di nuovo su Continua.

Seleziona il database come MariaDB e inserisci il tuo nome, utente e password. Quindi, clicca su Continua per procedere.

Successivamente, inserisci il tuo nome utente admin, email e password per MediaWiki, quindi clicca su Continua.

Per le impostazioni aggiuntive, seleziona il tema predefinito che desideri utilizzare, quindi clicca su Continua per procedere con l’installazione.

Clicca su Continua per confermare l’installazione di MediaWiki.

Una volta completata l’installazione, il file LocalSettings.php verrà automaticamente scaricato sul tuo computer locale e vedrai un’istruzione per caricare il file nella directory di installazione di MediaWiki.

Torna al tuo terminale e esegui il comando qui sotto per creare un nuovo file LocalSettings.php.

sudo -u www-data nano /var/www/mediawiki/LocalSettings.php

Apri il file LocalSettings.php che hai scaricato e copia e incolla il codice PHP nel tuo server. Quindi, salva il file ed esci.

Torna al tuo browser web e clicca sul link per entrare nel wiki. Vedrai la pagina principale predefinita di MediaWiki che hai installato.

Conclusione

Congratulazioni! Hai ora installato con successo MediaWiki sul server Debian 12. Hai installato MediaWiki con il LAMP Stack (Apache, MariaDB e PHP) e protetto MediaWiki con HTTPS da Letsencrypt.