项目详情
Docker-DocumentServer
自托管在线 Office 的事实入口——ONLYOFFICE 文档服务器的官方 Docker 打包
GitHub 地址
AGPL-3.0
2.4k Stars / 11 年仓库
Shell · Docker
OOXML 完全兼容
更新于 2026-09-11
← 返回汇总
项目速览
一句话定位
一条命令,私有化 Google Docs
ONLYOFFICE Document Server 的官方 Docker 镜像仓库:文档/表格/演示/PDF/表单编辑器全家桶,完全兼容 OOXML(.docx/.xlsx/.pptx),实时协作编辑。它是 Nextcloud、Odoo、Moodle、Seafile 等自托管生态补上「在线 Office」拼图的事实标准方案。注意定位:此仓库是打包层(Shell/Dockerfile),编辑器引擎核心在 ONLYOFFICE/DocumentServer 主仓——但它是绝大多数人接触这套引擎的入口。11 年持续维护,AGPL 社区版免费。
项目速览
核心数据
数据来源:GitHub API,采集于 2026-09-11。ubuntu 24.04 base;数据卷规范齐全;有安全补丁镜像重建机制;28 open issues(相对低)。
为什么存在
自托管拼图的最后一块:在线 Office
自托管的世界缺一块
Nextcloud 管文件、Seafile 管同步、Odoo 管 ERP、Moodle 管课程——但「在浏览器里协作编辑 docx」长期是空白。Google Docs 的能力,私有化部署里没有对应物。
OOXML 保真是护城河
LibreOffice 系在线方案对 .docx 的渲染偏差是老大难。ONLYOFFICE 从 OOXML 格式反推引擎设计,保真度是其对抗 Collabora 的核心卖点。
连接器即分发
不直接面向终端用户,而是作为嵌入组件:装进 Nextcloud 就有在线 Office,装进 Odoo 就有文档协作——连接器列表就是它的渠道网络。
此仓库的角色:把这套引擎打成「docker run 一条命令」即可用的镜像——自托管办公栈(如 Nextcloud + ONLYOFFICE)的标准拼图。
诚实定位
先说清:这是打包仓库,不是引擎
- 此仓库包含:Dockerfile、运行脚本、HTTPS/证书配置、compose 示例、数据卷规范——把 Document Server 变成镜像的全部运维件
- 编辑器引擎在主仓:ONLYOFFICE/DocumentServer(及 sdkjs/core 等子仓)才是文字/表格/演示引擎本体
- 为什么值得单独收录:对自托管用户,这就是接触面的全部——镜像质量、数据卷设计、升级策略才是日常运维的真实对象
三版本结构
Community(本镜像,免费 AGPL)/Enterprise(付费)/ Developer(付费授权开发)。EE/DE 版镜像内置 PostgreSQL/RabbitMQ/Redis 并开放数据卷;社区版部署更精简。商业公司的经典开源 + 付费双轨。
核心机制
镜像里的世界
服务层
内置依赖层
使用
一条命令与它的扩展轴
sudo docker run -i -t -d -p 80:80 onlyoffice/documentserver
# 就这么简单——然后到 Nextcloud/Odoo 里填这个地址
- HTTPS 三条路:Let's Encrypt 自动签发 / 自签证书 + 客户端信任 / CA 证书挂载——文档逐条给出
- 数据卷六个挂载点:日志/证书/缓存/DB/MQ/Redis 各自独立,升级镜像不丢数据
- compose 编排:与 Community Server、Mail Server 组成 ONLYOFFICE Workspace 全家桶,也可单飞
- IPv6 支持文档化:现代网络环境不再是坑
运维文档的完整度是老仓库的底蕴:从证书加强到安全头配置,自托管常见问题基本都有对应章节。
生态与商业模式
AGPL 双轨:社区免费,企业付费
AGPL 的用意
网络服务条款(AGPL §13)要求提供网络服务也得开源修改——防云厂商白嫖引擎做竞争产品。对自用/内部部署无感,对 SaaS 化是实质性约束。
社区版的隐含限制
Community 版有并发连接数上限(20)——README 不显眼处的事实标准限制。超出即需 Enterprise。个人/小团队通常无感,中型组织要算这笔账。
安全响应记录
仓库有「secure patched images from scratch」重建机制——漏洞披露后从零重建镜像并按发布顺序 retag,安全响应流程工程化。
判断框架:AGPL + 连接数限制不是缺陷而是商业模式——公司靠 EE/DE 养引擎,社区版作为获客与生态底座。11 年持续投入是这个模式跑通的证明。
风险与局限
重量级单体的代价
- 资源重:4GB+ RAM、2GB swap、内置三件套(DB/MQ/Redis)——个人 VPS 要掂量,树莓派党直接劝退
- 单体镜像哲学:all-in-one 与云原生拆分部署相悖——Kubernetes 人群需要改造(Helm chart 另行提供)
- 20 并发连接墙:Community 版超限需付费升级,团队规模增长到一半就该规划预算
- 中文生态细节:默认字体不含中文族,中文文档渲染需自行注入字体(常见自托管吐槽点)
- 升级即迁移:大版本升级涉及内置 DB schema 变更——数据卷规范虽好,也要按文档操作
- AGPL 合规成本:若你的产品嵌入它对外提供服务,AGPL 义务传导需要法务过目
潜力评估
打分
| 维度 | 评分 | 依据 |
| 生态位价值 | | Nextcloud 系自托管在线 Office 的事实标准拼图 |
| OOXML 保真 | | 格式反推引擎设计,与 MS Office 互转保真度业界领先 |
| 运维完善度 | | 11 年打磨:数据卷/证书/compose/IPv6/安全重建机制 |
| 资源效率 | | 4GB+ 内存 + 内置三件套,单体镜像重 |
| 许可友好度 | | AGPL + 20 连接墙——自用无感,商用有门槛 |
综合 8/10。它不是明星型项目,而是自托管世界里「水电煤」级别的存在——11 年维护 + 连接器生态 + OOXML 保真构成的三重确定性,让它在自托管 Office 这个细分几乎没有对手(Collabora 是唯一量级相近的替代)。
最终裁决
适合谁,不适合谁
用
- Nextcloud/Seafile 用户想加在线协作编辑——官方连接器即插
- 企业内网需要 OOXML 高保真读写(与 MS Office 互转不糊)
- 教育/ERP 场景(Moodle/Odoo 集成)
- 接受 AGPL 义务或 20 连接内的小团队——免费额度刚刚好
别用
- 低配 VPS/ARM 小盒子(4GB+ RAM 门槛,先看资源)
- SaaS 化对外服务而不愿开源修改(AGPL 义务 + 20 连接墙双重约束)
- 只要「能打开」不要协作编辑的场景(有点杀鸡用牛刀)
- Kubernetes 重度环境不愿改造单体镜像的团队