公网Wiki站点搭建全流程攻略·小白向（含Parsoid和VisualEditor）

关键词：MediaWiki-1.34.2、Ubuntu 18.04、腾讯云、Wiki、VisualEditor、Parsoid

包含：打开VisualEditor时，Parsoid 404的一个解决办法，详见Parsoid安装部分。

大家好，我是johnbriton。最近我在为学院的一个竞赛团队搭建一个团队wiki，用来储存并分享我们前期调研所收集到的各种信息。作为一种知识管理系统，wiki的内链做的相当方便，而且方便设置权限，便于多人协同工作，适合团队使用。

由于本人的专业与计算机完全不相关，所以在搭建站点的时候踩了很多坑，而在专业人士看来，这些“坑”甚至没有必要解释。经过一段时间的使用，我发现Wiki是一个很有效的知识分享工具，而这个工具不应当只存在于计算机“专业人士”的视野范围内。写这篇文章的目的，也是希望Wiki这种好的工具能够帮到更多需要知识管理的团队。

文章比较长，由于是面向零基础小白，所以基本算是从“开天辟地”讲起了；而门外汉写的文章，里面也肯定有很多知识性的错误和不恰当的操作。希望能帮到大家，也请各位大佬多指教！

00 服务器和域名选购

我选用了腾讯云作为我的服务器供应商。如果你是学生，就使用腾讯云的学生认证，可以给你提供一个单核2G内存的服务器，一年大概120块钱左右。

本篇文章主题是公网wiki站点的建设，所以为了方便访问，同时也需要购买一个域名。建议也在腾讯云买域名，这样方便把域名解析（连接）到服务器的ip地址上。域名的价格和它后缀的文字有关。一般而言，众所周知的.com就比其他的文字要贵一些，这也算是市场经济规律。我买的域名是.top，因为刚好赶上腾讯云的优惠，五年的域名使用权只需要120多。

另外，强烈建议尽早购买域名！ 域名不是买来就能用的，而是需要经过实名认证和网信局备案的。这里有个坑：腾讯云的域名备案系统要求腾讯云账号注册48小时后才能备案，而登陆进去之后，系统会提示域名购买72小时之后才能备案。备案文件（主要是身份证照片和自拍）提交之后，腾讯云会打电话来确认信息，通过之后才能提交网信局备案。这个流程我到现在还没走完，所以我的wiki目前还只能用IP地址访问。

回到服务器的话题。当你购买服务器时，一般会有如下几个系统可选（截至2020.8.22）：

• Windows Server 2012 R2数据中心版 64位中文版
• Ubuntu Server 16.04.1 LTS 64位
• CentOS 7.2 64位

首先排除Windows，觉得Linux显得更厉害一些。其次，Linux的不同发行版（种类）之间，包管理器（下载服务时敲的代码）也稍有不同。Ubuntu据说是使用最为广泛的一种Linux操作系统（注：网上关于Debian的教程，Ubuntu也可以用），所以我就选了Ubuntu。尽管后来发现网上的教程更多还是针对CentOS，但Ubuntu里各种服务的下载还是相对更方便。

购买成功之后，你会获得一个初始密码，可以用于登录你的服务器。服务器不需要审核，可以随时使用。

01 基于Ubuntu的基本环境配置

i 软件

强烈建议在你自己的电脑里下载WinSCP软件，输入[用户名]:[你的ip地址]后就可以登录，密码和服务器的密码一样。下载之后可以直接在系统之间传文件。

vncserver是一个远程桌面软件，安装费时费力，而且占用服务器内存相当严重，教程在此。大多数操作尽量还是在命令行里解决，这样占用内存相当少。但如果涉及到文字编辑，图形界面还是很有必要的。还是建议使用腾讯云自带的VNC登录方式，不要自己搭vncserver。

有些服务可能会出现无法安装，请自行研究镜像等解决方案。

ii 基本服务的安装

首先介绍下命令行的基本使用方式。

