手册:安装 MediaWiki

手册:安装指南 | 关于 MediaWiki

功能列表 | 安装要求

下载 | 安装 | 配置

MediaWiki 可以通过内置的 Web 安装脚本完成安装。 参阅安装要求 和 快速安装指南 获得准备环境来运行安装脚本的详细信息 .

如果没有 Apache, PHP 和 MySQL/MariaDB 的使用经验的话，安装 MediaWiki 可能会很吃力。 因此更多的用户可能会考虑使用 MediaWiki 托管服务 或者 预先配置的软件包.

Manual:Errors and Symptoms#Installation Errors 提供了排解一般安装问题的指导。

下载 MediaWiki 软件

前往 下载页面来下载: 对于用于生产环境的一般情况推荐使用当前的稳定版本。

在 *nix 系统上 下载 MediaWiki 当前的稳定版本 1.31.1, 可以通过以下命令完成:

wget https://releases.wikimedia.org/mediawiki/1.31/mediawiki-1.31.1.tar.gz

或者使用 cURL:

curl -O https://releases.wikimedia.org/mediawiki/1.31/mediawiki-1.31.1.tar.gz

下载的文件是 .tar.gz 格式，所以在使用前需要先从压缩文件中提取。 可以在本地提取并上传到服务器，或者上传压缩包然后在服务器上提取，或者直接在服务器上下载并提取. 在Windows上，这通常由7-Zip（免费）、WinZip、WinRAR或IZArc（免费）来完成。 Linux 和 macOS 系统上可以通过这个命令来提取：

tar xvzf mediawiki-*.tar.gz

如果你以 root 用户提取文件，请考虑使用chown命令来修改文件的所有者，否则那些文件的所有者会是默认的 #1000。

开发者

为了即时跟踪最近的更改，开发者们请通过 Git 下载来建立本地存储库。 同时需要通过Composer安装必要的依赖。

上传文件到你的服务器

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

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

1. 直接复制解压的文件夹或
2. 使用FTP客户端，如FileZilla（开源软件、Windows、OSX和Linux）或Cyberduck（OSX）。

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

如果您安装了Apache，则会在httpd.conf文件中指定正确的目录（它是DocumentRoot指令，通常是/var/www/或<apache-folder>/htdocs）。 注意：这在Ubuntu 14.04 [与Apache 2.4.7的https://nixmash.com/post/changes-that-will-affect-you-in-apache-2-4-7/]中发生了变化，其中Apache服务器设置和目录的主要配置文件是/etc/apache2/apache2.conf。

如果您使用的是Linux或Unix服务器，则可以将文件复制到服务器上的任何目录，然后从Web服务器的Web目录中为该文件夹创建。

将上传的文件夹重命名为您希望在URL中拥有的任何内容。 如果您的Web服务器以http://localhost运行，例如，重命名为/w/目录意味着你将在http://localhost/w/index.php访问你的wiki。 如果您希望将其用作缩短URL的话，不要使用/wiki/。 （并且在运行安装脚本之前不要设置短URL。）

请注意，在某些情况下，例如在设置本地存储库使用Git时，在浏览到index.php时，Linux服务器可能会显示“500 Internal server Error”。 这可能是一个权限错误，可以通过在将目录更改为“w”后在SSH中运行以下命令来更改文件和目录权限时解决：

find . -type f -exec chmod 644 {} \;
find . -type d -exec chmod 755 {} \;

此（重命名）文件夹现在将被称为<MediaWiki-folder>。

创建数据库

如果您已有数据库服务器并且知道它的root密码，则MediaWiki安装脚本可以为您创建新数据库。 如果是这种情况，您可以跳到下面的运行安装脚本部分。 如果您不知道root密码，例如，如果您在托管服务器上，则必须立即创建新数据库。 目前，您必须使用SQLite、MariaDB、MySQL或PostgreSQL来存储Wiki的实际内容。

SQLite

SQLite是一个独立的数据库库，它将数据库内容存储在一个文件中。 如果 PHP 中启用了pdo-sqlite模块，那么没有什么其他步骤需要做的。

在安装页面上，您需要选择数据库名称（可以是任何内容）和SQLite数据库目录。 对于数据库目录，安装程序将尝试使用文档根目录之外的子目录，并在需要时创建它。 如果此目录不安全（例如Web可读），请手动更改它以避免Web上的每个人都可以访问它。

MariaDB/MySQL

MediaWiki将询问您是否有数据库和用户名，如果它们尚不存在，将尝试创建它们。 如果从MediaWiki这样做是不可能的，你可以使用各种控制面板，如，这些控制面板通常可以从共享主机获得，或者你可以使用SSH登录到您的主机并在MySQL提示符下键入命令。 请参阅相应的文档。 或者，与您的主机提供商联系，让他们为您创建一个帐户。

CREATE DATABASE wikidb;
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON wikidb.* TO 'wikiuser'@'localhost' WITH GRANT OPTION;

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

GRANT ALL PRIVILEGES ON wikidb.* TO 'wikiuser'@'mediawiki.example.com' IDENTIFIED BY 'password';

警告：	UNIX/Linux上的MySQL/MariaDB将发送给它的所有查询记录到一个文件中，该文件将包含您用于该用户帐户的密码。 如果这与您有关，请在运行这些查询后删除.mysql_history文件。 此文件可以在您的主目录（~/.mysql_history）中找到。

PostgreSQL

如果您使用的是PostgreSQL，则需要为您创建数据库和用户，或者只是为配置表单提供具有“超级用户”权限的PostgreSQL用户的名称。 通常，这是名为postgres的数据库用户。

这是完成大部分设置的一种方法。 这用于类Unix系统。 在这个例子中，我们将创建一个名为wikidb的数据库，由名为wikiuser的用户拥有。 从命令行，作为postgres用户，执行以下步骤。

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

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

CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'password';
CREATE DATABASE wikidb WITH OWNER wikiuser;

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

启动安装脚本

完成上述所有步骤后，您可以通过浏览器中的index.php通过Web浏览器完成安装：查看手册:初始配置 中提到的说明。

安装工具将提示您下载LocalSettings.php文件，并将其另存为<MediaWiki-folder>/LocalSettings.php。

或者，您可以运行命令行安装程序或CLI：php maintenance/install.php添加适当的配置参数。

保持最新！

订阅我们的发布公告邮件列表。

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

安装助理

• 阅读有关安装和配置的常见问题。
• 与MediaWiki开发人员、系统管理员和用户聊天：#mediawiki^连接
• mediawiki-l邮件列表是要求支持的高流量列表。

参见

• 手册:页面自定义列出MediaWiki消息链接到的Wiki页面，您需要创建这些页面或编辑消息。
• 手册:配置MediaWiki用于链接到更高级的配置。
• 手册:缩短URL用于具有更多用户友好的URL到文章页面。
• 手册:维基家族使用单组MediaWiki文件设置MediaWiki的多个实例。
• Help:模板
• 手册:备份一个wiki
• Manual:Moving a wiki
• Manual:Restoring a wiki from backup
• 指南:升级