Pesquisa de site

Como instalar o MediaWiki no Debian 12

Nesta página

  1. Pré-requisitos
  2. Instalando a pilha LAMP
  3. Configurando PHP
  4. Configurando o servidor MariaDB
  5. Baixando o código-fonte do MediaWiki
  6. Configurando Host Virtual Apache
  7. Protegendo o MediaWiki com HTTPS
  8. Instalando o MediaWiki
  9. Conclusão

MediaWiki é um software wiki de código aberto usado pelos maiores sites wiki, como Wikipedia e Wikimedia. É um software wiki gratuito que pode ser usado como 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 o LAMP Stack (Apache, MariaDB e PHP) no servidor Debian 12. Além disso, também mostraremos como proteger o MediaWiki com HTTPS via Certtbot 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 apontado para um endereço IP de 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 a instalação do MediaWiki.

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

sudo apt update

Assim que o repositório for atualizado, instale as dependências do LAMP Stack com o comando abaixo. Insira 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

Assim que a instalação for concluída, 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 a saída estiver habilitada, isso confirma que o Apache está habilitado e será iniciado automaticamente na inicialização. Ao executar, você verá a saída ativa (em execução).

sudo systemctl is-enabled apache2
sudo systemctl status apache2

A seguir, 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 ativa (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 PHP

Depois de instalar o LAMP Stack, você configurará a instalação do PHP editando o arquivo php.ini e alterando alguns parâmetros padrão do 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 date.timezone e 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 a linha de comando mariadb-secure-installation e criará um novo banco de dados e usuário por meio do cliente MariaDB.

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

sudo mariadb-secure-installation

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

  • A instalação padrão do MariaDB vem sem senha. Pressione ENTER quando a senha for solicitada.
  • Agora insira Y para configurar a senha root do MariaDB. Em seguida, digite a nova senha do MariaDB e repita a senha.
  • Insira Y para remover o usuário anônimo da instalação do MariaDB.
  • Insira Y novamente quando solicitado a desabilitar o login remoto para o usuário root do MariaDB.
  • Insira Y para remover o teste de banco de dados padrão do seu MariaDB.
  • Por último, insira Y para recarregar os privilégios 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. Insira 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 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 mediawiki do MariaDB. Certifique-se de que o usuário mediawiki possa 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.

Vá para o diretório /var/www e baixe o código-fonte do MediaWiki através do 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

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

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

Por último, altere 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 Host Virtual Apache

Agora que você baixou o código-fonte do MediaWiki, você criará um novo arquivo host virtual Apache para executar o MediaWiki nesta seção. Portanto, certifique-se de estar equipado com o nome de domínio apontando para o endereço IP do seu servidor. Para produção, adquira 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 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 de erros.

<VirtualHost *:80>
 ServerName wiki.howtoforge.local
 ServerAdmin [email 
 DocumentRoot /var/www/mediawiki
 ErrorLog /var/log/apache2/wiki.howtoforge.local_error.log
 CustomLog /var/log/apache2/wiki.howtoforge.local_access.log combined
 <Directory /var/www/mediawiki/>
 Options FollowSymlinks
 AllowOverride All
 Require all granted
 </Directory>
</VirtualHost>

Salve o arquivo e saia do editor.

Em seguida, ative o arquivo host virtual mediawiki.conf e verifique a sintaxe do Apache com o comando abaixo. Se você tiver a sintaxe adequada 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 MediaWiki. Depois de reiniciado, a instalação do MediaWiki deverá estar pronta.

sudo systemctl restart apache2

Protegendo o MediaWiki com HTTPS

Agora que você criou uma configuração de host virtual Apache para 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, poderá 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

Assim que a instalação for concluída, execute o comando certbot abaixo para gerar certificados SSL/TLS para o seu nome de domínio 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  -d wiki.howtoforge.local

Após a conclusão do processo, 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 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 o 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 do MediaWiki e 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.

Assim que a instalação for concluída, o arquivo LocalSettings.php será baixado automaticamente para o seu computador local e você verá uma instrução para enviar o 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.

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

Conclusão

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