Как установить MediaWiki на Debian 12

MediaWiki — это программное обеспечение для вики с открытым исходным кодом, используемое крупнейшими вики-сайтами, такими как Wikipedia и Wikimedia. Это бесплатное программное обеспечение для вики, которое можно использовать как платформу для сотрудничества и документации. Это мощная, масштабируемая и богатая функциями реализация вики.

Этот учебник покажет вам, как установить MediaWiki с помощью LAMP Stack (Apache, MariaDB и PHP) на сервере Debian 12. Кроме того, мы также покажем вам, как защитить MediaWiki с помощью HTTPS через Certtbot и Letsencrypt.

Предварительные требования

Перед тем как начать, убедитесь, что у вас есть следующее:

Сервер Debian 12.
Пользователь, не являющийся root, с правами администратора.
Доменное имя, указывающее на IP-адрес сервера.

Установка LAMP Stack

MediaWiki — это программное обеспечение с открытым исходным кодом, основанное на PHP с MySQL/MariaDB в качестве хранилища данных. В настоящее время стабильная версия MediaWiki (1.41) требует как минимум PHP 7.3.4 или выше и MariaDB 10.3.0. Что касается веб-серверов, вы можете использовать либо Apache, либо Nginx.

В этом разделе вы будете устанавливать LAMP Stack (Apache, MariaDB и PHP), который будет использоваться для запуска вашей установки MediaWiki.

Сначала обновите репозиторий Debian с помощью следующей команды.

sudo apt update

После обновления репозитория установите зависимости LAMP Stack с помощью команды ниже. Введите Y для подтверждения установки.

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

установка зависимостей

После завершения установки проверьте службу Apache и MariaDB, чтобы убедиться, что обе службы работают.

Проверьте веб-сервер Apache с помощью команды ниже. Если вы получите вывод enabled, это подтверждает, что Apache включен и будет запускаться автоматически при старте. При запуске вы увидите вывод active (running).

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

проверка apache2

Далее проверьте сервер базы данных MariaDB с помощью команды ниже. Вывод должен быть аналогичным, вывод enabled подтверждает, что MariaDB включен, а active (running) подтверждает, что MariaDB работает.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

проверка mariadb

Наконец, проверьте версию PHP и список включенных модулей с помощью команды ниже. Вы увидите установленный PHP 8.2 на вашем сервере Debian.

php -v  
php -m

проверка php

Настройка PHP

После установки LAMP Stack вы настроите вашу установку PHP, отредактировав файл php.ini и изменив некоторые параметры по умолчанию для MediaWiki.

Чтобы настроить PHP, откройте конфигурацию PHP /etc/php/8.2/apache2/php.ini с помощью следующей команды редактора nano.

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

Измените конфигурацию по умолчанию следующим образом и убедитесь, что вы настроили как date.timezone, так и memory_limit в соответствии с вашей текущей средой.

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

Сохраните и выйдите из файла.

Теперь выполните команду ниже, чтобы перезапустить службу Apache и применить ваши изменения.

sudo systemctl restart apache2

Настройка сервера MariaDB

С настроенным PHP следующим шагом будет защита сервера MariaDB и создание новой базы данных и пользователя для MediaWiki. В этом примере вы защитите сервер MariaDB, используя команду mariadb-secure-installation, и создадите новую базу данных и пользователя через клиент MariaDB.

Чтобы защитить установку сервера MariaDB, выполните команду mariadb-secure-installation ниже.

sudo mariadb-secure-installation

Теперь введите Y, чтобы принять, или n, чтобы отклонить новую конфигурацию на сервере MariaDB:

По умолчанию установка MariaDB идет без пароля. Нажмите ENTER, когда будет предложено ввести пароль.
Теперь введите Y, чтобы установить пароль root для MariaDB. Затем введите новый пароль для MariaDB и повторите пароль.
Введите Y, чтобы удалить анонимного пользователя из вашей установки MariaDB.
Введите Y снова, когда будет предложено отключить удаленный вход для пользователя root MariaDB.
Введите Y, чтобы удалить тестовую базу данных по умолчанию из вашей MariaDB.
Наконец, введите Y, чтобы перезагрузить привилегии таблиц и применить новые изменения.

После того как вы защитили развертывание сервера MariaDB, войдите на сервер MariaDB, используя команду mariadb ниже. Введите свой пароль root для MariaDB, когда будет предложено.

sudo mariadb -u root -p

Теперь выполните следующие запросы, чтобы создать новую базу данных MariaDB и пользователя для MediaWiki. В этом примере вы создадите новую базу данных mediawikidb, пользователя mediawiki с паролем mediawikipassdb. Вы можете настроить следующее с вашими учетными данными.

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

создание базы данных и пользователя

Далее выполните следующий запрос, чтобы проверить привилегии пользователя MariaDB mediawiki. Убедитесь, что пользователь mediawiki может получить доступ к базе данных mediawikidb.

SHOW GRANTS FOR mediawiki@localhost;

Наконец, введите quit, чтобы выйти из MariaDB, когда закончите.

проверка привилегий пользователя

Скачивание исходного кода MediaWiki

