Documize 5.14 介绍与选型指南

目标：从产品定位、技术架构、功能边界与维护现状四个维度认识 Documize Community，并给出与 BookStack、Outline、Wiki.js、Confluence 的量化选型对比。本文为联网溯源篇，官方信息查询日期 2026-11-02，不含本机实测结论。

一、环境信息

本文是认知与选型文档，不依赖运行时环境。为便于核对信息，列出查询时使用的公开信息源与版本口径：

• 目标产品：Documize Community（仓库 documize/community）
• 社区版最新稳定版：v5.14.0
• 官方仓库更新时间：2026-10-28（GitHub 仓库元数据）
• 官方仓库最近代码推送时间：2026-05-18（GitHub 仓库元数据）
• 开源许可：GNU AGPL v3
• 官方站点：https://www.documize.com
• 信息查询日期：2026-11-02

💡 说明：本文所有版本号、星数、发布日期均来自 GitHub 仓库页、Releases 页、README 与官网，查询日期统一为 2026-11-02。本文只回答「它是什么、适合谁、风险在哪」，不展开安装步骤。

二、软件概述

Documize 是一款自托管的企业级知识管理/文档协作系统，官方自我定位为「Modern Confluence alternative designed for internal & external docs」。它把内部运行手册、对外产品文档、团队规范统一放进「空间（Space）—分类（Category）—文档（Document）—页面（Page）」的层级中，用标签（Label）做跨空间的横向聚合，避免传统网盘式深层目录。

与多数 Wiki 产品相比，Documize 有三个显著特点：

1. 单二进制交付：Go 后端与 EmberJS 前端资源编译进一个可执行文件，Linux/Windows/macOS/ARM 均可运行，官方明确「There is no installer — just a single executable」。
2. 数据库自带全文检索：不内置搜索引擎，要求底层数据库开启 Full-Text Search；支持 PostgreSQL、MySQL/MariaDB/Percona、Microsoft SQL Server。
3. 内容块（Section）机制：文档页面不是单一富文本，而是由多种 section 类型组合而成，官方注册了 14 种 section 类型（本机启动日志中的 Extensions: registered 14 section types 可佐证，详见安装篇）。

官方 README 给出的技术栈为 Go（v1.25.1）与 Ember JS（v3.12.0）。这意味着运维侧只需要关心一个进程和一套数据库连接，不需要 Node.js、Java 运行时或额外的搜索服务。

💡 技术拓展：自托管知识库按「内容模型」大致分为三类——以 BookStack 为代表的「书—章—页」静态层级；以 Wiki.js、Outline 为代表的「Markdown 优先、编辑器可换」的现代 Wiki；以 Documize、Confluence 为代表的「空间 + 分类 + 内容块 + 审批」的企业文档平台。本文讨论的 Documize 属于第三类，强项是组织维度与内容块组合，而不是单纯 Markdown 写作体验。

三、核心架构

3.1 运行形态

Documize 的运行形态是「无状态应用进程 + 外部关系型数据库」。应用进程本身不持久化文档正文，所有组织、用户、空间、文档、页面、附件元数据都落在数据库中；附件二进制默认也以数据库记录/文件标识的方式管理（社区版附件上传接口会把文件落到应用侧存储，数据库保存文件标识与元信息）。

从运维视角看，这套架构的好处是备份边界清晰：备份数据库 + 备份附件目录即可还原整个知识库；坏处是数据库成为单点，数据库不可用时应用无法启动（启动阶段就会检查数据库状态与 schema 版本）。

3.2 领域模型

官方 API 路由与源码把领域对象拆成以下核心实体：

这套模型的关键设计是「文档由多个页面组成」：一篇文档相当于一本书，页面是书里的章节；页面可以调整层级（level）与顺序（sequence），并保留修订历史。对运行手册、产品手册这类需要章节化维护的内容，比单页 Wiki 更接近 Confluence 的树状阅读体验。

3.3 接口与认证

官方把 Web UI 与 REST API 放在同一进程、同一端口：页面走 Ember 前端路由，数据走 /api 前缀的 JSON 接口。认证采用 HTTP Basic 换取 JWT：

• 登录接口：POST /api/public/authenticate，Basic 认证串格式为 domain:email:password（domain 可为空）。
• 令牌格式：HS256 JWT，载荷中包含 org、user、sub=webapp、iss=Documize、exp。
• 签名密钥：由启动参数/环境变量 salt 提供；未显式设置时进程启动会随机生成，重启后旧令牌全部失效。

这条「salt 决定令牌生命周期」的机制，直接影响多实例部署与滚动重启策略：生产环境必须显式固定 DOCUMIZESALT，否则每次重启都会把在线用户踢下线。

