Manual:安装MediaWiki
此页面概括了手动安装 MediaWiki所需要的步骤。安装完成后,进行额外配置的细节可在手册:系统管理#配置中找到。
安装 MediaWiki 需要您基本通曉虚拟主机的使用。 如果您对 Apache(网络服务器软件)、PHP 和 MySQL/MariaDB(数据库)有一定的经验,安装会更容易。 可在Project: Support desk获得更多帮助。
下面的附录部分提供了手动安装的替代方法,以及针对不同系统配置的具体安装说明。
如需更快速的本地安装,请参见本地开发快速入门 。
检查安装要求
首先,你需要检查您的系统是否符合以下的最低配置要求。
确保还检查了你计划要安装的MediaWiki版本的发行版本说明 。
下载MediaWiki软件
首先,你要先在官方下载页面下载MediaWiki压缩包文件。
If you are using MediaWiki in a production environment, the release manager has issued a strong recommendation that only versions listed at Version lifecycle and their end-of-life as the current "stable version", "legacy version" or "long-term support version" should be used in a production environment. Older versions may contain critical security vulnerabilities and other major bugs, including the threat of possible data loss and/or corruption. 一般来说,如果你正在使用一個生产环境,你会想要运行最新的稳定发行版本,即MediaWiki 1.42.4。
解压MediaWiki软件
你下载的文件是.zip
或者.tar.gz
格式,
你使用前需要先解压这个压缩包。
你可以本地解压缩文件(然后通过FTP上传到服务器)或者直接在服务器上解压。
在Windows上,一般是利用7-Zip(免费)、WinZip、WinRAR或IZArc(免费)解压缩文件,他们的便利性无需多言。
Linux和macOS系统上可以通过这个命令来解压:
tar -xzvf mediawiki-*.tar.gz
chown -R <new_owner_user> <mediawiki_folder>
更多信息请见:手册:安全#文件权限
上传文件到你的网页服务器
如果你还未将文件上传到你的网页服务器(或者進行复制,如果你的网络服务器软件是在你的localhost
上本地运行的話),请先进行这一步操作。
通过以下方式将文件上传到网页服务器的网页目录:
- 直接复制未解压的文件夹,或者
- 使用FTP客户端上传文件,例如FileZilla(Windows、OSX和Linux)或Cyberduck(Windows和OSX)。
- 通过你使用的网站托管服务提供的软件,例如cPanel文件管理器
如果你的上传工具有“将文件名更改为小写”这类选项,在上传之前必须先禁用此选项,以免出现未知错误。
如果您使用的是Apache HTTPD web服务器,那么正确的目录是由httpd.conf
文件的DocumentRoot
指令指定。
默认情况下为/var/www/
或<apache-folder>/htdocs
。
Apache服务器设置和目录文件httpd.conf
的准确位置取决于你的操作系统。
在Debian和Ubuntu中,管理Apache服务器设置和目录的文件为/etc/apache2/apache2.conf
。
对于Red Hat和Fedora,这个文件是/etc/httpd/conf/httpd.conf
。
将上传的文件夹根据您希望在URL中使用的路径重命名。
For example, if you rename the folder to wiki
, the URL will reflect this as example.com/wiki
.
例如,如果你的服务器运行在http://localhost
,使用/w/
作为网站目录意味着你应该以http://localhost/w/index.php
访问你的wiki。
配置数据库
由于MediaWiki会在数据库中存储所需要的相关数据,因此,安装脚本会要求你提供数据库的相关信息,
如果您已经有一个数据库并知道“root”(管理员)用户的密码,可以直接跳到下面的#运行安装脚本章节。
如果你不知道根用户的密码,或者在托管的服务器上,你可能需要创建一个新的数据库,然后再运行下一个章节中的MediaWiki安装脚本。
MariaDB/MySQL 是推荐的数据库。PostgreSQL 和 SQLite 的支持有限,除非有理由,否则不应使用。 如果你不确定选择哪种数据库,那就用MariaDB。
完成数据库设置后,继续下面的#运行安装脚本。
SQLite
如果系统中已经安装了PHP的pdo-sqlite
模块,那么SQLite无需进一步的设置了。
在SQLite安装页面上,您需要填写数据库名称(可以是任何内容)和SQLite数据库目录。 对于数据库目录,安装程序将会尝试使用文档根目录之外的子目录,并在需要时创建目录。 如果此目录不安全(例如Web可读),请更改目录权限,以免让网络上的所有人都可访问。
MariaDB/MySQL
- 使用托管服务商提供的控制面板软件(例如:PhpMyAdmin)
- 使用 SSH 登录到你的主机并在 MySQL 提示符中键入以下命令。 具体内容请查看你所使用的服务器供应商提供的相应文件。 你也可以与你的托管服务提供商联系,让他们为您创建一个帐户。
下面的命令创建了一个名为my_wiki
的数据库,同时创建了名为wikiuser
的用户,并为这个账号设置好了权限。
CREATE DATABASE my_wiki;
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'database_password';
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'localhost' WITH GRANT OPTION;
只有当您的数据库与web服务器不在同一台服务器上运行时,您才需要提供适当的web服务器主机名(在下面的示例中为mediawiki.example.com
):
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'mediawiki.example.com' IDENTIFIED BY 'database_password';
PostgreSQL
如果您使用的是PostgreSQL,则需要为您创建数据库和用户,或者为配置表单提供具有“superuser”权限的PostgreSQL用户的名称。
通常,这是名为postgres
的数据库用户。
Linux命令行中的以下命令,作为postgres用户,创建名为wikiuser
的数据库用户,以及名为my_wiki
的数据库,其拥有者的名称为wikiuser
。
createuser -S -D -R -P -E wikiuser (然后输入数据库密码) createdb -O wikiuser my_wiki
或者作为超级用户(默认postgres)在数据库提示符下执行以下命令:
CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'database_password';
CREATE DATABASE my_wiki WITH OWNER wikiuser;
注意使用PostgreSQL运行MediaWiki时已知问题的列表。
运行安装脚本
接下来,在你的web浏览器中转到MediaWiki安装的URL,完成MediaWiki的安装:按照Manual:配置脚本 中的指示操作。
进一步配置
保持最新!
安装后,请确保您及时跟进版本,确保您的服务器安全!
附录
手动安装的替代方法
手动安装通常是首选方法,因为它可以让用户更好地控制和了解他们的 wiki 是如何安装的,从而使故障排除和维护更容易。自动程序、软件包、捆绑包和服务都有其自身的特点。
这些替代的选项或许更加容易,不需要手动安装MediaWiki:
- 提供自动安装MediaWiki等应用程序的托管服务可能会提供过时的版本或存在其他问题。如果您遇到问题,「并不是」意味着您无法安装MediaWiki。这意味着您应该手动安装MediaWiki。
参见comparison of distribution options 。
系统相关指南
手册:操作系统特定帮助 列举的页面会提供针对特定系统的详细安装指导。
但是,总的来说,这些为特定系统系统的文档很少维护,并且可能并不总是最新的。 在查看每个系统的安装文档之前,请先阅读安装MediaWiki (此页面)。
运行多个wiki
参见手册:FAQ#安装和配置。
导入现有的wiki数据库
参见手册:FAQ#安装和配置。