cd /a/bb/.c #将当前所在位置切换为a文件夹下的bb文件夹下的.c文件夹。注意：.c文件夹是隐藏的。
cd .. #返回上级文件夹
ls #查看当前目录下的所有文件和文件夹，不包括隐藏文件夹
ls -a #查看当前目录下的所有文件和文件夹，包括隐藏文件夹
sudo #可以理解为“以管理员身份运行”。
su #切换为root管理员权限
su ubuntu #切换回普通用户权限，此处用户名为ubuntu

以上是基本的命令行操作方式。

sudo apt-get install apache2 mysql-server php php-mysql libapache2-mod-php php-xml php-mbstring

之后重启apache2¹。

sudo service apache2 reload

可选的软件包，为了以防万一还是全部安装上：

sudo apt-get install php-apcu php-intl imagemagick inkscape php-gd php-cli php-curl git

iii 基于Clash设置系统黛礼

02 安装和配置MediaWiki

i 配置Apache

网络与防火墙

如果你刚才（基于Ubuntu的基本环境配置-基本服务安装）已经成功安装了Apache，则你应该可以在防火墙的应用名单中看到Apache的身影：

sudo ufw app list
# 以下为系统输出的内容
Available applications:
  Apache
  Apache Full
  Apache Secure
  OpenSSH

然后查看Apache Full的档案，你应当可以看到它允许80和443端口的数据：

sudo ufw app info "Apache Full"
# 以下为系统输出的内容
Profile: Apache Full
Title: Web Server (HTTP,HTTPS)
Description: Apache v2 is the next generation of the omnipresent Apache web server.

Ports:
  80,443/tcp

然后在防火墙中放行进入Apache Full的流量：

sudo ufw allow in "Apache Full"
sudo systemctl restart apache2

接下来，请试着找到服务器的公网IP。对于腾讯云服务器，其公网IP可以在控制台中找到。如果控制台中没有，可能是你的页面缩放问题，请将浏览器窗口最大化后刷新。

还有一种查看IP地址的方法：

sudo apt install curl
curl http://icanhazip.com

此方法显示出的IP地址即为电脑的公网IP。

另一个通用的方法是：

ip addr show eth0 | grep inet | awk '{ print $2; }' | sed 's/\/.*$//'

你将看到2-3个IP地址，但你的电脑只能使用其中的一个，所以请你依次尝试一下。

这时，如果你直接在浏览器里输入你的电脑IP，应当会出现这样的页面：

如果你成功看到了这个页面，说明你的Apache2已经正确配置了。如果看不到，首先去/var/www/html目录下面看看，是否有index.html这个文件。如果没有，说明你的apache没能成功安装。如果有，就请再检查一下防火墙的设置。

文件格式检索顺序

刚才我们看到的页面是由html文件生成的静态网页，而MediaWiki是一种由PHP语言编写成的动态网页。Apache在读取网站的运行文件时，总会先找到一个叫做index的文件，再从index中读取它想要运行的其他内容。

因此，我们希望MediaWiki所使用的php文件能够先于html文件被找到并访问。为此，我们需要到Apache的文件夹中改变其配置文件中不同格式文件的读取顺序。输入：

sudo vim /etc/apache2/mods-enabled/dir.conf

之后你将看到这样的显示内容：

<IfModule mod_dir.c>
    DirectoryIndex index.html index.cgi index.pl index.php index.xhtml index.htm
</IfModule>

解释一下刚才的命令中vim的含义：vim是linux系统的一个文件编辑器，可以在命令行环境下使用。打开文件后，你会发现你无法修改，这时按I键进入INCERT模式后，便可以移动光标进行修改。

将内容中的index.php移动至最前方，仅次于DirectoryIndex的位置，如下所示：

<IfModule mod_dir.c>
    DirectoryIndex index.php index.html index.cgi index.pl index.xhtml index.htm
</IfModule>

修改完成后，按下esc键退出INCERT模式，并输入:wq（半角冒号+