Как установить MediaWiki на Ubuntu 24.04

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

Этот гид покажет вам, как установить программное обеспечение MediaWiki на сервер Ubuntu 24.04. Вы установите MediaWiki с помощью LAMP-стека (Linux, Apache, MySQL/MariaDB и PHP), а затем защитите его с помощью HTTPS через Certbot и Letsencrypt.

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

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

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

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

Чтобы установить MediaWiki, вы должны убедиться, что зависимости установлены на вашей системе. В настоящее время стабильная версия MediaWiki 1.41 требует PHP 8.1-83. В этом разделе вы установите Apache, сервер MariaDB, PHP 8.3 и ImageMagick в качестве зависимостей для MediaWiki.

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

sudo apt update

Теперь установите зависимости для MediaWiki, используя следующую команду. Введите Y, чтобы подтвердить процесс. С этим вы установите LAMP-стек (Apache, MySQL/MariaDB и PHP) и пакеты ImageMagick.

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

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

sudo systemctl is-enabled apache2
sudo systemctl status apache2

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

sudo systemctl is-enabled mariadb
sudo systemctl status mariadb

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

sudo php -v

Настройка UFW

Добавьте и включите профиль Apache Full в UFW с помощью следующей команды:

sudo ufw allow “Apache Full”

Теперь проверьте включенные правила в UFW с помощью команды ufw status ниже. Профиль Apache Full открывает порты как для HTTP, так и для HTTPS протоколов.

sudo ufw status

Настройка PHP

После установки зависимостей вы настроите PHP, отредактировав файл конфигурации по умолчанию /etc/php/8.3/apache2/php.ini.

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

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

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

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

Сохраните и закройте файл, когда закончите.

Теперь выполните команду ниже, чтобы перезапустить веб-сервер Apache и применить вашу конфигурацию PHP.

sudo systemctl restart apache2

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

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

Защитите установку вашего сервера MariaDB с помощью команды mariadb-secure-installation ниже.

sudo mariadb-secure-installation

Теперь вам будут заданы следующие конфигурации сервера MariaDB:

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

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

sudo mariadb -u root -p

Затем выполните следующие запросы, чтобы создать новую базу данных и пользователя для 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;

Теперь выполните запрос ниже, чтобы проверить привилегии для пользователя mediawiki. Ниже вы можете увидеть, что пользователь mediawiki может получить доступ к базе данных mediawikidb.

SHOW GRANTS FOR mediawiki@localhost;

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

Скачивание MediaWiki

В этом разделе вы загрузите исходный код MediaWiki 1.41 и настроите каталог установки для MediaWiki.

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

cd /var/www/
curl -O https://releases.wikimedia.org/mediawiki/1.41/mediawiki-1.41.1.tar.gz

После загрузки извлеките исходный код MediaWiki и переименуйте каталог в mediawiki. С этим ваш корневой каталог документов для 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. Убедитесь, что у вас есть доменное имя, указывающее на ваш сервер MediaWiki.

Сначала выполните следующую команду, чтобы включить модуль rewrite на веб-сервере Apache.

sudo a2enmod rewrite

Теперь создайте новый файл виртуального хоста /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 is OK.

sudo a2ensite mediawiki.conf
sudo apachectl configtest

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

sudo systemctl restart apache2

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

В этом руководстве вы защитите MediaWiki с помощью HTTPS. Если вы используете публичный домен, вы можете использовать бесплатные SSL-сертификаты от Letsencrypt и настроить HTTPS автоматически. Вы можете сгенерировать SSL-сертификаты и настроить HTTPS вручную для пользователей локального домена.

Установите пакеты certbot и python3-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

Вы увидите SSL/TLS сертификаты в каталоге /etc/letsencrypt/live/domain.com. Ваша установка MediaWiki должна быть автоматически защищена с помощью HTTPS.

Установка MediaWiki

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

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

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

Введите данные вашей базы данных MariaDB и нажмите Продолжить.

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

Теперь введите название вашей вики и создайте нового администратора и пароль для вашей установки MediaWiki. Затем снова нажмите Продолжить.

В дополнительных опциях MediaWiki перейдите в раздел Скины и выберите вашу тему/скин по умолчанию. В этом примере мы будем использовать MinervaNeue.

Прокрутите вниз, оставьте другие настройки (или измените их по мере необходимости), затем нажмите Продолжить.

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

После завершения установки снова нажмите Продолжить.

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

В файле LocalSettings.php измените параметр по умолчанию $wgDefaultSkin на minerva.

$wgDefaultSkin = “minerva”;

Теперь посетите главную страницу MediaWiki, и вы можете увидеть ниже главную страницу темы MinervaNeue.

Теперь вы можете нажать кнопку входа в верхнем правом углу, затем введите вашего администратора и пароль.

Заключение

Поздравляем! Вы завершили установку MediaWiki на сервере Ubuntu 24.04. У вас работает MediaWiki с LAMP-стеком (Linux, Apache, MySQL/MariaDB и PHP) и защищённый с помощью HTTPS через certbot и Letsencrypt.