Руководство:Установка MediaWiki
На этой странице описаны шаги по установке MediaWiki вручную, а дополнительные шаги по настройке можно найти в Manual:System administration#Configuration.
Для установки MediaWiki требуется базовое знакомство с использованием веб-хостинга.Это проще, если у вас есть некоторый опыт работы с Apache (программное обеспечение веб-сервера), PHP и MySQL/MariaDB (база данных). Дополнительная помощь доступна на Project: Support desk.
Раздел Дополнения предлагает альтернативы ручной установки, а также конкретные указания по установке для различных конфигураций системы.
Проверьте Local development quickstart для быстрого установки локальной настройки для разработки.
Проверьте требования к установке
Убедитесь, что ваша система соответствует требованиям к установке.
Не забудьте также проверить Примечания к выпуску MediaWiki, которую вы планируете установить.
Загрузка ПО MediaWiki
Загрузите tar-файл MediaWiki с официальной страницы загрузки.
If you are using MediaWiki in a production environment, the release manager has issued a strong recommendation that only versions listed at Version lifecycle and their end-of-life as the current "stable version", "legacy version" or "long-term support version" should be used in a production environment. Older versions may contain critical security vulnerabilities and other major bugs, including the threat of possible data loss and/or corruption. Как правило, если вы используете производственную среду, вы хотите использовать последнюю стабильную версию, которой является MediaWiki 1.42.3.
Извлечение ПО 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-адресе.
For example, if you rename the folder to "wiki", the URL will reflect this as "yourdomain.com/wiki".
Например, если ваш веб-сервер работает как http://localhost
, переименование в каталог /w/
будет означать, что вы получите доступ к своей вики по адресу http://localhost/w/index.php
.
/wiki/
, если вы хотите настроить его как Короткий URL-адрес после запуска скрипта установки.
Настройка базы данных
Установочный скрипт MediaWiki попросит вас получить имя базы данных и имя пользователя базы данных, поэтому 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';
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 (эта страница), прежде чем смотреть документацию по установке для каждой системы.
Запуск нескольких вики
Смотрите Руководство:Вопросы и Ответы#Установка и настройка.
Импорт существующей базы данных вики
Смотрите Руководство:Вопросы и Ответы#Установка и настройка.