XWiki 介绍与选型指南

XWiki 企业级开源 Wiki 与低代码应用平台的联网溯源选型指南：定位与架构、嵌套页面+结构化数据+应用内编程三大差异化能力、与 MediaWiki/DokuWiki/Confluence/Wiki.js/BookStack 的量化对比，数据查询日期 2026-10-22。

XWikiXWikiWiki知识库2026/10/22

XWiki 介绍与选型指南

目标：面向正在为团队/企业选型知识库与协作 Wiki 平台的读者，基于官方站点、官方仓库与官方镜像源的联网溯源（查询日期 2026-10-22），讲清 XWiki 的定位、「二级维基嵌套 + 结构化数据 + 应用内编程」三大差异化能力，并与 MediaWiki、DokuWiki、Confluence、Wiki.js、BookStack 做量化选型对比。

一、环境信息

本文为认知选型篇，所有结论均来自官方渠道的联网溯源，未做本地实测验证；部署实测与命令回显见本专栏配套的部署、配置与命令三篇。

  • 溯源对象与查询日期：2026-10-22
  • 溯源渠道：
    • 官方站点：https://www.xwiki.org （Compare 对比页、Features、License）
    • 官方仓库：https://github.com/xwiki/xwiki-platform （Releases 页）
    • 官方容器镜像：Docker Hub xwiki 官方镜像（Docker Official Image）
    • 社区活跃度取证：shields.io 徽章 JSON（https://img.shields.io/github/stars/<owner>/<repo>.json），未直连 GitHub API
  • 版本信息（实查结果）：
    • 最新稳定版：18.8.0（GitHub Release 发布于 2026-09-29；Docker Hub stable 漂移 tag 与 18.8.0-postgres-tomcat 摘要一致，实测比对 digest 前 14 位均为 sha256:13ee48698a658）
    • 年度维护线：18.4.7（GitHub Release 发布于 2026-10-15，Docker Hub 同步更新于 2026-10-17）
    • 现行 LTS 线：17.10.14（GitHub Release 发布于 2026-10-15）
    • 上一代 LTS 线：16.10.19（GitHub Release 发布于 2026-10-02，仍在补丁维护）
    • 预发布：18.9.0-rc-1（2026-10-19 发布，表明 18.9.0 即将发布）

二、软件概述

2.1 XWiki 是什么

XWiki 官方定位为一句话：「The Advanced Open Source Enterprise and Application Wiki」（高级开源企业级与应用 Wiki），来源：xwiki.org 站点全站标题（查询日期 2026-10-22）。它不只是"可多人编辑的网页集合"，而是在经典 Wiki 能力之上，内置了结构化数据模型、嵌套页面组织与应用开发能力，使其可以直接充当企业知识库（Knowledge Base）、协作内网（Collaborative Intranet）与对外资源中心（Resource Center），来源：xwiki.org《Compare XWiki》页（https://www.xwiki.org/xwiki/bin/view/Compare/ ，页面最近修改 2026-10-09，作者 Thomas Mortagne；查询日期 2026-10-22）。

核心身份信息（来源与查询日期标注）：

属性值来源查询日期
软件性质开源企业级 Wiki + 轻量应用平台xwiki.org 全站定位语2026-10-22
开源许可LGPL 2.1xwiki.org License 页（https://www.xwiki.org/xwiki/bin/view/Main/License）2026-10-22
开发语言/运行时Java（Servlet 容器承载，官方镜像内置 Tomcat）官方 Docker 镜像 flavor 命名 *-tomcat2026-10-22
支持数据库PostgreSQL / MySQL / MariaDB（官方镜像 flavor），另有 HSQLDB（内嵌演示默认）等Docker Hub xwiki 镜像 tag 体系（18.8.0-postgres-tomcat / 18.8.0-mysql-tomcat / 18.8.0-mariadb-tomcat）2026-10-22
部署形态单机部署（Tomcat/Web 容器 + 外置数据库）；官方 Docker 镜像为 Docker Official Image（累计拉取 3495 万+）Docker Hub library/xwiki 仓库元数据2026-10-22
治理模式XWiki Org 社区治理 + XWiki SAS 商业公司参与（提供专业支持）xwiki.org Support 页导航（Community Support / Professional Support）2026-10-22
扩展生态extensions.xwiki.org 扩展仓库（官方独立站点）xwiki.org 导航 Projects → XWiki Extensions2026-10-22

2.2 项目历史与版本节奏