Теперь, когда зависимости установлены и настроены, вы можете установить MediaWiki. Существует несколько версий MediaWiki: стабильная, устаревшая и LTS. В этом случае вы установите последнюю стабильную версию MediaWiki 1.41.

Перейдите в директорию /var/www и скачайте исходный код MediaWiki с помощью команды wget ниже. Убедитесь, что вы посетили страницу загрузки MediaWiki, чтобы получить последнюю версию.

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

После загрузки извлеките исходный код с помощью команды ниже. Затем переименуйте извлеченную директорию в mediawiki. Таким образом, директория DocumentRoot для MediaWiki будет находиться по адресу /var/www/mediawiki.

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

Наконец, измените владельца директории /var/www/mediawiki на пользователя www-data и измените разрешения на 0755.

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

Настройка виртуального хоста Apache

Теперь, когда вы скачали исходный код MediaWiki, вы создадите новый файл конфигурации виртуального хоста Apache для запуска MediaWiki в этом разделе. Убедитесь, что у вас есть доменное имя, указывающее на IP-адрес вашего сервера. Для продакшена купите публичный домен или вы также можете использовать локальное доменное имя.

Перед тем как начать, включите модуль перезаписи Apache с помощью команды ниже.

sudo a2enmod rewrite

Теперь создайте новую конфигурацию виртуального хоста Apache /etc/apache2/sites-available/mediawiki.conf с помощью команды редактора nano ниже.

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

Вставьте следующую конфигурацию и убедитесь, что вы изменили опцию ServerName на ваше доменное имя и путь к обоим журналам доступа и ошибок.

  
  
 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

Сохраните файл и выйдите из редактора.

Далее активируйте файл виртуального хоста mediawiki.conf и проверьте синтаксис Apache с помощью команды ниже. Если у вас правильный синтаксис Apache, вы увидите вывод, такой как Syntax OK.

sudo a2ensite mediawiki.conf  
sudo apachectl configtest

Наконец, перезапустите веб-сервер Apache, чтобы применить новый виртуальный хост для MediaWiki. После перезапуска ваша установка MediaWiki должна быть готова.

sudo systemctl restart apache2

настройка apache vhost

Защита MediaWiki с помощью HTTPS

Теперь, когда вы создали конфигурацию виртуального хоста Apache для MediaWiki, давайте защитим вашу установку с помощью HTTPS через Certbot и letsencrypt. Это применимо только в том случае, если вы используете публичный домен, но если вы используете локальное доменное имя, вы можете сгенерировать самоподписанные сертификаты и применить HTTPS вручную.

Установите Certbot и плагин Certbot Apache с помощью команды ниже. Введите Y для подтверждения установки.

sudo apt install certbot python3-certbot-apache

После завершения установки выполните команду certbot ниже, чтобы сгенерировать SSL/TLS сертификаты для вашего доменного имени MediaWiki. Убедитесь, что вы изменили доменное имя и адрес электронной почты на свои данные.

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

После завершения процесса ваш сертификат будет доступен в директории /etc/letsencrypt/live/domain.com, в то время как ваш виртуальный хост также будет настроен с HTTPS.

Установка MediaWiki

Откройте предпочитаемый вами веб-браузер и посетите ваше доменное имя, например http://wiki.howtoforge.local/. Если все пройдет хорошо, вы должны увидеть страницу приветствия MediaWiki. Нажмите на ссылку настроить вики.

настройка вики

Выберите язык по умолчанию для вашей MediaWiki и нажмите Продолжить.

выбор языка

Для проверки окружения убедитесь, что ваша система соответствует требованиям MediaWiki. Затем снова нажмите Продолжить.

проверка окружения

Выберите базу данных как MariaDB и введите ваше имя, пользователя и пароль. Затем нажмите Продолжить, чтобы продолжить.

конфигурация базы данных

Далее введите ваше имя администратора, электронную почту и пароль для MediaWiki, затем нажмите Продолжить.

настройка администратора

Для дополнительных настроек выберите тему по умолчанию, которую вы хотите использовать, затем нажмите Продолжить, чтобы продолжить установку.

настройки по умолчанию

Нажмите Продолжить, чтобы подтвердить установку MediaWiki.

подтверждение установки

завершение

После завершения установки файл LocalSettings.php будет автоматически загружен на ваш локальный компьютер, и вы увидите инструкцию по загрузке файла в директорию установки MediaWiki.

установка завершена

Вернитесь в терминал и выполните команду ниже, чтобы создать новый файл LocalSettings.php.

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

Откройте файл LocalSettings.php, который вы загрузили, и скопируйте и вставьте PHP-код на ваш сервер. Затем сохраните файл и выйдите.

Вернитесь в ваш веб-браузер и нажмите на ссылку, чтобы войти в вики. Вы увидите домашнюю страницу MediaWiki, которую вы установили.

домашняя страница mediawiki

Заключение

Поздравляем! Вы успешно установили MediaWiki на сервер Debian 12. Вы установили MediaWiki с помощью LAMP Stack (Apache, MariaDB и PHP) и защитили MediaWiki с помощью HTTPS от Letsencrypt.