XWiki 全攻略

一、平台介绍

XWiki 是第二代开源企业级 Wiki 知识管理平台，于 2004 年诞生。

1. 核心基础

• 开发语言：Java 开发，采用 LGPL 开源协议。
• 协议优势：永久开源，源码全开放，数据自主可控，无厂商锁定。
• 市场定位：对标 Atlassian Confluence，替代传统 MediaWiki，兼顾「文档知识库 + 低代码表单 + 企业内网 + 业务系统搭建」多重能力。

2. 官方渠道

• 开源社区版官网：xwiki.org（功能全开源免费）。
• 商业服务站点：xwiki.com（官方商业服务与技术支持）。

3. 核心特色

• 能力融合：页面结构化 + 零代码自建应用 + 750+ 官方扩展插件。
• 系统定位：既可以做普通文档 Wiki，也能不用编程搭建 CRM、台账、项目管理系统。
• 部署形态：支持私有化本地部署、服务器自建、Docker 部署、官方云端托管三选一，数据完全存在自己服务器，适合政企数据合规需求。
• 用户规模：全球用户包括亚马逊、EDF、军工、政企、高校、软件研发团队广泛落地，是 Confluence 最主流的开源平替。

二、核心主要功能

1. 富文档协作编辑（基础 Wiki 能力）

• 编辑器：可视化所见即所得编辑器，兼容 Markdown、标准 Wiki 语法。
• 内容能力：支持分段单独编辑、插入表格/图片/附件/代码块/引用。
• 版本控制：全版本历史回溯、单页回滚、修改日志、评论批注、多人在线协同。
• 文档管理：支持 Word/Excel/PDF/ODF 导入导出，支持批量文档打包导出。

2. 精细化空间与权限管控（企业王牌）

• 权限层级：按全局→空间→页面→单文档四级权限管理。
• 配置灵活：单独配置用户或用户组「查看/编辑/删除/上传/管理员」权限，支持只读、评论、可编辑分级，涉密文档单独锁权限。
• 身份认证：对接 LDAP/AD/微软 EntraID/企业微信单点登录（部分为付费 Pro 插件）。

3. 结构化数据与零代码自建应用

• 数据能力：无需代码，自定义字段（单选/日期/附件/人员/数字/关联字段）。
• 应用生成：快速生成表单数据库，同一份数据可切换列表/表格/看板视图。
• 业务场景：可自建台账、招聘库、设备管理、项目排期、CRM，对标 Notion 数据库、Confluence 自定义表单。

4. 海量扩展生态

• 插件数量：官方扩展库一键安装，含 750+ 插件。
• 常用功能：日历、投票、论坛、任务管理、表单、OnlyOffice 在线预览、全文检索（Solr）、Confluence 一键迁移工具、网盘附件管理、邮件通知。

5. 全文检索、多语言与附件管理

• 搜索：全局全文检索，支持附件内文档内容检索。
• 多语言：原生多语言支持，含简体中文界面。
• 附件：附件不限单文件大小（自建部署无容量限制），支持附件预览与分类归档。

6. 脚本扩展（高阶开发）

• 开发支持：页面内嵌 Groovy/Velocity/Python 脚本。
• 定制逻辑：支持二次开发定制页面逻辑，IT 团队可深度定制内网系统。

三、适用人群

✅ 1. 企业/研发团队（最主流）

• 软件公司：研发知识库、接口文档、需求台账、项目 SOP、BUG 归档，替代付费 Confluence。
• 职能管理：行政/人事/生产部门，管理规章制度库、员工档案、设备台账、生产流程手册、供应商管理。
• 集团内网：构建企业内部门户网站，或作为对外帮助中心（外网知识库）。

✅ 2. 高校/培训机构

• 教学场景：课程知识库、课件归档、题库管理、在线课程文档、社团资料中心。

✅ 3. 政企/事业单位

• 合规需求：私有化知识库，政策文档库，数据本地存放，满足等保与数据不出内网要求。

✅ 4. 技术爱好者/小团队

• 个人使用：个人自建知识库、开源项目文档站、个人资料归档。

❌ 不适合人群

• 纯小白/零运维：需要一定的服务器运维能力。
• 极简云端需求：不想搭建服务器且仅想要开箱即用云端服务的（可选官方云付费版）。
• 移动端重度用户：追求极简移动端轻量化体验的（原生 APP 体验弱于 Notion）。

四、免费与付费明细

核心规则：XWiki 软件本体 100% 永久免费开源，无用户数、页面、空间限制。付费仅为「官方技术支持 + Pro 商业插件 + 官方云端托管」。

1. 开源免费版（Community Edition）