XWiki 是历史悠久的开源 Wiki 项目，第一个版本发布于 2003 年（来源：xwiki.org 项目介绍与维基百科词条交叉印证，查询日期 2026-10-22）。从 GitHub Releases（xwiki/xwiki-platform，查询日期 2026-10-22）实查其版本节奏：

  • 年度大版本：每年一个大版本号（2024 年 16.x、2025 年 17.x、2026 年 18.x），大版本内按月发布特性小版本（2026 年内已发布 18.4、18.7、18.8，18.9 处于 RC 阶段）。
  • LTS 机制：上一年度的 10 月版本成为 LTS 长期支持线——现行 LTS 为 17.10.x（最新补丁 17.10.14，2026-10-15 发布），上一代 LTS 16.10.x（最新补丁 16.10.19，2026-10-02 发布）仍在维护。
  • 多条维护线并行：2026 年 10 月的前三周内，18.8.0、18.4.7、17.10.14、16.10.19 四条线均有补丁发布，版本维护相当活跃。
  • Docker 漂移 tag：官方镜像提供 stable（当前最新稳定版，实测指向 18.8.0）与 lts（LTS 线，指向 17.10.x）两个自动跟随的便捷 tag，生产环境建议锁定具体版本号 tag。

💡 说明：生产选型建议——追求新特性选 stable 对应版本（当前 18.8.0）；保守生产环境选 LTS 线（17.10.14）；两者官方均持续出补丁。若从旧 LTS 升级，参考官方升级路径文档逐大版本迁移。

三、核心架构

以下内容溯源自 xwiki.org 官方文档导航与官方镜像结构（查询日期 2026-10-22），未做本地实测。

3.1 总体架构

XWiki 采用经典的 Java Web 应用架构，自上而下分四层（来源：xwiki.org Documentation → Developer Guide → Architecture 导航，https://www.xwiki.org/xwiki/bin/view/Documentation/DevGuide/ ）：

  1. Web 层：Servlet 容器（官方镜像内置 Tomcat）承载 WAR 应用，处理 HTTP 请求、渲染页面。
  2. XWiki 平台层（xwiki-platform）：核心 Wiki 引擎，包含页面模型、权限系统、渲染引擎、脚本引擎、REST API、通知/调度等基础服务；以组件（Component）架构组织，几乎所有平台服务都是可替换的组件。
  3. XWiki Commons / Rendering：公共库与渲染引擎子项目，负责多语法输入（XWiki 2.1 语法、Markdown 等）到统一输出的渲染管线，是独立于平台发布的复用组件（来源：GitHub org xwiki 下的 xwiki-commons、xwiki-rendering 独立仓库）。
  4. 存储层：通过 Hibernate 抽象对接关系型数据库（PostgreSQL/MySQL/MariaDB/Oracle/HSQLDB 等），附件可存数据库或文件系统。

3.2 页面模型：嵌套页面与命名空间

XWiki 的内容组织单元是页面（Page/Document）。自 XWiki 7.0 起支持嵌套页面（Nested Pages）：页面可以挂在任意父页面之下形成无限层级树，同时每个页面下还可以有子页面与附件，替代了早期「空间（Space）→页面」的两级结构。官方 Compare 页明确表述："In combination with the nested pages features of XWiki, it will drastically improve the navigation and search capabilities"（嵌套页面特性大幅改善导航与搜索能力，来源：https://www.xwiki.org/xwiki/bin/view/Compare/ ，查询日期 2026-10-22）。

💡 技术拓展：Wiki 的内容组织模型业界主要有三种——

模型代表产品特点适用场景
扁平页面DokuWiki页面 ID 用命名空间冒号分隔，本质是目录路径小型文档站
两级空间+页面早期 MediaWiki/Confluence空间（站点/领域）→页面两级，结构简单清晰团队规模中等
无限嵌套页面树XWiki、Confluence 新版页面即树节点，可无限层级，支持整棵子树移动与导出知识体系复杂、需要多层级知识库

XWiki 实际是「兼容两级命名（嵌套页面引入前的 Space.Page 引用仍有效）+ 无限嵌套树」的双形态，迁移老 Wiki 或组织深层知识体系都适配。

3.3 结构化数据模型：XClass 与 XObject

这是 XWiki 区别于绝大多数 Wiki 的核心设计（来源：xwiki.org《Compare XWiki》页官方表述 "XWiki also allows you to increase the organization of information using its structured data model. By adding structure to a wiki page you will ease the creation and editing of information."，查询日期 2026-10-22）：

  • XClass（类定义）：在 Wiki 内定义一个数据结构（类似"表结构"），字段类型涵盖文本、数字、日期、布尔、用户引用、页面引用、静态/数据库列表等。
  • XObject（对象实例）：任何页面都可以挂载若干个 XObject 实例——一页可以是"一篇文档 + 一个任务卡 + 一个评审记录"的复合体。
  • 结构化展示：挂了 XObject 的页面集合可以用 LiveData/Livetable 组件做表格化、筛选、排序展示，相当于在 Wiki 里"长出"了应用的数据视图。

