Manual:Installing MediaWiki/zh

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

注意：如果你没有Apache（网络服务器软件）、PHP、MySQL/MariaDB（数据库）的使用经验，那么对你而言，MediaWiki 的安装可能会比较困难. The Appendices section below offers easier alternatives to manual installation.

The Appendices section below also provides installation notes for specific system configurations.

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

Make sure to also check the of the MediaWiki version that you plan to install.

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

Generally, if you're using a production environment, you want to be running the latest stable release, which is 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，则会在 文件中指定正确的目录（它是[$docroot DocumentRoot]指令，通常是 或 ）. By default, this is  or.

The exact location of the Apache server settings and directories file  depends on your operating system. 注意：这在Ubuntu 14.04 与Apache 2.4.7的中发生了变化，其中Apache服务器设置和目录的主要配置文件是. In Red Hat and Fedora, the file is.

将上传的文件夹重命名为您希望在URL中拥有的任何内容. 例如，如果你的网站URL是 ，你的网站目录在 ，意味着你应该在 访问你的Wiki.

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

如果您已有数据库服务器并且知道它的root密码，则MediaWiki安装脚本可以为您创建新数据库.

如果您不知道root密码，例如，如果您在托管服务器上，则必须立即创建新数据库.

目前，您必须使用SQLite、MariaDB、MySQL或PostgreSQL来存储Wiki的实际内容. If you're unsure which database to choose, use MariaDB.

After finishing the database setup, continue with below.

SQLite
No further setup is required for SQLite if the  module for PHP is installed on the system.

在安装页面上，您需要选择数据库名称（可以是任何内容）和SQLite数据库目录. 对于数据库目录，安装程序将尝试使用文档根目录之外的子目录，并在需要时创建它. 如果此目录不安全（例如Web可读），请手动更改它以避免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. 请参阅相应的文档. 或者，与您的主机提供商联系，让他们为您创建一个帐户.

The following commands create a database named, a user named  , and set permissions for the user on that database.

如果您的数据库未在与Web服务器相同的服务器上运行，则需要提供相应的Web服务器主机名，以下示例中的mediawiki.example.com，如下：

PostgreSQL
如果您使用的是PostgreSQL，则需要为您创建数据库和用户，或者只是为配置表单提供具有“超级用户”权限的PostgreSQL用户的名称. 通常，这是名为postgres的数据库用户. The following commands on a Linux command-line, as the postgres user, create a database user named, and a database named   owned by the user named.

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

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

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

启动安装脚本
完成上述所有步骤后，您可以通过浏览器中的index.php通过Web浏览器完成安装：查看中提到的说明.

Further configuration

 * - Additional configuration
 * - Wiki administration

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

Alternatives to manual installation
Instead of manually installing MediaWiki, alternative options might be easier:
 * pre-integrated software appliances
 * hosting services with 1-click installation, or wiki farms

See also the.

System-specific instructions
The pages listed on give more detailed installation instructions aimed at specific systems.

However, by and large these per-system docs are less maintained and might not always be up to date. First consult (this page) before looking at per-system installation documentation.

Running multiple wikis
Refer to Manual:FAQ#Installation and configuration.

Importing an existing wiki database
Refer to Manual:FAQ#Installation and configuration.