Como Instalar MediaWiki no Debian 12

MediaWiki é um software de wiki de código aberto usado pelos maiores sites de wiki, como Wikipedia e Wikimedia. É um software de wiki gratuito que pode ser usado como uma plataforma de colaboração e documentação. É uma implementação de wiki poderosa, escalável e rica em recursos.

Este tutorial mostrará como instalar o MediaWiki com a pilha LAMP (Apache, MariaDB e PHP) no servidor Debian 12. Além disso, também mostraremos como proteger o MediaWiki com HTTPS via Certbot e Letsencrypt.

Pré-requisitos

Antes de começar, certifique-se de ter o seguinte:

• Um servidor Debian 12.
• Um usuário não-root com privilégios de administrador.
• Um nome de domínio apontando para um endereço IP do servidor.

Instalando a Pilha LAMP

MediaWiki é um software de código aberto baseado em PHP com MySQL/MariaDB como armazenamento de dados. Atualmente, a versão estável atual do MediaWiki (1.41) requer pelo menos PHP 7.3.4 ou superior e MariaDB 10.3.0. Quanto aos servidores web, você pode usar Apache ou Nginx.

Nesta seção, você instalará a pilha LAMP (Apache, MariaDB e PHP) que será usada para executar sua instalação do MediaWiki.

Primeiro, atualize seu repositório Debian com o seguinte comando.

sudo apt update

Uma vez que o repositório esteja atualizado, instale as dependências da pilha LAMP com o comando abaixo. Digite Y para confirmar a instalação.

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

Uma vez que a instalação esteja completa, verifique o serviço Apache e MariaDB para garantir que ambos os serviços estejam em execução.

Verifique o servidor web Apache com o comando abaixo. Se você receber a saída habilitada, isso confirma que o Apache está habilitado e será iniciado automaticamente na inicialização. Quando em execução, você verá a saída ativa (em execução).

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Em seguida, verifique o servidor de banco de dados MariaDB com o comando abaixo. A saída deve ser semelhante, uma saída habilitada confirma que o MariaDB está habilitado, e ativo (em execução) confirma que o MariaDB está em execução.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Por último, verifique a versão do PHP e liste os módulos habilitados com o comando abaixo. Você verá o PHP 8.2 instalado em seu servidor Debian.

php -v  
php -m

Configurando o PHP

Depois de instalar a pilha LAMP, você configurará sua instalação do PHP editando o arquivo php.ini e alterando alguns parâmetros padrão para o MediaWiki.

Para configurar o PHP, abra a configuração do PHP /etc/php/8.2/apache2/php.ini com o seguinte comando do editor nano.

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

Altere a configuração padrão com o seguinte e certifique-se de ajustar tanto date.timezone quanto memory_limit com seu ambiente atual.

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

Salve e saia do arquivo.

Agora execute o comando abaixo para reiniciar o serviço Apache e aplicar suas alterações.

sudo systemctl restart apache2

Configurando o Servidor MariaDB

Com o PHP configurado, o próximo passo é proteger o servidor MariaDB e criar um novo banco de dados e usuário para o MediaWiki. Neste exemplo, você protegerá o servidor MariaDB utilizando o comando de linha mariadb-secure-installation e criará um novo banco de dados e usuário via cliente MariaDB.

Para proteger a instalação do servidor MariaDB, execute o comando mariadb-secure-installation abaixo.

sudo mariadb-secure-installation

Agora digite Y para aceitar ou n para rejeitar a nova configuração no servidor MariaDB:

• A instalação padrão do MariaDB vem sem uma senha. Pressione ENTER quando solicitado pela senha.
• Agora digite Y para configurar a senha root do MariaDB. Em seguida, digite a nova senha para o MariaDB e repita a senha.
• Digite Y para remover o usuário anônimo da sua instalação do MariaDB.
• Digite Y novamente quando solicitado para desabilitar o login remoto para o usuário root do MariaDB.
• Digite Y para remover o banco de dados padrão de teste do seu MariaDB.
• Por último, digite Y para recarregar as permissões da tabela e aplicar novas alterações.

Depois de proteger a implantação do servidor MariaDB, faça login no servidor MariaDB usando o comando mariadb abaixo. Digite sua senha root do MariaDB quando solicitado.

sudo mariadb -u root -p

Agora execute as seguintes consultas para criar um novo banco de dados MariaDB e usuário para o MediaWiki. Neste exemplo, você criará um novo banco de dados mediawikidb, um usuário mediawiki com a senha mediawikipassdb. Você pode ajustar o seguinte com suas credenciais.

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

Em seguida, execute a seguinte consulta para verificar os privilégios do usuário MariaDB mediawiki. Certifique-se de que o usuário mediawiki pode acessar o banco de dados mediawikidb.

SHOW GRANTS FOR mediawiki@localhost;

Por último, digite quit para sair do MariaDB quando terminar.