这一模型使 XWiki 从"文档集合"升级为"文档 + 数据库"混合体：会议纪要、任务看板、资产台账、FAQ 库等都能用同一套 Wiki 页面承载结构化字段。

3.4 应用内编程：Wiki 即应用平台

XWiki 的第三个差异化支柱是在 Wiki 内部直接编程创建应用（官方 Compare 页表述："what differentiates XWiki is the ability to create your own apps in just a few minutes without technical knowledge. Just drag and drop. App within Minutes will take care of the rest."，查询日期 2026-10-22）：

  • App Within Minutes（AWM）：向导式应用生成器——定义数据结构后自动生成表单页、列表页、编辑视图，无需写代码。
  • Wiki 内脚本：页面内可嵌入 Velocity/Groovy 等脚本语言（受编程权限保护），直接调用平台 API 完成查询、渲染、流程逻辑（来源：xwiki.org Documentation → Developer Guide → Scripting）。
  • 组件与扩展机制：平台服务以 Component 架构组织，Wiki 应用可声明依赖扩展；extensions.xwiki.org 提供官方与社区扩展仓库（日历、图表、Skins、宏等）。
  • 权限编程：页面/空间/整站三级编程权限（Programming Rights）控制谁能执行脚本，保证安全边界。

「二级维基嵌套 + 结构化数据 + 应用内编程」三者叠加是 XWiki 的选型核心论据：它不仅是 Wiki，还是运行在 Wiki 之上的低代码应用平台。

四、功能特性

综合 xwiki.org 官方 Features 导航与 Compare 页（查询日期 2026-10-22），XWiki 的功能清单如下：

  • 编辑与内容：WYSIWYG 所见即所得编辑器、XWiki 语法 2.1/Markdown 等多语法支持、实时协同编辑（XWiki 实时编辑基于 WebSocket 协同）、版本历史与差异对比、撤销/回滚。
  • 组织与导航：无限嵌套页面树、面包屑导航、页面树浏览组件、标签与分类。
  • 结构化数据：XClass/XObject 数据模型、App Within Minutes 低代码建应用、LiveData 动态表格。
  • 附件与多媒体：每页附件管理、图片画廊、Office 文档在线预览（配合扩展）、PDF 导出（单页/整空间/整 Wiki）。
  • 权限与用户：用户/组管理、页面级/空间级/整站级三级权限、编程权限隔离、LDAP/Active Directory/OIDC 集成（经扩展）。
  • 搜索：内置搜索引擎（可配置 Solr/数据库搜索等实现）。
  • API 与集成：内置 RESTful API（页面/空间/附件/搜索等资源全覆盖，支持 Basic 认证）、Webhook、邮件通知。
  • 运维：扩展管理器（在线安装/升级扩展）、Wiki 组（一台实例承载多个独立 Wiki 的 Farm 模式）、分布式的 XWiki 组织架构（xwiki-platform/commons/rendering 分仓库）。
  • 国际化：界面与内容多语言支持。

五、快速开始（最小可用示例）

本节给出官方推荐的最小启动方式，内容为官方文档命令的溯源引用（未做本地实测；本专栏实测部署篇见 《XWiki 18.8 Docker Compose 部署指南》）。

官方 Docker 镜像提供「一条命令跑起来」的最小体验（来源：Docker Hub xwiki 官方镜像说明页 https://hub.docker.com/_/xwiki ，查询日期 2026-10-22）：

# 最小体验：使用内嵌 HSQLDB 数据库（仅试用，数据存本地目录）
docker run -d --name xwiki -p 8080:8080 -v xwiki-data:/usr/local/xwiki xwiki:stable

💡 说明：stable tag 当前（2026-10-22 实查 Docker Hub）指向 18.8.0 系列并内嵌 HSQLDB 数据库，仅适合快速试用；生产环境必须外置 PostgreSQL/MySQL/MariaDB，官方镜像为此提供 <版本>-postgres-tomcat / <版本>-mysql-tomcat / <版本>-mariadb-tomcat flavor。生产化部署（含数据库编排、数据持久化、健康验证、升级运维）请直接参考部署篇。

首次访问 http://<服务器IP>:8080/ 会进入 XWiki 的首次安装向导（Distribution Wizard），按向导导入默认 Wiki 即可进入主界面。

六、适用场景与限制

6.1 适用场景（官方口径）

来源：xwiki.org《Compare XWiki》页（查询日期 2026-10-22）：

  • 企业知识库：部门/全公司的文档、FAQ、流程手册，依赖嵌套页面组织知识树。
  • 协作内网（Intranet）：结合用户/组权限与多语言，作为内部门户。
  • 对外资源中心：产品文档站、帮助中心（可整站 PDF 导出、多语言内容）。
  • 轻量业务应用承载：任务台账、会议纪要库、资产管理等结构化场景——用 AWM/XObject 建模，避免为小需求单独开发应用。
  • 多团队多站点：一台实例托管多个独立 Wiki（Wiki Farm），各 Wiki 独立用户/权限/外观。

