Руководство:Установка MediaWiki
На этой странице описываются шаги, необходимые для ручной установки MediaWiki. После установки дополнительные сведения о конфигурации можно найти на странице Manual:System administration#Configuration.
Для установки MediaWiki необходимы базовые знания веб-хостинга. Опыт работы с Apache, PHP и MySQL/MariaDB облегчит процесс. По любым вопросам, касающимся установки MediaWiki, обращайтесь в Project: Support desk или в другие места, указанные в Общение.
Раздел Дополнения предлагает альтернативы ручной установки, а также конкретные указания по установке для различных конфигураций системы.
Проверьте Local development quickstart для быстрого установки локальной настройки для разработки.
Проверьте требования к установке
Убедитесь, что ваша система соответствует требованиям к установке.
Не забудьте также проверить Примечания к выпуску MediaWiki, которую вы планируете установить.
Загрузка ПО MediaWiki
Загрузите tar-файл MediaWiki с официальной страницы загрузки.
Если вы используете MediaWiki в производственной среде, менеджер по выпуску настоятельно рекомендует использовать в производственной среде только версии, указанные в Версии и их жизненный цикл как текущая "стабильная версия", "устаревшая версия" или "версия с долгосрочной поддержкой"(LTS). Более старые версии могут содержать критические уязвимости безопасности и другие серьезные ошибки, включая угрозу возможной потери и/или повреждения данных. Текущая стабильная версия MediaWiki 1.43.0.
Извлечение ПО MediaWiki
Скачанный файл будет в формате .zip или .tar.gz.
Вам необходимо распаковать этот файл архива перед использованием.
Вы можете распаковать файл локально (и затем загрузить через FTP на сервер) или прямо на свой сервер.
Обычно это делается с помощью специального ПО, таким как 7-Zip (бесплатно), WinZip, WinRAR или IZArc (бесплатно) в Windows.
В Linux и Mac OS X, вы можете распаковать файл с помощью следующей команды:
tar -xzvf mediawiki-*.tar.gz
chown -R <new_owner_user> <mediawiki_folder> Для получения дополнительной информации о защите прав доступа к файлам см. Руководство:Безопасность#Права доступа к файлам.
Загрузить файлы на Ваш сервер
Если вы еще не загрузили файлы на свой веб-сервер (или не скопировали, если программное обеспечение вашего веб-сервера работает локально на localhost), сделайте это сейчас.
Загрузите файлы в директорию на веб-сервере:
- непосредственно копируя распакованную папку или
- используя FTP-клиент, такой как FileZilla (Windows, OSX и Linux) или Cyberduck (Windows и OSX).
- с помощью программного обеспечения, уже предоставленного вашей службой хостинга, например файловый менеджер cPanel
Если в вашем инструменте загрузки есть опция "изменить имена файлов на строчные буквы", вы должны отключить ее, чтобы предотвратить непреднамеренные изменения имен файлов в процессе загрузки.
Если вы используете веб-сервер Apache HTTPD, правильный каталог указан в вашем файле httpd.conf в директиве DocumentRoot.
По умолчанию это /var/www/ или <папка apache>/htdocs.
Точное расположение файла настроек и каталогов сервера Apache httpd.conf зависит от вашей операционной системы.
В Debian и Ubuntu файл настроек и каталогов сервера Apache называется /etc/apache2/apache2.conf.
В Red Hat и Fedora, файл находится в /etc/httpd/conf/httpd.conf.
Переименуйте загруженную папку, назвав ее по своему усмотрению, так как это определит, как она будет отображаться в URL-адресе.
Например, если вы переименуйте папку в wiki, URL отражает это как example.com/wiki.
Например, если ваш веб-сервер работает как http://localhost, переименование в каталог /w/ будет означать, что вы получите доступ к своей вики по адресу http://localhost/w/index.php.
/wiki/, если вы хотите настроить его как Короткий URL-адрес после запуска скрипта начальной конфигурации.
Настройка базы данных
Для скрипта начальной конфигурации MediaWiki требуется имя базы данных и имя пользователя базы данных для хранения содержимого вики.
Если у вас уже есть сервер базы данных и вы знаете пароль для пользователя «root» (admin), перейдите к разделу #Запустить скрипт установки .
Если вы не знаете пароль для пользователя root, например, если вы находитесь на хостинг-сервисе, вам придется создать новую базу данных, прежде чем запустить сценарий установки MediaWiki в следующем разделе.
Рекомендуемые базы данных MariaDB/MySQL. PostgreSQL и SQLite имеют ограниченную поддержку и не должны использоваться, если для этого нет причины. Если вы не уверены, какую базу данных выбрать, используйте MariaDB.
После завершения настройки базы данных, продолжите #Запуск установочного скрипта ниже.
SQLite
Дальнейшая настройка не требуется для SQLite, если в системе установлен модуль pdo-sqlite для PHP.
На странице установки SQLite выберите имя базы данных (что может быть чем угодно) и каталог базы данных SQLite. Для каталога базы данных установщик попытается использовать подкаталог за пределами корня документа и создать его, если это необходимо. Если этот каталог не является безопасным (например, веб-читаемый), измените это вручную, чтобы он не был доступен для всех в Интернете.
MariaDB/MySQL
Создайте базу данных MariaDB/MySQL и пользователя базы данных.
- Панель управления, предоставляемая вашим хостинг-провайдером, например PhpMyAdmin.
- Используйте ssh для входа на свой хост и введите приведенные ниже команды в приглашение MySQL. См. соответствующую документацию вашего хостингового провайдера. Кроме того, вы можете попросить своего хостинг-провайдера создать для вас базу данных и пользователя.
Следующие команды создают базу данных с именем my_wiki, пользователя с именем wikiuser, и установят разрешения для пользователя в этой базе данных.
CREATE DATABASE my_wiki;
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'database_password';
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'localhost' WITH GRANT OPTION;
Только если ваша база данных не работает на том же сервере, что и ваш веб-сервер, вам необходимо дать соответствующее имя хоста веб-сервера (mediawiki.example.com в примере ниже):
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'mediawiki.example.com' IDENTIFIED BY 'database_password';
 Внимание: | MySQL/MariaDB записывает все запросы в файле истории. Он будет включать пароль базы данных для учетной записи пользователя. Если это касается вас, удалите и отключите файл .mysql_history после запуска этих запросов, следуя документации MySQL. |
