前言

学习过程中可能遇到不同方面的知识，数量多了要靠脑袋组织还是太困难，自己会的东西要和朋友要分享沟通也非常麻烦。

而拥有一个自己的Wiki，就能解决这两个问题：1、自己对知识的整理；2、和其他人分享沟通。

现在有很多开源免费的软件，只要有一台个人电脑就能部署一个自己的Wiki环境，何乐而不为。

开源Wiki中比较流行的是 Mediawiki 和 Dokuwiki，有兴趣的话可以了解这两个Wiki。

我这里选的是 XWiki，形式上继承了 Mediawiki 和 Confluence，个人比较喜欢。

但是XWiki网上资料比较散，没有找到一个完整流程，中途也遇到中文字符相关问题，折腾了两天才搭起来，所以记录分享一下自己的部署过程。

（ 个人Web零基础，所以如果有需要，不要担心部署有困难，放手折腾 ）

（ 熟悉的话，不用一个小时就能搭起来自己Wiki ）

猫猫镇楼，效果如下：

一、安装配置流程

我这里选择的是 Tomcat 服务端 + MySQL 数据库 + XWiki的组合。

XWiki可以支持各种类型的服务端和数据库，具体可以看上面的官方安装文档，不必吊死在这一棵树上

大概流程如下：

1、Java环境配置（JDK）

2、Tomcat 作为Web服务器

2.1、Tomcat中文字符配置

3、MySQL Server & WorkBench，数据库管理Wiki条目

4、XWiki 安装配置

5、XWiki中文配置 与 搜索引擎中文配置

参考：

官方安装文档：www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/Installation/

油管安装流程视频：https://www.youtube.com/watch?v=HWvvgNjf9ng&ab_channel=allthingstechnical

二、提前准备文件

所需要的安装文件：

1. AdoptOpenJDK 11.0.17+8：https://adoptium.net/zh-CN/temurin/releases/?version=11 （Java环境）

2. MySQL Installer 8.0.32：https://dev.mysql.com/downloads/installer/ （建议下载400+MB的离线版本，不然要还要再等下载）

3. Apache Tomcat：https://tomcat.apache.org/ （Web服务端）

4. driver for mysql connector： https://dev.mysql.com/downloads/connector/j/

这里要选Platform Independent下载的才是Connector

5. XWiki：https://www.xwiki.org/xwiki/bin/view/Download/ 选一个喜欢的版本，想稳就选Long Term Support，无所谓就无脑最新版。

要下载两个文件，XWiki本体 .war包 和 初始主题 .xip 包。

6. XWiki 搜索引擎 中文分词器：https://repo1.maven.org/maven2/org/apache/lucene/lucene-analyzers-smartcn/ 用来让Wiki支持中文搜索

后面的详细步骤中也会给出需要应用的下载链接

三、详细过程

1、Java环境配置（JDK）

（这一步如果已经有了Java环境可以跳过）

直接下载Java安装完事。我这里直接用的默认路径安装。

JDK：OpenJDK11U-jdk_x64_windows_hotspot_11.0.18_10.msi

下载地址：https://adoptium.net/zh-CN/temurin/releases/?version=11

安装好后，右键我的电脑 -> 高级系统设置 -> 环境变量，检查添加JAVA_HOME系统变量配置，配置为安装的jdk路径。

​

配置完毕，打开cmd，输入java -version，如果正确输出了版本，这一步就算完成了。

2、Tomcat安装

这部分参考官方：https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/Installation/InstallationWAR/InstallationTomcat/

先下载Tomcat：https://tomcat.apache.org/

官网列了部分版本Tomcat不兼容，这里我的版本是8.5.87 apache-tomcat-8.5.87.exe Windows直接下载.exe安装

可以选其他兼容的版本

安装完毕，打开 Tomcatbinstartup.bat，在浏览器打开 localhost:8080，出现下面页面就算成功。

打开 Tomcatconfcontext.xml，在最后加上：

​打开 Tomcatconfserver.xml，在下图位置加上：（设置字符集为UTF-8，开启压缩）

2.1、Tomcat8中文字符配置（UTF-8）

【我的Tomcat版本是 8.5.87，如果是其他版本可能不会有这个问题】

