ONLYOFFICE 私有部署完整指南：从选型到上线

私有化部署是企业选择 ONLYOFFICE 的核心原因之一。本指南覆盖从服务器选型到上线运维的完整流程，适合技术负责人和 IT 管理人员参考。

一、为什么选择私有部署？

私有部署意味着将 ONLYOFFICE 文档服务器安装在你自己的硬件或云服务器上，所有文档数据都存储在企业内部。核心优势：

• 数据完全自主：文档不经过任何第三方服务器
• 满足合规要求：符合等保2.0、数据安全法、个保法等
• 内网/离线可用：完全隔离网络环境也能正常运行
• 深度定制：可白标、可定制 Logo、可接入内部系统

二、服务器配置要求

最低配置（≤20 并发用户）

• CPU：2 核
• 内存：4 GB RAM
• 存储：40 GB SSD
• 系统：Ubuntu 20.04+ / Debian 11+ / CentOS 8+

推荐配置（20-100 并发用户）

• CPU：4 核
• 内存：8 GB RAM
• 存储：100 GB SSD
• 推荐系统：Ubuntu 22.04 LTS

企业级配置（100+ 并发用户）

• CPU：8 核+
• 内存：16 GB RAM+
• 存储：200 GB SSD+
• 推荐使用负载均衡 + Redis 缓存

注：具体配置需根据实际文档大小、并发量、是否开启 AI 功能等因素综合评估，庚乾提供免费需求评估服务。

三、服务器准备清单

在安装 ONLYOFFICE 之前，确保以下准备完成：

1. 域名 / SSL 证书：建议使用 HTTPS，Let's Encrypt 免费证书或商业证书均可
2. 服务器端口开放：需要开放 80（Let's Encrypt）、443（HTTPS）、5222（内部通信）端口
3. 邮件服务：用于发送注册邀请链接（如已有 SMTP 服务，跳过）
4. 数据库：ONLYOFFICE 默认使用 PostgreSQL（安装包自带，也可使用外部）

四、安装方式对比

方式	难度	适用场景	推荐度
Docker 一键部署	⭐ 简单	有 Docker 经验的团队	⭐⭐⭐⭐⭐
官方安装脚本	⭐⭐ 简单	Ubuntu/Debian 新手	⭐⭐⭐⭐
手动安装（DEB/RPM）	⭐⭐⭐ 中等	需要精细控制的场景	⭐⭐⭐
Kubernetes Helm Chart	⭐⭐⭐⭐ 较难	已有 K8s 集群的企业	⭐⭐⭐⭐

五、Docker 部署步骤（推荐）

前提：服务器已安装 Docker 和 Docker Compose。

# 1. 创建工作目录
mkdir -p /opt/onlyoffice && cd /opt/onlyoffice

# 2. 下载官方 docker-compose.yml
wget https://raw.githubusercontent.com/ONLYOFFICE/Docker-DocumentServer/master/docker-compose.yml

# 3. 修改配置（可选）
# 编辑端口、域名、邮件配置

# 4. 启动服务
docker-compose up -d

# 5. 查看运行状态
docker-compose ps

# 6. 查看日志
docker-compose logs -f

六、安装后必做配置

1. 配置域名：在 Nginx 反向代理中配置域名，绑定 SSL 证书
2. 配置邮件：在管理后台配置 SMTP，确保能发送邀请邮件
3. 创建管理员账户：首次访问后创建超级管理员
4. 配置文档存储路径：建议将文档存储目录挂载到独立的数据盘
5. 配置 JWT 密钥：开启文档服务安全验证（重要！）

七、常见问题

Q：文档打开很慢？

检查服务器资源是否足够（CPU/内存），检查网络带宽。100+ 并发用户建议使用 SSD 存储，并开启 Redis 缓存。

Q：外网无法访问？

检查防火墙端口（443、80）是否开放，检查 Nginx 反向代理配置是否正确。

Q：文档格式出现错位？

ONLYOFFICE 对 DOCX/XLSX/PPTX 兼容性较好，但复杂宏和部分特殊字体可能存在差异，建议在测试阶段全面验证。

Q：如何备份？

ONLYOFFICE 提供内置备份功能，支持全量备份（数据库 + 文档）。建议设置定时备份任务，并将备份文件存储到独立存储。

八、庚乾可以帮您做什么？

如果您觉得部署过程复杂，庚乾提供完整的 ONLYOFFICE 部署实施服务：

• 服务器需求评估与配置推荐
• 生产环境安装部署
• 与现有系统（OA/钉钉/企业微信等）对接
• 用户培训与文档交付
• 后续技术支持与 License 续费