WiKi
Подробная пошаговая инструкция по установке MediaWiki на сервере Debian/Ubuntu
В этой инструкции рассматривается классическая установка, аналогичная той, что мы обсуждали для Nextcloud, но адаптированная под требования и особенности MediaWiki. Движок используется веб-сервером Apache HTTP Server и базой данных MariaDB (совместимой с MySQL). Инструкция основана на официальной документации MediaWiki и лучших практиках.
1. Предварительные условия
Перед началом убедитесь, что ваш сервер соответствует следующим требованиям:
- Операционная система: Чистая установка Debian (например, Debian 12) или Ubuntu (например, Ubuntu LTS). У вас должны быть права root или пользователя с доступом к sudo.
- Аппаратные ресурсы: Рекомендуется минимум ~2 ГБ оперативной памяти и несколько ГБ свободного места на диске. Требования зависят от объема вашей вики.
- Сеть: Открыты порты 80 (HTTP) и 443 (HTTPS) в брандмауэре (ufw или iptables) и/или проброшены на роутере (если сервер за NAT).
- Доменное имя: У вас есть зарегистрированный домен или поддомен (например, `wiki.example.com`), указывающий на IP-адрес этого сервера.
2. Обновление системы
Первым делом обновите список пакетов и саму систему до последних версий.
sudo apt update
sudo apt upgrade -y
3. Установка веб-сервера Apache
Установите Apache и модуль PHP для него.
sudo apt install apache2 libapache2-mod-php -y
sudo systemctl enable apache2
sudo systemctl start apache2
Проверьте, что Apache запущен и работает без ошибок:
sudo systemctl status apache2
4. Установка PHP и необходимых расширений
Установите PHP рекомендованной версии (на данный момент рекомендуется PHP 8.1, 8.2 или 8.3) и полный набор модулей, необходимых для работы MediaWiki.
sudo apt install -y php php-gd php-curl php-zip php-xml php-mbstring \
php-mysql php-intl php-imagick php-bz2 php-bcmath php-gmp libmagickcore-dev
Примечание: Также могут понадобиться php-apcu (для локального кэширования) или php-fpm (если вы планируете использовать его вместо модуля Apache).
Настройка PHP.ini
Откройте файл конфигурации PHP для Apache (путь будет отличаться в зависимости от версии PHP, например, `/etc/php/8.2/apache2/php.ini`) и задайте следующие рекомендуемые параметры:
max_execution_time = 360
post_max_size = 64M (или больше, если планируете загружать большие файлы)
upload_max_filesize = 64M (или больше, должно быть меньше или равно post_max_size)
memory_limit = 512M (минимум, рекомендуется 1G или больше)
Также убедитесь, что OPCache включен (параметры `opcache.enable=1` и другие в `/etc/php/8.x/mods-available/opcache.ini` или `/etc/php/8.x/apache2/php.ini`).
5. Установка и настройка базы данных (MariaDB)
Установите сервер базы данных MariaDB.
sudo apt install mariadb-server -y
sudo systemctl enable mariadb
sudo systemctl start mariadb
Запустите скрипт безопасности, чтобы настроить пароль root, удалить анонимных пользователей и запретить удаленный вход root.
sudo mysql_secure_installation
Создание базы данных и пользователя для MediaWiki
Зайдите в консоль MySQL под root-пользователем:
sudo mysql -u root -p
Выполните следующие SQL-команды, заменив `StrongWikiPasswordHere` на ваш надежный пароль:
CREATE DATABASE mediawiki CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'StrongWikiPasswordHere';
GRANT ALL PRIVILEGES ON mediawiki.* TO 'mediawikiuser'@'localhost';
FLUSH PRIVILEGES;
EXIT;
- Важно: Не используйте этот пароль в LocalSettings.php позже, веб-интерфейс установки попросит его для создания файла конфигурации.*
6. Скачивание и установка MediaWiki
Перейдите в веб-корень сервера.
cd /var/www/html
Установите утилиты `tar` и `gzip` для распаковки.
sudo apt install tar gzip -y
Скачайте последнюю стабильную версию MediaWiki (ссылку всегда можно найти на официальном сайте, мы используем перенаправление на последнюю версию):
sudo wget https://releases.wikimedia.org/mediawiki/latest/mediawiki-latest.tar.gz
Распакуйте архив:
sudo tar -xzf mediawiki-latest.tar.gz
Переместите распакованные файлы в нужную директорию (например, `/var/www/html/wiki`) и удалите архив:
sudo mv mediawiki-* /var/www/html/wiki
sudo rm mediawiki-latest.tar.gz
Установите корректного владельца (пользователя веб-сервера `www-data`) и права доступа:
sudo chown -R www-data:www-data /var/www/html/wiki
sudo chmod -R 755 /var/www/html/wiki
7. Настройка виртуального хоста Apache для MediaWiki
Создайте новый файл конфигурации для вашего сайта, например, `/etc/apache2/sites-available/wiki.conf`, заменив `your.domain.com` на ваш реальный домен:
<VirtualHost *:80>
ServerName your.domain.com
DocumentRoot /var/www/html/wiki
<Directory /var/www/html/wiki/>
Options +FollowSymlinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
Активируйте созданный сайт и модули Apache, необходимые для работы MediaWiki (например, `rewrite`):
sudo a2ensite wiki.conf
sudo a2enmod rewrite headers env dir mime setenvif
sudo systemctl reload apache2
8. Настройка HTTPS (SSL)
Рекомендуется сразу настроить HTTPS. Самый простой и бесплатный способ — использовать сертификаты от Let’s Encrypt с помощью утилиты Certbot.
sudo apt install certbot python3-certbot-apache -y
sudo certbot --apache -d your.domain.com
Следуйте инструкциям на экране. Certbot автоматически получит сертификат, настроит Apache и предложит настроить автоматическое перенаправление с HTTP на HTTPS (рекомендуется выбрать этот вариант).
После завершения перезагрузите Apache:
sudo systemctl reload apache2
9. Завершение установки через веб-интерфейс
- Откройте браузер и перейдите по адресу `https://your.domain.com/mw-config/index.php`. Вы увидите веб-интерфейс установки MediaWiki.
- Пройдите шаги установки: Выберите язык, примите условия лицензии, затем следуйте инструкциям:
- Системная проверка: Убедитесь, что все критические проверки пройдены (зеленые галочки).
- Подключение к базе данных:
- Тип базы данных: MariaDB/MySQL.
- Хост базы данных: `localhost`.
- Название базы данных: `mediawiki` (как создали на шаге 5).
- Имя пользователя базы данных: `wikiuser` (как создали на шаге 5).
- Пароль базы данных: Пароль, заданный вами (вместо `StrongWikiPasswordHere`).
- Адрес администратора: Оставьте пустым.
- Нажмите продолжить.
- Настройки базы данных: Оставьте настройки по умолчанию (хранилище, кодировка).
- Название вики и создание администратора: Укажите название вашей вики и создайте учетную запись администратора (имя, пароль, email).
- Дополнительная конфигурация: Просмотрите дополнительные настройки по желанию (например, выбор стандартного внешнего вида, включение загрузки файлов, права доступа). Убедитесь, что загрузка файлов включена, если планируете загружать картинки.
- Завершение установки: Нажмите кнопку «Установить MediaWiki».