Manual:安装MediaWiki

This page is a translated version of the page Manual:Installing MediaWiki and the translation is 85% complete.
Outdated translations are marked like this.


此页面概括了手动安装 MediaWiki所需要的步骤。安装完成后,进行额外配置的细节可在手册:系统管理#配置中找到。

安装 MediaWiki 需要您基本通曉虚拟主机的使用。 如果您对 Apache(网络服务器软件)、PHP 和 MySQL/MariaDB(数据库)有一定的经验,安装会更容易。 可在Project: Support desk获得更多帮助。

下面的附录部分提供了手动安装的替代方法,以及针对不同系统配置的具体安装说明。

如需更快速的本地安装,请参见本地开发快速入门

检查安装要求

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

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

下载MediaWiki软件

首先,你要先在官方下载页面下载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.4。

解压MediaWiki软件

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

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

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

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

上传文件到你的网页服务器

如果你还未将文件上传到你的网页服务器(或者進行复制,如果你的网络服务器软件是在你的localhost上本地运行的話),请先进行这一步操作。

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

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

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

如果您使用的是Apache HTTPD web服务器,那么正确的目录是由httpd.conf文件的DocumentRoot指令指定。 默认情况下为/var/www/<apache-folder>/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 example.com/wiki. 例如,如果你的服务器运行在http://localhost,使用/w/作为网站目录意味着你应该以http://localhost/w/index.php访问你的wiki。

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

配置数据库

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

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

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

MariaDB/MySQL 是推荐的数据库。PostgreSQL 和 SQLite 的支持有限,除非有理由,否则不应使用。 如果你不确定选择哪种数据库,那就用MariaDB。

完成数据库设置后,继续下面的#运行安装脚本

SQLite

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

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

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;

只有当您的数据库与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的安装:按照Manual:配置脚本 中的指示操作。

进一步配置

保持最新!

安装后,请确保您及时跟进版本,确保您的服务器安全!

订阅MediaWiki发行版本公告邮件列表

附录

手动安装的替代方法

手动安装通常是首选方法,因为它可以让用户更好地控制和了解他们的 wiki 是如何安装的,从而使故障排除和维护更容易。自动程序、软件包、捆绑包和服务都有其自身的特点。

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

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

参见comparison of distribution options

系统相关指南

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

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

运行多个wiki

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

导入现有的wiki数据库

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

参见