Decentralization? We're still early!

XWiki:超越传统文档的”第二代”企业级开源 Wiki 平台

  • XWiki:超越传统文档的”第二代”企业级开源 Wiki 平台

    發布人 Brave 2026-02-08 06:57

    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),为页面添加表单和一致性约束。这种结构化能力带来了三个显著优势:

    1. 📋 简化了内容创建和编辑流程——用户按表单填写,无需担心格式问题
    2. 🔍 大幅提升了内容的可搜索性和可检索性——结构化字段可以被精确查询
    3. 🌲 结合 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.02025.01页面树排序参数(按名称/标题/修改日期/创建日期)
    17.1.02025.02粘贴图片自动上传为附件
    17.2.02025.03普通用户可拖拽排序导航页面(不再限管理员)
    17.5.02025.06新版宏配置 UI、Solr 索引性能优化、环境变量覆盖配置
    17.8.02025.09搜索排除页面配置、注释气泡自动调整位置、Logo 替代文本配置
    17.9.02025.10未保存变更恢复机制、外部链接安全控制、智能保存(避免空白修订)
    17.10.22025.1217.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 团队——技术亲和度高,二次开发门槛低

    参考资源

    Brave 回复 2 weeks, 5 days ago 1 成員 · 0 回复
  • 0 回复

歡迎留言回复交流。

Log in to reply.

讨论開始
00 回复 2018 年 6 月
現在