• 来源渠道：xwiki.org 下载。
• 费用说明：永久免费。
• 功能范围：全核心功能，包括文档编辑、权限管理、结构化自建应用、基础扩展。无用户上限、无存储上限（自建服务器硬盘决定容量）。
• 限制条件：
• 无官方技术售后支持。
• 无法使用 Pro 付费插件（如 AD 单点、Confluence 迁移、OnlyOffice 商业版、流程引擎）。
• 遇到问题只能社区论坛求助。
• 部署方式：自行在服务器或 Docker 安装，数据全归自己。

2. 付费三大套餐（XWiki SAS 商业服务）

① XWiki Cloud（官方云端托管）

• 适用场景：不用自建服务器，适合不想运维的团队。
• 计费标准：起步 2.5 欧元/用户/月，最低 10 用户起购。
• 服务内容：官方运维服务器、自动备份、基础技术支持、预装全部 Pro 插件、欧洲合规服务器、ISO27001 认证。

② 私有化付费技术支持（Self-host 支持包）

• 适用场景：自建服务器，但需要官方服务支持。
• Basic 基础版：年费起步约 570 欧元，含邮件支持、常规故障答疑、免费小版本升级。
• Business 商业版：优先工单、远程协助、全 Pro 应用授权。
• Enterprise 企业版：7×24 小时应急、定制开发、现场技术服务、Confluence 批量迁移服务。

③ Pro 付费插件包

• 采购方式：单独采购企业级插件。
• 典型功能：AD 集成、流程审批、Confluence 迁移工具、企业级 OnlyOffice 对接。
• 注意：如果不买 Pro 插件，社区免费版无法使用该类功能。

3. 教育优惠

• 政策支持：高校非商用部署，可申请免费 Enterprise 级技术支持。

五、分步上手使用教程

方式一：本地快速试用（Standalone 便携包）

• 下载：访问官网 xwiki.org→Download 下载 Standalone 独立包（内置 Jetty+HSQL 简易数据库，无需额外装 JDK/MySQL）。
• 运行：
• Windows 系统运行 start_xwiki.bat。
• Linux/mac 系统运行 start_xwiki.sh。
• 访问：浏览器打开 http://localhost:8080/xwiki。
• 登录：初始化管理员账号（admin+ 自定义密码）。
• 耗时：5 分钟即可完成试用。

方式二：正式生产部署（3 种主流）

1. Docker 一键部署：使用 docker run 拉取官方镜像，一行命令启动，推荐中小企业生产环境。
2. WAR 包部署：安装 JDK8+Tomcat+MySQL/MariaDB，将 WAR 包放入 Tomcat 部署（传统企业选型）。
3. Debian 系统安装：使用 apt 安装官方 deb 安装包。

方式三：后台基础使用步骤

1. 新建空间：首页创建空间（如研发部/行政部），空间用于分类整类文档。
2. 新建页面：在空间内新建文档，使用可视化编辑正文，插入附件/表格。
3. 自建数据库表单：点击首页→应用→App Within Minutes，自定义字段生成台账页面。
4. 权限配置：在空间/页面右上角设置权限，新建用户组，分配浏览/编辑权限。
5. 安装插件：进入后台扩展中心，一键安装日历、在线预览等免费插件。

六、新手避坑重点

1. 环境部署坑（最大痛点）

• JDK 版本：仅兼容 JDK 8~JDK 17，不兼容 JDK 20+、Tomcat 10+，装错直接启动报错。
• 数据库配置：生产环境禁用自带 HSQL 嵌入式数据库（性能差、易损坏），必须换 MySQL/MariaDB/PostgreSQL，数据库编码统一设为 utf8mb4。
• 内存配置：单机部署服务器内存≥2G，Tomcat 需配置堆内存，内存过小会导致打开页面卡顿、附件上传失败。

2. 中文本地化坑

• 语言包：原生简体中文不全，首次部署后需在扩展中心安装中文语言包，否则部分菜单显示英文。
• 离线环境：离线环境无法在线下载插件，需提前离线下载 XIP 扩展包并本地导入。

3. 免费版功能边界坑

• Pro 插件：AD/企业微信单点、Confluence 一键迁移、高级审批流均为Pro 付费插件，免费开源版无，不要误以为全插件免费。
• 社区插件：社区插件质量参差不齐，小众扩展容易兼容新版本报错，优先选择官方认证扩展。

4. 备份坑

• 备份策略：自建私有化必须定期全库备份数据库+XWiki 数据目录。
• 风险：无自动云端备份，虽然版本免费版有全量历史，但硬盘损坏数据无法找回。

5. 性能坑

• 附件存储：附件海量存储不要存在数据库内，需配置附件外置磁盘路径，否则数据库膨胀会导致查询卡顿。

6. 移动端坑

• 设备体验：无官方原生 APP，手机仅支持浏览器访问页面，复杂表单/数据库编辑体验差，移动端重度使用不推荐 XWiki。

7. 升级坑

• 升级操作：跨大版本（如 14→15）不要直接覆盖升级。
• 前置操作：先全量备份，部分自定义插件新版本不兼容，需检查兼容性后再升级。