当前位置：首页 > news >正文

开源知识库软件xwiki在Windows下的安装

news 2026/1/26 3:41:35

文章目录

开源知识库软件-xwiki在windows上的部署
- 0、参考文档
- 1、前置环境准备
- - 1.1、Windows版本及系统配置
  - 1.2、JDK11安装
  - 1.3、Tomcat9安装
  - 1.4、MySQL5.7数据库的安装
- 2、xwiki安装
- 3、配置
- - 3.1、修改配置支持对文档内容进行搜索
- 4、问题解决
- - 4.1、附件无法上传问题
  - 4.1、附件无法下载和删除问题

开源知识库软件-xwiki在windows上的部署

xwiki是java语言开发的开源知识库

0、参考文档

开源知识库软件-xwiki在windows下的安装：基本参考这个安装即可。

XWiKi 部分汉化

1、前置环境准备

1.1、Windows版本及系统配置

Windows10专业版，32GB内存

1.2、JDK11安装

1、xwiki15版本要求至少JDK11。
2、到oracle官网系在JDK11安装。
3、Java11安装以后在Windows的环境变量里配置JAVA_HOME，值就是JDK11的安装地址。如果不配置JAVA_HOME，接下来的Tomcat运行会报错。

1.3、Tomcat9安装

1、xwiki15版本要求至少Tomcat9及以上。
2、到Tomcat官网下载Tomcat9，解压缩即可。

1.4、MySQL5.7数据库的安装

1、xwiki15需要MySQL5.7版本（注意5.1.7不可以，会报错）。
2、安装了MySQL5.7后，创建一个数据库xwiki，并创建一个用户xwiki，将数据xwiki的所有权限（除了Grant外）均授权给xwiki用户。

2、xwiki安装

到xwiki官网下载war包，将war包解压缩，重命名为xwiki，放到Tomcat9的webapps目录下。
修改配置文件：xwiki\WEB-INF\hibernate.cfg.xml，注释掉默认的hsqldb数据库配置，使用MySQL的数据库配置，如下所示：

<!-- <property name="hibernate.connection.url">jdbc:hsqldb:file:${environment.permanentDirectory}/database/xwiki_db;shutdown=true</property>
<property name="hibernate.connection.username">sa</property>
<property name="hibernate.connection.password"></property>
<property name="hibernate.connection.driver_class">org.hsqldb.jdbcDriver</property>--><property name="hibernate.connection.url">jdbc:mysql://IP地址:端口号/xwiki?useUnicode=true&amp;characterEncoding=utf-8</property><property name="hibernate.connection.username">xwiki</property>
<property name="hibernate.connection.password">xwiki用户的密码</property>
<property name="hibernate.connection.driver_class">com.mysql.jdbc.Driver</property>

将MySQL的jdbc驱动 mysql-connector-java-5.1.49.jar，复制到xwiki\WEB-INF\lib目录下。
修改XWiki的默认工作路径，修改配置文xwiki/WEB-INF/xwiki.properties的environment.permanentDirectory=D:\apache-tomcat-9.0.73\webapps\wiki\data，也可以改为其他目录。
运行startup.bat启动Tomcat
访问http://localhost:8080/xwiki/，根据指引逐步初始化xwiki

3、配置

3.1、修改配置支持对文档内容进行搜索

默认的配置只支持对文档标题进行搜索，因此需要做如下配置实现对内容的搜索：

点击右上角如下图标
点击“管理wiki”
点击“查询”
点击“查询”
将“缺省的搜索引擎”由Solr改为Database即可。

4、问题解决

4.1、附件无法上传问题

一般这种问题是由于配置了nginx作为负载均衡，需要在nginx的http那里增加一句话：client_max_body size 1024m;如下所示：

4.1、附件无法下载和删除问题

1、查了下，官方FAQ宣称无法下载现象基本上都是环境问题。网络带宽、负载均衡配置、网络安全限制都可能造成附件无法下载,其中负载均衡节点可能会限制响应体大小。详见：https://kkxwiki.seeyoncloud.com/bin/viewrev/maintenance/%E5%B9%B3%E5%8F%B0%E5%AE%A2%E6%88%B7BUG_FAQ/WebHome?rev=2.1
2、然后我试了下不经过nginx，果然可以下载和删除。所以应该是nginx的问题。