手册:安装指南

This page is a translated version of the page Manual:Installation guide and the translation is 100% complete.

MediaWiki安装指南将介绍如何在一台服务器上手动安装并配置MediaWiki,手动和更简单的替代安装多个维基安装现有维基也包括在内。 附录提供指向特定系统配置和该软件的其他不太常用的用途的更详细的安装说明的链接。

升级指南

如果你已经在使用 MediaWiki,请参阅升级指南

手动安装

摘要

由于上游漏洞,MediaWiki与PHP 7.3.0 - 7.3.18和7.4.0 - 7.4.2不兼容。 请使用PHP 7.3.19+或7.4.3+代替。 参见任务T246594以获取更多信息。

对于有经验的用户,这里是安装说明的快速版。但是大多数用户(例如,如果您不知道如何在电脑上安装或检查必备软件)都可能需要按照主要安装指南

  1. 检查您的系统是否符合以下的最低配置要求。 (有关更多详细信息,请参见安装要求。 确保还要检查MediaWiki附带的发行注记是否符合要求。) 你将会需要: 缩略图需要扩展程序支持。Parsoid (用于可视化编辑器)及其他服务亦有各自配置需求。
  2. # 下载 MediaWiki (下载公开稳定版的直接链接)并将其解压到您电脑上可被Web浏览的目录中。
  3. 使用浏览器访问MediaWiki被解压的目录并按照提示操作。 安装指南通常位于http://domain/directory/mw-config/index.php。 将 directory 换成您MediaWiki的解压位置。 如果是本地安装的话将 domain 替换成localhost。 如果您是在本地安装的,并且稍后想通过domain访问,您需要将LocalSettings.php 由localhost改为 domain。 如果是在远程服务器上安装,将 domain 替换为您的域名 (如: www.myserver.com)。
  4. 根据屏幕提示 完成后面的步骤。

上述内容只是一个简要说明,也许会出错,所以,如果有任何不确定的地方,建议你还是阅读下面的完整安装说明

详细安裝指南

替代手动安装的方法

如果您阅读上面的内容并开始思考—或您感到沮丧,失望或困窘—愚见认为以下内容比较适合您:

您可以通过使用一个预集成的 MediaWiki 软件包或者主机的一键安装或者wiki集合功能跳过手工安装.

如果您是出于开发或测试目的安装MediaWiki, 可以考虑使用 MediaWiki-Vagrant. 这是一套用于自动配置能运行MediaWiki及相关扩展程序服务的虚拟机的Vagrant配置脚本。

官方docker映像在Docker Hub上发布。

您还可以使用基于平台的社区资源,例如:Docker。 这是由Jenkins管理的,且应该在一段时间内保持更新。

这些是基于社区的资源,总是应该谨慎对待。并自负风险。

  警告: 由主机商提供的程序如MediaWiki很可能出现一些导致错误和失败的安装问题。如果您不幸遭遇此类问题,并非意味着无法安装MediaWiki。您需要做的是按照手动安装步骤自行安装。这么做的好处包括自由地决定安装位置、可以使用共享的数据库、能够控制更多Wiki特性等。

Wiki家族(多个Wiki)

首页: 手册:Wiki农场

Wiki系列指在同一主机上安装多个Wiki。

安装多个MediaWiki

若您安装了MediaWiki的多个实例(例如,使用像Bitnami MediaWiki Stack这样的软件包),在不同目录中,每个Wiki一个。 例如,您分别需要一个企业wiki和一个个人wiki,并且您想将他们分别管理。

多个wiki在一个wiki中

您可以将单个MediaWiki用于安装多个wiki中,以下:

  1. 您的每一个wiki使用各自不同的数据库 参见$wgDBname
  2. 为每个wiki使用不同的数据库前缀。 参见$wgDBprefix

安裝在现有wiki上

部分用户希望在安装MediaWiki的同时安装维基百科(Wikipedia),维基词典(Wiktionary)或者是其他的wiki配套。这对于离线阅读或是实验很有帮助。

这样做的主要方法(但不是最简单的方法)是先安装MediaWiki再进行导入。 Manual:FAQ#Wiki importing

(非MediaWiki方法,例如Xowa和Kiwix可以在w:Wikipedia:Database download获得。

俗话说:不积跬步,无以至千里。我们建议您先尝试安装一个小型wiki,例如简版的英文维基百科(Simple English Wikipedia)以做测试,然后再下载一个大型wiki,例如正式版英文维基百科(English Wikipedia)。

附录

高级用法

这些页面介绍了如何用不常见的方法来安装和配置 MediaWiki

高级配置

这些页面介绍了更多更高级配置选项:

安装助理

系统相关指南

以下页面针对特定系统提供更详细的安装指南。不过手册:安装 MediaWiki 是最新的,而且优于特定系统版本,因此我们建议您在阅读其他系统安装文档前先阅读手册:安装 MediaWiki


注释

其它参考资料