Baixando o Código Fonte do MediaWiki

Agora que as dependências estão instaladas e configuradas, você pode instalar o MediaWiki. Existem várias versões do MediaWiki: estável, legado e LTS. Neste caso, você instalará a versão estável mais recente do MediaWiki 1.41.

Mova para o diretório /var/www e baixe o código fonte do MediaWiki via o comando wget abaixo. Certifique-se de visitar a página de download do MediaWiki para obter a versão mais recente.

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

Uma vez baixado, extraia o código fonte com o comando abaixo. Em seguida, renomeie o diretório extraído para mediawiki. Assim, o diretório DocumentRoot para o MediaWiki estará em /var/www/mediawiki.

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

Por último, mude a propriedade do diretório /var/www/mediawiki para o usuário www-data e altere a permissão para 0755.

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

Configurando o Host Virtual do Apache

Agora que você baixou o código fonte do MediaWiki, você criará um novo arquivo de host virtual do Apache para executar o MediaWiki nesta seção. Portanto, certifique-se de que você está equipado com o nome de domínio apontando para o endereço IP do seu servidor. Para produção, compre o domínio público, ou você também pode usar o nome de domínio local.

Antes de começar, habilite o módulo de reescrita do Apache com o comando abaixo.

sudo a2enmod rewrite

Agora crie uma nova configuração de host virtual do Apache /etc/apache2/sites-available/mediawiki.conf com o comando do editor nano abaixo.

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

Insira a seguinte configuração e certifique-se de alterar a opção ServerName com seu nome de domínio e o caminho dos logs de acesso e erro.

  
  
 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  
   
  

Salve o arquivo e saia do editor.

Em seguida, ative o arquivo de host virtual mediawiki.conf e verifique sua sintaxe do Apache com o comando abaixo. Se você tiver uma sintaxe correta do Apache, verá uma saída como Syntax OK.

sudo a2ensite mediawiki.conf  
sudo apachectl configtest

Por último, reinicie o servidor web Apache para aplicar o novo host virtual para o MediaWiki. Uma vez reiniciado, sua instalação do MediaWiki deve estar pronta.

sudo systemctl restart apache2

Protegendo o MediaWiki com HTTPS

Agora que você criou uma configuração de host virtual do Apache para o MediaWiki, vamos proteger sua instalação com HTTPS via Certbot e letsencrypt. Isso se aplica apenas se você estiver usando o domínio público, mas se estiver usando o domínio local, você pode gerar certificados autoassinados e aplicar o HTTPS manualmente.

Instale o Certbot e o plugin Certbot Apache com o comando abaixo. Digite Y para confirmar a instalação.

sudo apt install certbot python3-certbot-apache

Uma vez que a instalação esteja completa, execute o comando certbot abaixo para gerar certificados SSL/TLS para seu nome de domínio do MediaWiki. Certifique-se de alterar o nome de domínio e o endereço de e-mail com suas informações.

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

Após o processo ser concluído, seu certificado estará disponível no diretório /etc/letsencrypt/live/domain.com, enquanto seu host virtual também estará configurado com HTTPS.

Instalando o MediaWiki

Abra seu navegador web preferido e visite seu nome de domínio, como http://wiki.howtoforge.local/. Se tudo correr bem, você deverá ver a página de boas-vindas do MediaWiki. Clique no link configurar o wiki.

Selecione o idioma padrão para seu MediaWiki e clique em Continuar.

Para as verificações de ambiente, certifique-se de que seu sistema atenda aos requisitos do MediaWiki. Em seguida, clique em Continuar novamente.

Selecione o banco de dados como MariaDB e insira seu nome, usuário e senha. Em seguida, clique em Continuar para prosseguir.

Em seguida, insira seu nome de usuário de administrador, e-mail e senha para o MediaWiki, depois clique em Continuar.

Para configurações adicionais, selecione o tema padrão que deseja usar e clique em Continuar para prosseguir com a instalação.

Clique em Continuar para confirmar a instalação do MediaWiki.

Uma vez que a instalação esteja completa, o arquivo LocalSettings.php será baixado automaticamente para seu computador local e você verá uma instrução para fazer o upload do arquivo para o diretório de instalação do MediaWiki.

Volte ao seu terminal e execute o comando abaixo para criar um novo arquivo LocalSettings.php.

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

Abra o arquivo LocalSettings.php que você baixou e copie e cole o código PHP em seu servidor. Em seguida, salve o arquivo e saia.

Volte ao seu navegador web e clique no link para entrar no wiki. Você verá a página inicial padrão do MediaWiki que você instalou.

Conclusão

Parabéns! Você agora instalou com sucesso o MediaWiki no servidor Debian 12. Você instalou o MediaWiki com a pilha LAMP (Apache, MariaDB e PHP) e protegeu o MediaWiki com HTTPS do Letsencrypt.