Manual:Installing MediaWiki/zh

This page covers all steps to manually install and configure 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.

检查安装要求
Check that your system meets the installation requirements.

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

下载 MediaWiki 软件
从 official download page下载MediaWiki tar文件

Generally, if you're using a production environment, you want to be running the latest stable release, which is MediaWiki.

Extract the MediaWiki software
下载的文件是  格式，所以在使用前需要先从压缩文件中提取. 你需要在使用之前解压缩该压缩文件. 可以在本地提取并上传到服务器，或者上传压缩包然后在服务器上提取，或者直接在服务器上下载并提取.

在Windows上，这通常由7-Zip（免费）、WinZip、WinRAR或IZArc（免费）来完成.

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

上传文件到你的服务器
如果尚未将文件上载到Web服务器，请立即执行此操作.

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


 * 1) 直接复制解压的文件夹或
 * 1) 使用FTP客户端，如FileZilla（开源软件、Windows、OSX和Linux）或Cyberduck（OSX）.
 * 1) by using software already provided by your hosting service, such as the cPanel File Manager

如果您的上传工具有“将文件名更改为小写”选项，则必须禁用此选项.

如果您安装了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中拥有的任何内容. 如果您的Web服务器以 运行，例如，重命名为 目录意味着你将在 访问你的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.