XWiki:超越传统文档的”第二代”企业级开源 Wiki 平台
-
XWiki:超越传统文档的”第二代”企业级开源 Wiki 平台
目录- 核心功能与技术亮点
- 📐 强大的应用引擎
- 🗃️ 结构化数据管理
- 🏢 多租户架构(Wiki Farm)
- ✏️ 所见即所得编辑器与实时协作
- 🧩 高度可扩展的插件生态
- 🌍 国际化与协作能力
- 技术架构深度解析
- 🏗️ 整体架构
- ⚙️ 技术栈概览
- 🔐 安全机制
- 版本与服务方案
- 📦 XWiki Standard(开源版)
- 💎 XWiki Pro(专业版)
- ☁️ 云托管服务
- 💰 定价体系
- 从 Confluence 迁移到 XWiki
- 🔄 迁移工具包包含
- 📋 迁移能力概览
- 部署建议
- 🐳 Docker 部署(推荐)
- 🖥️ 传统 WAR 部署
- ☁️ PaaS / 托管部署
- ⚠️ Java 版本要求(重要更新)
- 最新版本动态与发展路线
- 📅 17.x 版本周期(2025 年)重要里程碑
- 🚀 18.0.0(2026 年 1 月 28 日发布)
- 🔮 Cristal —— 下一代 Wiki 前端
- 与 Confluence 的对比总结
- 适用场景推荐
- 参考资源
XWiki 是一款基于 Java 的高性能开源企业级 Wiki 系统。它不仅仅是一个简单的百科全书工具,更被官方定义为"第二代 Wiki",其核心竞争力在于不仅能处理结构化内容,还能作为一个低代码开发平台来构建定制化的商业应用。
XWiki 由 Ludovic Dubost 于 2004 年 1 月首次发布,至今已持续发展超过 20 年。项目由法国公司 XWiki SAS 主导开发和商业化运营,同时维持着活跃的开源社区。其开发社区遵循精英治理(Meritocracy)模型,拥有结构化的贡献、发布和质量控制流程。
对于寻求替代 Confluence 的企业来说,XWiki 是目前市场上功能最完备、扩展性最强的开源方案之一。与 Confluence 不同的是,XWiki 提供了完全的部署自由度——你既可以选择云端托管,也可以本地私有化部署,并且随时可以在两种模式之间切换,不会被厂商锁定。
核心功能与技术亮点
📐 强大的应用引擎
不同于传统的静态 Wiki,XWiki 允许用户直接在 Wiki 页面内使用脚本语言编写逻辑,快速搭建请假审批、资产管理等微型应用。
支持的脚本语言非常丰富,除了核心的 Apache Velocity 和 Groovy 之外,还通过 JSR-223(Java 脚本引擎规范)支持 Python、JavaScript、PHP、Ruby 等主流语言。这意味着开发者几乎可以用自己最熟悉的语言在 Wiki 平台上快速构建业务逻辑,大幅降低了二次开发的门槛。
XWiki 的平台化定位体现在它提供了一整套开箱即用的运行时服务,包括:
- 🔐 权限管理(Rights Management)
- 📄 页面渲染引擎(Page Rendering)
- 💾 透明存储层(Transparent Storage)
- 📝 页面操作接口——编辑、删除、重命名、查看(Page Manipulation)
- 🔄 版本控制(Versioning)
- 🔑 认证体系(Authentication)
- 🧩 宏系统(Macros)
这套完善的运行时服务体系,使得开发者无需从零搭建基础设施,只需专注于业务逻辑的实现,真正实现了"快速应用开发"(Rapid Application Development)的理念。
🗃️ 结构化数据管理
支持"对象"概念,可以将普通的文档页面变成具有特定字段(如日期、列表、用户选择器)的数据表单。
这是 XWiki 与 Confluence 之间最本质的区别之一。Confluence 本质上是一个"非结构化文档"平台,所有内容都是自由文本;而 XWiki 的结构化数据模型允许你为内容定义明确的模式(Schema),为页面添加表单和一致性约束。这种结构化能力带来了三个显著优势:
- 📋 简化了内容创建和编辑流程——用户按表单填写,无需担心格式问题
- 🔍 大幅提升了内容的可搜索性和可检索性——结构化字段可以被精确查询
- 🌲 结合 XWiki 的嵌套页面(Nested Pages)功能,从根本上改善了大规模知识库的导航体验
🏢 多租户架构(Wiki Farm)
支持在单个安装实例下运行多个独立的子 Wiki,非常适合大型集团公司为不同部门分配独立的协作空间。
根据不同的服务等级,XWiki 支持从 25 个到 100 个子 Wiki 的配置。每个子 Wiki 可以拥有独立的内容空间、权限配置和视觉主题,同时共享底层的技术基础设施,这种架构显著降低了多部门协作场景下的运维成本。在 Enterprise 级别,还支持真正的多租户集群部署,可以在多个生产实例之间进行负载均衡。
✏️ 所见即所得编辑器与实时协作
提供极佳的 WYSIWYG 编辑体验,支持强大的权限管理、LDAP 集成以及多种文档格式(PDF、Office)的导入导出。
从 XWiki 8.x 版本起,平台集成了业界领先的 CKEditor 作为所见即所得编辑器,提供了堪比商业软件的富文本编辑体验。对于高级用户,也保留了 Wiki 语法编辑模式,支持更精细的页面控制。
🔥 实时协作编辑是 XWiki 的重要特性之一。自 XWiki 16.9.0 起,实时协作编辑功能已默认启用。其技术实现基于 ChainPad 引擎,这是一种受中本聪区块链启发的、类 CRDT(无冲突复制数据类型)的冲突解决机制,能够优雅地处理多人同时编辑的并发冲突。实时协作的具体体验包括:
- 👥 编辑页面时可以看到协作者的头像
- 📍 实时显示每位协作者的光标位置
- 🔗 自动高亮链接标注
- 💾 "完成"按钮现已优化为仅在内容实际发生变化时才创建新版本,避免了无意义的空白页面修订记录(17.9.0 新增)
此外,XWiki 生态中还在积极推进 BlockNote 编辑器的整合。BlockNote 是一款轻量级的、类 Notion 风格的块状编辑器,通过"/"命令实现快速格式化和功能调用,特别适合协作笔记和屏幕端内容发布场景。在 XWiki 的新一代前端项目 Cristal 中,BlockNote 已成为默认编辑器。
🧩 高度可扩展的插件生态
拥有一个包含数百个插件的扩展仓库,涵盖从图表绘制到工作流流转的各类功能。
截至 2025 年底,XWiki 的扩展生态已成长为一个包含约 900+ 社区扩展的庞大仓库,其中 39 个被 XWiki SAS 产品团队正式推荐,此外还有 18 个面向企业场景的 Pro 专业应用。这些扩展覆盖了企业日常运营的方方面面:
📂 类别 🧩 扩展示例 📅 项目管理 日历应用(Pro)、任务管理器(Pro) 📊 数据可视化 图表宏、图表绘制应用(Pro) 🔄 工作流 变更请求(Change Request)、审批流转 📖 内容管理 博客应用(Pro)、图书版本管理(Book Versions) 🔌 集成连接 LDAP/AD 集成、JIRA 连接、Matomo 分析集成 📋 文档处理 PDF 导出、Office 文档导入导出 在 Confluence 生态中,功能复杂度的提升往往意味着需要购买更多付费插件;而在 XWiki 中,大量核心扩展都是免费开源的,这在总体拥有成本(TCO)上构成了显著优势。
🌍 国际化与协作能力
XWiki 内置支持超过 40 种语言,使全球团队可以使用母语访问和编辑信息。平台还提供了完善的协作功能,包括:
- 📢 @提及(Mentions)功能,可直接在页面中通知相关人员
- 💬 内联评论和注释(Annotations),支持对特定段落进行标注讨论
- 📜 完整的版本历史追踪,支持任意版本的差异对比
- 🔔 灵活的通知和订阅机制
技术架构深度解析
🏗️ 整体架构
XWiki 是一个标准的 Java Web 应用(Webapp),部署在 Servlet 容器中运行。其架构设计遵循高度模块化的原则——XWiki 本身就是由一系列"扩展(Extensions)"组合而成的,其中核心扩展是系统正常运行所必需的组件,而可选扩展则根据业务需求灵活加载。
这种"一切皆扩展"的设计哲学,使得平台具备了极强的可定制性和可维护性。你可以精确控制系统中安装了哪些功能模块,避免了传统单体应用"一个都不能少"的臃肿问题。
⚙️ 技术栈概览
┌─────────────────────────────────────────────┐ │ 📱 前端展示层 │ │ CKEditor (WYSIWYG) / Wiki 语法编辑器 │ │ BlockNote (实验性,用于 Cristal) │ ├─────────────────────────────────────────────┤ │ 🧠 业务逻辑层 │ │ Velocity 模板 / Groovy 脚本 / JSR-223 │ │ 宏系统 / REST API │ ├─────────────────────────────────────────────┤ │ 🔧 平台服务层 │ │ 权限管理 / 认证 / 版本控制 / 渲染引擎 │ │ 全文搜索(Apache Solr)/ 事件系统 │ ├─────────────────────────────────────────────┤ │ 🗄️ 持久化层 │ │ Hibernate ORM │ │ MySQL / PostgreSQL / Oracle / HSQLDB │ ├─────────────────────────────────────────────┤ │ 🖥️ 运行环境 │ │ Java 21+(XWiki 18.0 起) │ │ Servlet 容器(Apache Tomcat 等) │ │ Docker / Kubernetes │ └─────────────────────────────────────────────┘🔎 全文搜索方面,XWiki 集成了 Apache Solr 作为搜索引擎后端。在 17.5.0 版本中,Solr 的索引速度得到了显著优化;17.8.0 版本新增了管理员可配置特定页面排除搜索的功能,为大型知识库提供了更精细的搜索管控能力。
🔐 安全机制
XWiki 非常重视平台安全,几乎每个版本都包含安全修复。例如 XWiki 18.0.0 包含了严重性高达 9.3/10 的安全修复。具体的安全能力包括:
- 🛡️ 细粒度的权限管理——页面级、空间级、Wiki 级三层权限体系
- 🔗 外部链接安全机制——17.9.0 引入了评论区外部链接的安全访问控制,管理员可自定义配置
- 🔑 多种认证集成——LDAP、Active Directory,Enterprise 级别支持 SCIM 自动化用户供给
- 📝 详细的审计日志和操作追踪
版本与服务方案
📦 XWiki Standard(开源版)
遵循 LGPL 2.1 开源协议,核心功能完全免费。通过 XWiki.org 即可获取源代码及安装包。
LGPL(GNU 宽通用公共许可证)是一个对企业非常友好的开源协议。相较于 GPL,LGPL 允许私有软件通过链接方式使用 LGPL 授权的库,而无需将自身代码也开源。这意味着企业可以放心地基于 XWiki Standard 构建自己的内部系统和定制化扩展,而不必担心知识产权的"传染"风险。
XWiki 的代码完全托管在 GitHub 上,任何人都可以自由 Fork 源码并在自己的仓库中开发修改。
💎 XWiki Pro(专业版)
由商业公司 XWiki SAS 提供,包含更多高级付费应用(如 Pro 宏、更高级的连接器)以及全方位的专家技术支持。
Pro 专业应用是 XWiki SAS 团队专门为企业场景开发的商业级应用套件,需要许可证才能使用,可以单独购买(Cloud Basic 级别或无支持合同的自托管模式),也可以作为 Business 及以上支持计划的一部分获取。主要的 Pro 应用包括:
- 📅 日历应用(Pro)——支持动态月度重复事件(2025 Q4 新增)
- ✅ 任务管理器(Pro)——现已支持自定义任务描述模板(2025 Q4 新增)
- 📐 图表应用(Pro)——支持正确的 PDF 导出、可点击链接、外部 URL 嵌入(2025 Q4 修复)
- 🔀 变更请求(Change Request)——适用于内容审批流程
- 📚 图书版本管理(Book Versions)——适用于长文档的版本管理
☁️ 云托管服务
为不想维护服务器的用户提供 SaaS 版本,确保数据的每日备份和系统自动更新。
XWiki Cloud 托管在法国的 OVHcloud 基础设施上,持有 ISO/IEC 27001 和 SOC 认证,满足企业级的安全与合规标准。2025 年 Q4,所有云实例已升级至 16.10.12 版本,并新增了 TLS 1.3 和 IPv6 支持,提供更快更安全的连接体验。
💰 定价体系
XWiki 提供了从免费到企业级的多层次定价方案,具体如下:
🏷️ 等级 💲 价格参考 👥 用户上限 📌 核心特性 Free / Starter 免费起步 有限 基础 Wiki 功能 Silver 入门付费 - Pro 应用入门访问 Basic 约 €2.31/用户/月起 最多 1,000 自定义域名、AD 认证、完整迁移工具、Matomo 集成、2 天响应 SLA Business 进阶定价 扩展规模 900+ 社区扩展的最佳努力支持(Best-effort Support) Enterprise 按需定制 无限 多实例部署、SCIM 供给、AI 功能(Beta)、2h/4h/12h/24h 优先响应 SLA、专属客户经理 🎓 优惠政策:NGO 和高等教育机构可享高达 50% 的折扣,开源项目也有特别定价。在线下单可额外节省 5%。现已推出三年期合同计划,适用于 XWiki Pro 和 Confluence 迁移工具包。
从 Confluence 迁移到 XWiki
随着越来越多的组织选择从 Confluence 迁移到 XWiki,XWiki SAS 推出了完整的 Confluence 迁移工具包(Confluence Migration Toolkit),起价 €2,140,提供免费试用。
🔄 迁移工具包包含
🛠️ 组件 📝 说明 Confluence Migrator(Pro) 核心迁移引擎,支持数据、用户、权限、附件、元数据的批量导入 Confluence Bridge 宏 包括 Page Properties、Page Properties Report、Content by Label 三个桥接宏,支持 CQL(Confluence 查询语言)解析 任务管理器(Pro) 确保任务数据的完整迁移 博客应用(Pro) 确保博客内容的完整迁移 日历应用(Pro) 确保日程数据的完整迁移 图表应用(Pro) 确保图表和绘图内容的完整迁移 📋 迁移能力概览
- ✅ 页面内容及页面历史记录
- ✅ 用户和权限配置
- ✅ 附件(注意:附件的历史版本暂不支持)
- ✅ 元数据(1.36.0 版本起支持从 Metadata for Confluence 插件导入)
- ✅ 博客和任务数据
- ✅ 支持一次运行迁移多个空间或完整备份
- ✅ 支持并行迁移,并提供详细的迁移报告
- ⚠️ 试用版限制:每次迁移仅支持 1 个空间、最多 30 个页面
此外,XWiki 还提供了免费开源的 Confluence XML Filter 工具,可以将 Confluence 导出的 XML 文件导入到 XWiki 页面中。但对于大型实例,可能会遇到页面名过长或不支持的宏等问题,建议大型企业使用完整的迁移工具包。
部署建议
XWiki 基于 Java 技术栈,推荐通过 Docker 官方镜像进行部署,或在标准的 Servlet 容器(如 Apache Tomcat)中运行。生产环境建议搭配 MySQL 或 PostgreSQL 数据库以获得最佳稳定性。
🐳 Docker 部署(推荐)
XWiki 提供了基于 Debian 的官方 Docker 镜像,通过 Docker Compose 编排,通常使用两个容器:一个运行数据库,另一个运行 XWiki + Servlet 容器。这种分离架构支持将两者部署在不同的物理机器上,实现更灵活的资源管理。
关键的 Docker 配置选项:
CONTEXT_PATH—— 自定义 XWiki 在 Tomcat 中的上下文路径,不指定则部署为 ROOT- 支持通过环境变量或 Java 系统属性覆盖配置(17.5.0 起支持)
🖥️ 传统 WAR 部署
对于已有 Java 应用服务器基础设施的企业,可以直接下载 XWiki WAR 文件,部署到 Tomcat、Jetty 等 Servlet 容器中。这种方式适合需要精细控制服务器配置的运维团队。
☁️ PaaS / 托管部署
XWiki 也支持部署到各类 PaaS 平台,或使用第三方托管服务商(如 OctaByte)提供的全托管服务,涵盖安装、维护、备份的全流程管理。
⚠️ Java 版本要求(重要更新)
自 XWiki 18.0.0(2026 年 1 月发布)起,平台最低要求 Java 21,并已支持 Java 25。Java 17 的支持已被正式移除。规划新部署或升级时,请务必关注 Java 版本的兼容性。
最新版本动态与发展路线
📅 17.x 版本周期(2025 年)重要里程碑
🏷️ 版本 📆 时间 ⭐ 亮点 17.0.0 2025.01 页面树排序参数(按名称/标题/修改日期/创建日期) 17.1.0 2025.02 粘贴图片自动上传为附件 17.2.0 2025.03 普通用户可拖拽排序导航页面(不再限管理员) 17.5.0 2025.06 新版宏配置 UI、Solr 索引性能优化、环境变量覆盖配置 17.8.0 2025.09 搜索排除页面配置、注释气泡自动调整位置、Logo 替代文本配置 17.9.0 2025.10 未保存变更恢复机制、外部链接安全控制、智能保存(避免空白修订) 17.10.2 2025.12 17.x 周期最终稳定版 🚀 18.0.0(2026 年 1 月 28 日发布)
作为新一代大版本,XWiki 18.0.0 带来了以下重要变化:
- ☕ 运行时要求提升至 Java 21,支持 Java 25
- 🎨 图标主题从 4.7.0 大幅升级至 7.0.1,界面视觉风格全面刷新
- ♿ 无障碍访问改进——注释支持键盘交互,高亮区域包含可聚焦的按钮
- 📊 Live Data 组件新增功能
- 🔒 包含严重性高达 9.3/10 的安全修复
🔮 Cristal —— 下一代 Wiki 前端
Cristal 是 XWiki 正在积极开发的全新模块化 Wiki UI 项目,采用现代 Web 技术构建,支持多后端存储(包括 XWiki 和 Nextcloud)。其 1.0.0 正式版已发布,标志着项目从实验阶段迈入了生产可用阶段。
Cristal 的关键特性:
- 📝 BlockNote 已成为默认编辑器,提供类 Notion 的块状编辑体验
- ⚙️ 提供专用的 Settings API,支持运行时后端配置,无需编辑代码或重启应用
- 🔐 支持 Nextcloud 认证集成,文档可直接存储在 Nextcloud 实例中
- 🧱 高度模块化设计,为 XWiki 的未来前端演进奠定了基础
与 Confluence 的对比总结
📊 维度 🔷 XWiki 🟠 Confluence 开源性 ✅ LGPL 2.1 完全开源 ❌ 商业私有软件 部署灵活性 ✅ 云端 / 本地 / PaaS,可随时切换 ⚠️ 已停售 Server 版,推 Cloud 结构化数据 ✅ 原生支持表单、模式、自定义字段 ❌ 仅自由文本 定制能力 ✅ 完全开放的开发平台 ⚠️ 相对封闭,标准化方案 扩展成本 ✅ 900+ 免费社区扩展 ⚠️ 复杂功能需购买付费插件 性价比 ✅ 同等功能集下更优 ⚠️ 功能等价时成本更高 Atlassian 生态 ⚠️ 非原生集成 ✅ 与 Jira 等无缝衔接 易用性 ⚠️ 学习曲线稍陡 ✅ 开箱即用,界面友好 用户满意度 ⭐ 8.0 / 10(FinancesOnline) ⭐ 9.1 / 10(FinancesOnline) 适用场景推荐
基于 XWiki 的特性,以下场景特别适合选择 XWiki:
- 🏛️ 需要数据主权和私有化部署的企业——完全掌控数据存储位置和访问方式
- 🏗️ 需要在 Wiki 基础上构建定制化业务应用的团队——利用低代码能力快速搭建流程
- 🌐 跨国大型集团需要多部门独立协作空间——利用 Wiki Farm 多租户架构
- 💶 对总体拥有成本(TCO)敏感的组织——丰富的免费扩展显著降低长期成本
- 🔄 正在寻求从 Confluence 迁移的企业——完整的迁移工具包和专业支持
- 🔧 拥有 Java 技术栈的 IT 团队——技术亲和度高,二次开发门槛低
参考资源
歡迎留言回复交流。
Log in to reply.