Manual:Installing MediaWiki/zh

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

注意：如果你没有Apache（网络服务器软件）、PHP、MySQL/MariaDB（数据库）的使用经验，那么对你而言，MediaWiki 的安装可能会比较困难. 下方的附录段落提供了更简单的替代方案.

下方的附录段落还提供了对于特定系统配置的安装提示.

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

确保还检查了你计划安装的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服务器，那么目录下的 ig文件会指定正确的目录. 默认情况下为 或.

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

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

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

如果您已经有一个数据库并且根（admin）用户的密码，可以直接跳到下面的1|#运行安装脚本段落.

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

由于MedaiWiki开发计划的影响，MedaiWiki目前仅支持SQLite、MariaDB、MySQL、PostgreSQL作为数据库驱动程序， 如果你不确定选择哪种数据库，那就用MariaDB.

After finishing the database setup, continue with below.

SQLite
如果系统中已经安装了PHP的 模块，那么1|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，则需要为您创建数据库和用户，或者只是为配置表单提供具有“超级用户”权限的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.