手册:安装 MediaWiki

本頁使用了標題或全文手工轉換
From mediawiki.org
This page is a translated version of the page Manual:Installing MediaWiki and the translation is 99% complete.

本页包含手动安装和配置MediaWiki的所有步骤。

注意:如果你没有Apache(网络服务器软件)、PHP、MySQL/MariaDB(数据库)的使用经验,那么对你而言,MediaWiki 的安装可能会比较困难。 下方的附录段落提供了更简单的替代方案

下方的附录段落还提供了对于特定系统配置的安装提示。

如果你已经在运行MediaWiki,请参阅升级指南

检查安装要求

首先,你需要检查您的系统是否符合以下的最低配置要求

确保还检查了你计划安装的MediaWiki版本的发行说明

下载MediaWiki软件

首先,你要先在官方下载页面下载MediaWiki压缩包文件。

一般来说,如果你使用的是生产环境,你可能会需要运行最新的稳定发行版本,即MediaWiki 1.39.0。

解压MediaWiki软件

你下载的文件是.zip或者.tar.gz格式, 这意味着在你使用前需要先解压这个压缩包。 你可以本地解压缩文件(然后通过FTP上传到服务器)或者直接在服务器上解压。

在Windows上,一般是利用7-Zip(免费)、WinZipWinRARIZArc(免费)解压缩文件,他们的便利性无需多言。

Linux和macOS系统上可以通过这个命令来解压: tar -xf mediawiki-*.tar.gz

如果你是以root/admin身份解压文件的话,你可能需要更改文件权限,但这完全取决于你的设置,某些情况下保持默认值即可。 在Linux系统中,你可以使用chown命令修改文件权限,如下所示。 chown -R <new_owner_user> <mediawiki_folder>

上传文件到你的服务器

如果你还未将文件上传到Web服务器,请先进行这一步操作。

通过以下方式将文件上传到Web服务器的Web目录:

  1. 直接复制解压的文件夹,或者
  2. 使用FTP客户端上传文件,例如FileZilla(开源软件、Windows、OSX和Linux)或Cyberduck(OSX)。
  3. 通过你使用的网站托管服务提供的软件,例如cPanel文件管理器

如果你的上传工具有“将文件名更改为小写”这类选项,在上传之前必须先禁用此选项,以免出现未知错误。

如果您使用的是Apache HTTPD web服务器,那么正确的目录是由httpd.conf文件的DocumentRoot指令指定。 默认情况下为/var/www/<apache-folder>/htdocs

Apacha服务器设置和目录文件httpd.conf的准确位置取决于你的操作系统。 在Debian和Ubuntu中,管理Apache服务器设置和目录的文件为/etc/apache2/apache2.conf。 对于Red Hat和Fedora,这个文件是/etc/httpd/conf/httpd.conf

将上传的文件夹根据您希望在URL中使用的路径重命名。 例如,如果你的服务器运行在http://localhost,使用/w/作为网站目录意味着你应该以http://localhost/w/index.php访问你的wiki。

如果你想在运行安装脚本后将/wiki/设置为短链接,此时请不要占用同名路径。

配置数据库

由于MediaWiki会在数据库中存储所需要的相关数据,因此,安装脚本会要求你提供数据库的相关信息,

如果您已经有一个数据库并知道且“root”(admin)用户的密码,可以直接跳到下面的#运行安装脚本章节。

如果你不知道根用户的密码,或者在托管的服务器上,你可能需要创建一个新的数据库,然后再运行下一个章节中的MediaWiki安装脚本。

由于MedaiWiki开发计划的影响,MedaiWiki目前仅支持SQLite、MariaDB、MySQL、PostgreSQL作为数据库驱动程序, 如果你不确定选择哪种数据库,那就用MariaDB。

After finishing the database setup, continue with #Run the installation script below.

SQLite

如果系统中已经安装了PHP的pdo-sqlite模块,那么SQLite无需进一步的设置了。

在SQLite安装页面上,您需要填写数据库名称(可以是任何内容)和SQLite数据库目录。 对于数据库目录,安装程序将会尝试使用文档根目录之外的子目录,并在需要时创建目录。 如果此目录不安全(例如Web可读),请更改目录权限,以免让网络上的所有人都可访问。

MariaDB/MySQL

Create the MariaDB/MySQL database and database user. There are several ways:

  • Use a control panel software offered by your Hosting service (example: PhpMyAdmin)
  • Use ssh to log into your host and type the commands below into a MySQL prompt. 具体内容请查看你所使用的服务器供应商提供的相应文件。 你也可以与你的托管服务提供商联系,让他们为您创建一个帐户。

下面的命令创建了一个名为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;

只有当您的数据库与web服务器不在同一台服务器上运行时,您才需要提供适当的web服务器主机名(在下面的示例中为mediawiki.example.com):

GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'mediawiki.example.com' IDENTIFIED BY 'database_password';
警告 警告: MySQL/MariaDB会在历史文件中输出所有的查询,包括用户账户的数据库密码。 如果您对此有顾虑,请在运行这些查询后按照MySQL文档删除并禁用.mysql_history文件。

PostgreSQL

如果您使用的是PostgreSQL,则需要为您创建数据库和用户,或者为配置表单提供具有“superuser”权限的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;

注意使用PostgreSQL运行MediaWiki时已知问题的列表

运行安装脚本

接下来,在你的web浏览器中转到MediaWiki安装的URL,完成MediaWiki的安装:按照手册:初始配置 中的指示操作。

进一步配置

保持最新!

安装后,请确保您及时跟进版本,确保您的服务器安全! 订阅MediaWiki发行版本公告邮件列表。

附录

替代手动安装的方法

这些替代的选项或许更加容易,不需要手动安装MediaWiki:

提供自动安装MediaWiki等应用程序的托管服务可能会提供过时的版本或存在其他问题。如果您遇到问题,并不是意味着您无法安装MediaWiki。这意味着您应该手动安装MediaWiki。

参见comparison of distribution options

系统相关指南

手册:操作系统特定帮助 列举的页面会提供针对特定系统的详细安装指导。

但是,总的来说,这些为特定系统系统的文档很少维护,并且可能并不总是最新的。 在查看每个系统的安装文档之前,请先阅读手册:安装 MediaWiki (此页面)。

运行多个wiki

参见手册:FAQ#安装和配置

导入现有的wiki数据库

参见手册:FAQ#安装和配置

参见