PostgreSQL
Если вы используете PostgreSQL, вам нужно будет либо создать базу данных и пользователя, либо предоставить имя пользователя PostgreSQL с привилегиями "суперпользователь" в форму конфигурации.
Часто, это имя пользователь базы данных postgres.
Следующие команды в командной строке Linux, как пользователь Postgres, создают пользователя базы данных с именем wikiuser, и базу данных с именем my_wiki, принадлежащей пользователю с именем wikiuser.
createuser -S -D -R -P -E wikiuser (затем введите пароль базы данных) createdb -O wikiuser my_wiki
или как суперпользователь (по умолчанию postgres) выполняет следующие команды в приглашении базы данных:
CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'database_password';
CREATE DATABASE my_wiki WITH OWNER wikiuser;
Остерегайтесь списка известных проблем при запуске Mediawiki с PostgreSQL.
Запуск установочного скрипта
Далее, завершите установку MediaWiki, перейдя по URL вашей установленной MediaWiki в вашем веб-браузере: Следуйте инструкциям в Manual:Настройка скрипта.
Дальнейшая настройка
- Руководство:Системное администрирование - Дополнительная конфигурация
- Руководство:Администраторы - Администрирование вики
Поддерживайте в актуальном состоянии!
После установки следите за обновлениями и следите за безопасностью своего сервера!
Дополнения
Альтернативы ручной установке
Ручная установка часто является предпочтительным методом, поскольку она дает пользователю больше контроля и понимания того, как устанавливается его вики, что упрощает устранение неполадок и обслуживание. Автоматизированные процессы, пакеты, сборки и услуги имеют свои особенности.
Вместо ручной установки MediaWiki есть упрощенные альтернативные варианты:
- предварительно интегрированное программное обеспечение
- услуги хостинга с установкой в 1 клик или вики-фермы
- software bundles
- Услуги хостинга, обеспечивающие автоматическую установку таких приложений, как MediaWiki, могут предлагать устаревшие версии или иметь другие проблемы. Если вы столкнулись с проблемами, это "не" означает, что вы не можете установить MediaWiki. Это означает, что вы должны установить MediaWiki вручную.
Смотрите также comparison of distribution options.
Инструкции для конкретной системы
Страницы, перечисленные в Manual:OS specific help, содержат более подробные инструкции по установке, предназначенные для конкретных систем.
Однако в целом эти системные документы меньше поддерживаются и могут не всегда обновляться. Сначала обратитесь к Установка MediaWiki (эта страница), прежде чем смотреть документацию по установке для каждой системы.
Запуск нескольких вики
Смотрите Руководство:Вопросы и Ответы#Установка и настройка.
Импорт существующей базы данных вики
Смотрите Руководство:Вопросы и Ответы#Установка и настройка.