Manual:Installing MediaWiki/zh

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

MediaWiki installation requires basic familiarity with using a web host. It is easier if you have some experience with Apache (web server software), PHP and MySQL/MariaDB (database). Additional help is available at 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 are the recommended databases. PostgreSQL and SQLite have limited support and should not be used unless there is a reason to. 如果你不确定选择哪种数据库，那就用MariaDB.

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

SQLite
如果系统中已经安装了PHP的 模块，那么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. 具体内容请查看你所使用的服务器供应商提供的相应文件. 你也可以与你的托管服务提供商联系，让他们为您创建一个帐户.

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

只有当您的数据库与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 管理



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

附录


替代手动安装的方法
Manual installation is often the preferred method because it gives the user more control and insight into how their wiki is installed, making troubleshooting and maintenance easier. Automated processes, packages, bundles, and services all come with their own idiosyncrasies.

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

参见.



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

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



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



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

