Manual:Installing MediaWiki/zh

此页面涵盖手动安装 MediaWiki 的步骤，其他配置步骤可在手册:系统管理#配置中找到.

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

下面的附录部份提供了手动安装的替代方法. 它还提供了对于特定系统配置的安装提示.



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

确保还检查了你计划要安装的MediaWiki版本的.



下载MediaWiki软件
首先，你要先在官方下载页面下载MediaWiki压缩包文件.

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



解压MediaWiki软件
你下载的文件是 或者 格式， 这意味着在你使用前需要先解压这个压缩包. 你可以本地解压缩文件（然后通过FTP上传到服务器）或者直接在服务器上解压.

在Windows上，一般是利用7-Zip（免费）、WinZip、WinRAR或IZArc（免费）解压缩文件，他们的便利性无需多言.

Linux和macOS系统上可以通过这个命令来解压：



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

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


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

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

如果您使用的是Apache HTTPD web服务器，那么正确的目录是由 文件的指令指定. 默认情况下为 或.

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

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



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

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

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

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

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

SQLite
如果系统中已经安装了PHP的 模块，那么SQLite无需进一步的设置了.

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

MariaDB/MySQL
创建 MariaDB/MySQL 数据库和数据库用户. 有几种方法：


 * 使用托管服务商提供的控制面板软件（例如：PhpMyAdmin）
 * 使用 SSH 登录到你的主机并在 MySQL 提示符中键入以下命令. 具体内容请查看你所使用的服务器供应商提供的相应文件.  你也可以与你的托管服务提供商联系，让他们为您创建一个帐户.

下面的命令创建了一个名为 的数据库，同时创建了名为 的用户，并为这个账号设置好了权限.

只有当您的数据库与web服务器不在同一台服务器上运行时，您才需要提供适当的web服务器主机名（在下面的示例中为 ）：

PostgreSQL
如果您使用的是PostgreSQL，则需要为您创建数据库和用户，或者为配置表单提供具有“superuser”权限的PostgreSQL用户的名称. 通常，这是名为 的数据库用户. Linux命令行中的以下命令，作为postgres用户，创建名为 的数据库用户，以及名为 的数据库，其拥有者的名称为.

createuser -S -D -R -P -E wikiuser （然后输入数据库密码） createdb -O wikiuser my_wiki

或者作为超级用户（默认postgres）在数据库提示符下执行以下命令：

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



运行安装脚本
接下来，在你的web浏览器中转到MediaWiki安装的URL，完成MediaWiki的安装：按照中的指示操作.



进一步配置

 * - 附加配置
 * - wiki 管理



保持最新！
安装后，请确保您及时跟进版本，确保您的服务器安全！

附录


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

这些替代的选项或许更加容易，不需要手动安装MediaWiki：
 * 预集成的软件设备
 * 一键安装的托管服务，或者维基农场

参见.



系统相关指南
列举的页面会提供针对特定系统的详细安装指导.

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



运行多个wiki
参见手册:FAQ#安装和配置.



导入现有的wiki数据库
参见手册:FAQ#安装和配置.