3.4 扩展与集成

社区版官方列出的身份集成包括 LDAP、Active Directory、Red Hat Keycloak、CAS；本地化开箱支持英语、德语、法语、中文、巴西葡萄牙语、日语、意大利语、西班牙语（阿根廷）、波兰语。内容导出方面，社区版提供自包含 HTML 导出接口（POST /api/export），适合做离线归档或对外发布。

⚠️ 注意：官方 README 把「审批流、版本管理、生命周期管理、反馈收集、PDF 导出、分析报表、活动流、审计日志、动作分配、产品支持」列在 Community+（商业增强版）能力清单中。社区版源码里能看到部分权限字段与版本相关模型，但功能完整度应以 Community+ 为准；选型时必须按社区版实际可用功能逐项验收，不能把 README 的 Community+ 清单直接当成社区版能力。

四、功能特性

4.1 组织与检索

• Labels / Spaces / Categories 三维组织：空间隔离团队或项目，分类做空间内二级归类，标签做跨空间聚合。
• 数据库全文检索：依赖 PostgreSQL/MySQL/SQL Server 的 FTS 能力，检索覆盖文档与页面，支持按空间、标签过滤。
• 全局检索重建：提供 GET /api/global/search/status 与 POST /api/global/search/reindex，可查看索引条目数并触发重建。

4.2 内容生产

• 两级模板：空间级模板 + 片段目录，把团队写作规范固化成可复用结构。
• 内容块编辑：富文本、代码块、Markdown、Jira、Trello、PDF 嵌入、图表等 section 类型组合成页面。
• 页面层级与排序：页面支持 level（层级）与 sequence（顺序）调整，形成可阅读的章节树。
• 修订历史：页面每次更新生成 revision，可查看差异并回滚到指定修订。

4.3 协作与权限

• 空间/文档/分类三级权限：权限记录按 action 展开，覆盖查看、管理、加文档、编辑、删除、移动、复制、模板、审批、生命周期、版本等动作。
• 用户组：支持 group 维度的成员管理，权限可授予组而非仅个人。
• 审批与生命周期字段：文档/页面模型带 approval、lifecycle 字段；完整审批工作流属于 Community+ 增强能力。

4.4 身份与本地化

• 邮箱密码登录 + LDAP/AD/Keycloak/CAS 单点登录。
• 九种界面语言开箱可用。
• 支持主题切换与组织 Logo。

4.5 交付与运维

• 单二进制、无安装器；升级即替换二进制并重启。
• 数据库 schema 由内置 SQL 脚本自动迁移；启动日志会打印当前版本号与待执行脚本数。
• 支持 HTTP/HTTPS、强制跳转 TLS、最低 TLS 版本配置。

五、快速开始（官方口径）

本节给出官方 README/Release 口径的最小启动路径，用于建立「它需要什么」的直觉；命令与参数按 v5.14.0 资产与源码整理，不在本文伪造运行回显。具体的建库、setup 向导与托管步骤属于部署篇内容，本文不展开。

5.1 准备数据库

官方要求数据库开启全文检索。以 PostgreSQL 为例，先创建专用角色与空库：

CREATE ROLE documize LOGIN PASSWORD 'q1w2e3r4';
CREATE DATABASE documize OWNER documize;

5.2 下载并启动二进制

wget https://github.com/documize/community/releases/download/v5.14.0/documize-community-linux-amd64
chmod +x documize-community-linux-amd64
export DOCUMIZEDBTYPE=postgresql
export DOCUMIZEDB='host=127.0.0.1 port=5432 sslmode=disable user=documize password=q1w2e3r4 dbname=documize'
export DOCUMIZEPORT=8139
export DOCUMIZESALT='q1w2e3r4documizesalt'
./documize-community-linux-amd64

首次连接空库时，进程会打印 Database: starting setup mode for empty database 与 Serving SETUP web server，并提示访问 http://localhost:8139/setup 完成向导；向导提交后自动建表并创建组织与管理员账号。

5.3 安装后的验证入口

• GET /api/public/version：返回纯文本版本号。
• GET /api/public/meta：返回站点元信息。
• POST /api/public/authenticate：Basic 认证换取 JWT。
• GET /api/space：携带 Authorization: Bearer <token> 列出可见空间。

⚠️ 注意：环境变量前缀是 DOCUMIZE 且不加下划线——正确写法是 DOCUMIZEDB、DOCUMIZEDBTYPE、DOCUMIZEPORT，写成 DOCUMIZE_DB 不会生效。这是本项目最容易踩的配置坑，安装篇会给出完整的报错回显与定位过程。

六、适用场景与限制

6.1 适用场景

6.2 限制与不匹配场景

