XWiki知识库搭建教程:从零开始部署个人与企业Wiki系统

2025-10-19 软件资源 566 次阅读 0 次点赞
本教程完整介绍如何使用开源XWiki平台构建知识库系统,从JDK21环境准备到XWiki标准化安装,详细解析启动脚本配置技巧,包括内存优化、端口修改、中文支持等实用配置,并提供首次访问和界面设置指导,帮助技术用户快速部署功能完善的个人或企业级知识管理平台。

XWiki是一个免费开源的java开发的wiki,界面美观,功能强大,适合用于创建个人和企业知识库。本文将帮助你在本地安装一个个人知识库。

安装配置

1、下载JDK21并安装。

下载地址:https://www.oracle.com/java/technologies/downloads/#java21

JDK21下载页面

2、从XWiki官方网站下载最新长期支持预装了Standard Flavor的XWiki版本。

下载地址:https://www.xwiki.org/xwiki/bin/view/Download/

XWIki下载页面

XWiki下载标准版

3、解压下载的 xwiki-platform-distribution-flavor-jetty-hsqldb-16.10.12.zip。

XWIki软件安装目录

4、编辑文件start_xwiki.bat,修改以下内容。

(1)在 @echo off 下面增加 @chcp 65001,保证命令行输出的是中文。

XWiki修改汉字编码

(2)修改 if not defined XWIKI_OPTS set XWIKI_OPTS=-Xmx1024m 一行中的 -Xmx1024m 为 -Xmx2048m,占用内容稍微大一些,会更加流畅。(可选)

(3)修改  set JETTY_PORT=8080一行中的 8080 为 9900,可以修改xwiki端口。(可选)

XWIki修改监听端口

(4)在if not “%JAVA_HOME%” == “” set JAVA_PATH=%JAVA_HOME%\bin\java.exe 下面增加一行 set JAVA_PATH=%~~dp0jdk-21.0.2\bin\java.exe,设置 JAVA_PATH为你安装JDK 21中java.exe的路径。这样就不需要配置环境变量。

XWIki修改使用的JDK

(5)在文件末尾的PAUSE注释掉,改成REM PAUSE。如果使用windows服务方式启动,不注释绘制到一直启动中。(可选)

XWIki脚本去掉pause

5、编辑文件 stop_xwiki.bat,也做类似修改。(可选)

6、双击start_xwiki.bat启动。

XWiki启动终端

7、在浏览器种访问以下地址,第一次访问会进行安装。

http://localhost:8080/

默认用户名:Admin

默认密码:admin

8、安装好后的效果图。

XWiki首页

常见问题

1、如果把XWiki改为中文。

参考 XWiki默认语言改为中文 这篇文档。

最后更新于21小时前
本文由人工编写,AI优化,转载请注明原文地址: XWiki知识库搭建教程:从零开始部署个人与企业Wiki系统

评论 (2)

登录 后发表评论

刘一刀刘一刀2025-12-03 13:50:56

教程非常详细,配图清晰,一步步跟着做成功在本地启动了XWiki。特别感谢作者分享修改启动脚本的实用技巧,省去了配置环境变量的麻烦!

凯文王凯文王2025-11-13 10:53:46

教程很详细,特别是修改start_xwiki.bat的步骤,省去了配置环境变量的麻烦。感谢作者分享!