6.2 限制与注意

  • 资源占用偏高：Java + Tomcat + 外置数据库的组合，内存占用显著高于静态/文件型 Wiki（如 DokuWiki），小规格服务器（1GB 内存以下）不适用；官方镜像与部署建议按 2GB+ 内存规划（来源：官方镜像元数据与部署实践共识，查询日期 2026-10-22）。
  • 学习曲线：XClass/XObject/编程权限等概念对非技术团队有门槛，简单笔记场景属于"杀鸡用牛刀"。
  • 默认搜索依赖：整站搜索体验取决于所配搜索引擎实现（Solr 等），需要额外规划资源。
  • 升级需走 Distribution Wizard：大版本升级依赖官方分发向导逐步迁移扩展，跨多版本升级需按官方升级路径逐步执行（来源：xwiki.org Release Notes 升级说明，查询日期 2026-10-22）。

七、同类选型对比

7.1 量化对比表

数据溯源说明：GitHub 星数取自 shields.io 徽章 JSON（查询日期 2026-10-22，未直连 api.github.com）；版本信息取自各官方仓库 Releases；Confluence 为 Atlassian 专有闭源软件，无 GitHub 星数，按官方定价页口径说明。徽章直链（可点击复核）：

  • XWiki：stars（1.3k）
  • MediaWiki：stars（5.2k）
  • DokuWiki：stars（4.7k）
  • Wiki.js：stars（29k）
  • BookStack：stars（19k）
维度XWikiMediaWikiDokuWikiConfluenceWiki.jsBookStack
开源许可LGPL 2.1GPL 2+GPL 2专有商业AGPL 3MIT
GitHub 星数（2026-10-22）1.3k5.2k4.7k—（闭源）29k19k
技术栈Java + TomcatPHP + MariaDB/MySQLPHP（无数据库，文件存储）Java（闭源）Node.js + SQLPHP + Laravel + MySQL
内容组织无限嵌套页面树页面+分类（扁平）命名空间（伪目录）空间+页面树页面树书→章节→页面三级
结构化数据XClass/XObject + AWM 低代码应用无原生（依赖模板/扩展）无原生（依赖插件）数据库/表单宏（付费版）无原生无原生
Wiki 内编程Velocity/Groovy 脚本 + 组件 + 扩展体系PHP 扩展为主PHP 插件为主专有插件生态主题/定制受限无
多站点（Farm）原生支持一库多 Wiki支持（Wikifarm 需自行搭建）支持多动物模式云端多空间多租户支持不支持
REST API内置完整 REST API内置 API（Action+REST 扩展）有限（XML-RPC/JSON-RPC 插件）完整 REST API（按授权收费）内置 REST API+GraphQL内置 REST API
数据库依赖PostgreSQL/MySQL/MariaDB/Oracle/HSQLDBMariaDB/MySQL/PostgreSQL/SQLite无（纯文件）自带（专有）PostgreSQL/MySQL/MariaDB/SQLite/SQL ServerMySQL/MariaDB/PostgreSQL
资源占用高（JVM 2GB+ 内存为宜）中低高（且按用户数付费）中中
商业授权成本免费（可选付费支持）免费免费按用户数订阅（Data Center 每年 3.6 万美元/500 用户级起，以官方报价为准）免费免费

解读（如何选型）：要"文档 + 结构化数据 + 低代码应用"三位一体的企业级平台选 XWiki；要百科式大规模协作、社区词条共建（如维基百科同款）选 MediaWiki；要最低运维成本的小型文档站（无数据库、纯文件）选 DokuWiki；预算充足、要商业支持与成熟生态且按人头付费不敏感选 Confluence；要现代 UI、Node.js 技术栈、多租户文档站选 Wiki.js；要结构化"书架式"知识管理且部署简单选 BookStack。XWiki 的星数虽不及 Wiki.js/BookStack，但其定位（企业应用 Wiki）不同——星数反映的是"GitHub 关注度"，不直接等于企业部署量与功能深度；XWiki 官方公布过数十万级活跃安装的统计（来源：xwiki.org Active Installs 统计页，查询日期 2026-10-22）。

7.2 官方对比页索引

XWiki 官方专门维护了与两大竞品的逐项对比页（查询日期 2026-10-22）：

官方对比页的核心结论（溯源自 Compare 总页）："some wikis, such as XWiki, go further by proposing additional base features"——XWiki 在经典 Wiki 能力之上额外提供 WYSIWYG 编辑、权限管理、附件、PDF 导出，并以结构化数据模型 + 嵌套页面提升信息的组织、导航与搜索能力。

八、参考链接