• 纯 Markdown 写作团队：Documize 的内容优先是 section 内容块与富文本，Markdown 只是其中一种 section；如果团队要求「所有文档都是 Git 仓库里的 .md」，BookStack/Wiki.js 更顺手。
• 超大规模公开 Wiki：社区版没有成熟的匿名公开站点工作流，公开访问与审批仍偏企业内部。
• 需要强实时多人协同编辑：Documize 是页面级保存与修订模型，不是 Google Docs 式实时光标协同。
• 不愿承担社区版维护风险：见下一节，版本节奏是选型时必须量化的风险项。

七、同类选型对比

7.1 量化对比表

星数取 shields.io 徽章（查询日期 2026-11-02），其余维度取各项目官方仓库/文档口径：

7.2 关键差异解读

• 星数与生态：Documize 的 2.4k 星明显低于 BookStack（19k）、Outline（41k）、Wiki.js（29k）。这意味着遇到问题时，社区答案、第三方插件、中文教程的数量都更少，排障更依赖官方源码与自助调试。
• 交付与运维成本：Documize 的单二进制在四者中运维面最小；BookStack 需要 PHP-FPM + Web 服务器 + MySQL；Outline 还需要 Redis 与对象存储；Wiki.js 需要 Node 运行时与数据库。对「只有一台 2C4G 内网服务器」的场景，Documize 的部署链路最短。
• 内容模型差异：Documize 的「文档 = 多页面章节 + 内容块」最接近 Confluence；BookStack 的「书—章—页」更朴素；Outline/Wiki.js 更偏 Markdown 单页。选型时先看团队的内容结构，而不是只看星数。
• 许可差异：BookStack 的 MIT 最宽松；Documize/Wiki.js 为 AGPL，二次分发或 SaaS 化需要关注 AGPL 义务；Outline 为 BSL 1.1，有商业使用限制条款；Confluence 为商业许可。

7.3 「如果……则……」选型建议

• 如果团队要的是Confluence 替代、重视空间/分类/标签/章节化阅读，且希望单二进制轻运维 → 选 Documize。
• 如果团队要的是极简书页结构 + 大社区 + PHP 技术栈 → 选 BookStack。
• 如果团队要的是现代 Markdown 协作体验、愿意维护 Node/Redis/对象存储 → 选 Outline。
• 如果团队要的是多编辑器、多数据库、部署形态灵活 → 选 Wiki.js。
• 如果必须要有商业 SLA、审计合规、成熟审批流且预算充足 → 选 Confluence 或 Documize Community+。

八、维护现状与风险核实

这一节是选型时最容易被忽略、但对生产最致命的部分。以下结论全部来自 2026-11-02 的公开信息核对：

8.1 版本线核实

GitHub Releases 列表显示：

结论：v5.14.0 是社区版当前最新稳定版，且是唯一被 README 标注为 Latest Release 的版本。 从 2025-09-19 到查询日 2026-11-02 已超过 13 个月没有新的稳定版发布，发布节奏明显放缓。

8.2 仓库活跃度核实

GitHub 仓库元数据（查询日期 2026-11-02）显示：archived=false（未归档）、pushed_at=2026-05-18、updated_at=2026-10-28、open_issues_count=48、stargazers_count=2424、forks_count=237。仓库没有归档，但最近一次代码推送已是五个多月前。

8.3 商业策略核实

官网与 README 同时指向 Community+：社区版开源（AGPL v3），Community+ 为商业增强版，前 5 个用户免费，之后 100 用户约 900 美元/年。官方把审批流、版本管理、生命周期、PDF 导出、分析报表、审计日志等列在 Community+ 能力清单。这说明厂商的持续投入重心在商业版，社区版更像「可持续运行的社区基座」而非快速迭代的产品。

8.4 风险结论

⚠️ 注意：以上是风险提示，不是「不能用」的结论。Documize 的架构简单、功能面完整，作为内网知识库仍可用；关键是不要把「最新版会持续快速迭代」写进项目假设。

九、参考链接

• Documize 官方仓库：https://github.com/documize/community
• Documize v5.14.0 Releases：https://github.com/documize/community/releases/tag/v5.14.0
• Documize 官方站点：https://www.documize.com/
• Documize Community+ 获取页：https://www.documize.com/community/get-started
• README（版本、数据库、技术栈、Community+ 能力清单）：https://github.com/documize/community/blob/master/README.md
• 星数徽章：https://img.shields.io/github/stars/documize/community
• BookStack 仓库：https://github.com/BookStackApp/BookStack
• Outline 仓库：https://github.com/outline/outline
• Wiki.js 仓库：https://github.com/requarks/wiki

以上信息查询日期均为 2026-11-02。