Tomcat8关键：由于需要中文环境，需要在 Tomcatbincatalina.bat 文件里，加上一行：（否则会在后续传递中文到MySQL数据库的时候报错）

​

3、MySQL Server & WorkBench，数据库管理Wiki条目

这部分参考官方文档：https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/Installation/InstallationWAR/InstallationMySQL/

准备好MySQL Connector：mysql-connector-j-8.0.32.jar

下载MySQL 8.0.32 mysql-installer-community-8.0.32.0.msi

下载安装以下两个部分：

MySQL Server

MySQL Workbench 图形化界面，不用黑框框手敲指令

​

安装好后，先把 mysql-connector-j 文件放到 Tomcatlib 下，提供Tomcat到MySQL的连接。

然后打开 MySQL Workbench，建立一个连接Connection：localhost

建立新的Schema，命名为xwiki，并设置字符集为：utf8mb4 和 utf8mb4_bin

然后到 Query1 （或者MySQL控制台都行）输入下面的指令并执行：

然后再执行以下命令，将MySQL最大数据包大小改大（也可以手动到C:/ProgramData/下的MySQL路径中，找到MySQL配置文件，修改：max_allowed_packet=64M），防止后续导入 XWiki 包时出错。

4、XWiki 安装配置

下载 XWiki 压缩包：

XWiki：xwiki-platform-distribution-war-15.1.war

XWiki初始化主题 .xip 包：xwiki-platform-distribution-flavor-xip-15.1.xip

将 .war 包解压到 Tomcatwebappsxwiki 文件夹下（用解压缩应用直接解压 .war 包），可以得到以下文件：

接下来需要配置两个文件：

1、打开 TomcatwebappsxwikiWEB-INFxwiki.properties，找到 environment.permanentDirectory 字段，这个路径就会是以后Wiki数据存储的路径

将其解除注释（去掉前面的#号）设置路径为你希望存储Wiki数据的路径

environment.permanentDirectory = 数据路径

2、打开 TomcatwebappsxwikiWEB-INFhibernate.cfg.xml，配置XWiki与MySQL数据库连接

找到 hibernate.connection.url 的配置，将这部分字段注释或删掉，改为：

最后解压前面下载的 flavor-xip，将解压缩得到的文件，放到前面配置的XWiki数据data存储路径下：

到这里，XWiki就应当能够开始运行了。

打开 Tomcatbinstartup.bat，然后打开网页 http://localhost:8080/xwiki

如果看到XWiki的配置界面，前面的流程就算成功了。

注意：这里最好重启一次 Tomcat 和 XWiki 再进行后续配置，第一次打开 XWiki 可能无法正确识别下载好的 flavor离线包。

接下来按照XWiki的提示，注册管理员账号。（这个账号是最高权限的管理员账号，平时不需要的时候可以用普通账号登录）

接下来到XWiki的初始化主题，点击下面的Flavor，然后点击Install

由于前面用xip离线包提前获取了需要下载的文件，所以这里可以跳过下载，直接开始下一步安装

安装好后，点击下一步就可以来到开头的Wiki界面。（当然，你没有猫，现在界面也还没有汉化）

5、XWiki中文配置 与 搜索引擎中文配置

安装好 XWiki 后，会看到界面都是英文，还需要配置中文。

找到右侧侧边栏，点击个人头像，然后找到 Administer Wiki，然后到左侧，搜索 local，点击下面的 Localization，进行本地化配置。

将红框部分的，支持语言 和 默认语言，都配置为 中文(中国)，点击Save就可以看到界面汉化了。

XWiki中文配置，还只是进行了界面的汉化。实际使用会发现，搜索时还搜不到中文，这时候可以：

1、在查询配置中，将搜索引擎改为Database（但这种办法会缺少搜索细节、高亮提示等信息）：

2、对Solr搜索引擎进行中文配置：

先关闭 Wiki 和 Tomcat。

下载中文分词器：lucene-analyzers-smartcn-8.9.0.jar

将下载好的 .jar 文件，放入XWiki数据目录下的： Data数据路径storesolrsearchlib 中

​

然后配置文件：Data数据路径storesolrsearchconfmanaged-schema

在文件最后加上以下配置：

现在再打开 Tomcat，访问Wiki，等待搜索引擎索引完成，就能搜索中文了。