轻量模式

TIP

官方社区版自 9.4.0 开始，强制使用轻量模式，不再提供原有的标准模式。文档服务中文增强版在内置轻量模式的同时，保留了原本的标准模式。同时支持在 标准模式 与 轻量模式 之间切换。

轻量模式，是指将原本依赖消息队列（RabbitMQ）和数据库（PostgreSQL）的分布式架构，合并为单进程单体化架构，会在一定程度上降低部署复杂度和资源占用。

为什么需要轻量模式？

传统 ONLYOFFICE 社区版架构（标准模式）较重，部署需要处理：

• PostgreSQL（数据库）
• RabbitMQ（消息队列）
• supervisor（进程管理）
• 多 Node 进程协同
• 服务依赖顺序、健康检查、MQ 异常恢复

这对以下场景略不友好：

• 中小企业私有化部署
• Docker 单容器 / NAS / 群晖 / CasaOS
• ARM / 低配机器 / 离线内网环境
• POC 验证 / 开发测试

架构对比

	标准模式	轻量模式
依赖组件	Nginx + PostgreSQL + RabbitMQ + 多进程	单进程单体化
部署方式	docker-compose 多容器编排	docker run 一键启动
资源占用	高（MQ + DB 常驻内存）	低
运维复杂度	高	低

功能特点

• 去数据库化：状态全部内存化，无需额外数据库维护
• 去消息队列化：单机文件状态管理，不再依赖 RabbitMQ
• 单进程架构：降低部署门槛，适合单机、小团队场景
• 更低的资源占用：对 2C4G、ARM、小型 VM 更友好

适用场景

轻量模式特别适合：

• 中小企业 / 小团队文档协作
• POC 验证与开发测试
• NAS / Docker 单容器部署
• 对高并发大规模集群没有强需求的场景

使用方式

启动容器时，可以使用环境变量 MEMORY_MODE 控制是 标准模式 还是 轻量模式

docker run -itd   
    # 其他配置
    -e MEMORY_MODE=true  # true 启用轻量模式，不配置默认为标准模式
    moqisoft/documentserver:9.3.10  # 注意替换为实际镜像名

TIP

轻量模式更适合小规模部署。如果你的业务需要 集群、高可用、横向扩展、大规模协同，建议使用标准方式启动。