OnlyOffice社区版Docker私有化部署全流程指南

一、部署前环境准备与规划

1.1 硬件资源评估

OnlyOffice社区版Docker部署需满足最低硬件要求：建议配置4核CPU、8GB内存及50GB存储空间。对于企业级场景，需根据并发用户数动态调整资源，例如每50个并发用户需增加2核CPU与4GB内存。存储规划需考虑文档库增长，建议采用LVM逻辑卷管理实现弹性扩容。

1.2 操作系统选型

推荐使用Ubuntu 22.04 LTS或CentOS 7/8系统，其内核版本需≥3.10以支持Docker完整功能。通过uname -r命令验证内核版本，若低于要求需使用yum update或apt upgrade进行系统升级。

1.3 Docker环境配置

执行以下命令安装Docker CE版：

# Ubuntu系统
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
# CentOS系统
yum install -y yum-utils device-mapper-persistent-data lvm2
yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
yum install docker-ce docker-ce-cli containerd.io
systemctl enable --now docker

安装后通过docker version验证安装状态，确保Client与Server版本均≥20.10。

二、Docker镜像获取与配置

2.1 官方镜像拉取

OnlyOffice社区版官方提供onlyoffice/documentserver镜像，执行以下命令获取最新稳定版：

docker pull onlyoffice/documentserver:latest

对于特定版本需求，可指定版本号如7.4.1-1，通过docker images查看已下载镜像。

2.2 容器参数配置

核心配置参数需通过-e环境变量传递：

• JWT_ENABLED=true：启用JWT令牌验证
• JWT_SECRET=your_secret_key：设置加密密钥（建议≥32字符）
• DB_HOST=db_container：数据库容器名（若使用外部数据库）
• FILE_SIZE_LIMIT=100：最大文件上传限制（单位MB）

完整启动命令示例：

docker run -i -t -d -p 8080:80 \
  --restart=always \
  -e JWT_ENABLED=true \
  -e JWT_SECRET=secure_key_123 \
  -e FILE_SIZE_LIMIT=200 \
  --name onlyoffice \
  onlyoffice/documentserver

三、数据持久化与备份方案

3.1 存储卷映射

通过-v参数实现数据持久化，建议映射三个关键目录：

-v /path/to/logs:/var/log/onlyoffice \
-v /path/to/data:/var/www/onlyoffice/Data \
-v /path/to/fonts:/usr/share/fonts

其中数据目录需设置755权限，避免因权限问题导致服务异常。

3.2 自动化备份策略

建议使用Cron定时任务执行备份，示例脚本如下：

#!/bin/bash
BACKUP_DIR="/backups/onlyoffice_$(date +%Y%m%d)"
mkdir -p $BACKUP_DIR
docker exec onlyoffice tar czf $BACKUP_DIR/data.tar.gz /var/www/onlyoffice/Data
find /backups -name "onlyoffice_*" -mtime +30 -exec rm -rf {} \;

设置每天凌晨2点执行：

0 2 * * * /path/to/backup_script.sh

四、网络优化与安全配置

4.1 反向代理集成

Nginx配置示例：

server {
    listen 80;
    server_name docs.yourdomain.com;
    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
    client_max_body_size 200M;
}

需注意client_max_body_size应与容器内FILE_SIZE_LIMIT参数保持一致。

4.2 HTTPS证书部署

使用Let’s Encrypt免费证书：

docker run -it --rm \
  -v /etc/letsencrypt:/etc/letsencrypt \
  -v /var/lib/letsencrypt:/var/lib/letsencrypt \
  certbot/certbot certonly --standalone -d docs.yourdomain.com

证书更新后需重启OnlyOffice容器使配置生效。

五、运维管理与故障排查

5.1 日志分析技巧

关键日志文件位于/var/log/onlyoffice/documentserver/，常见问题排查：

• 502错误：检查Nginx与容器端口连通性curl -I http://localhost:8080
• 文档转换失败：查看converter.log中的LibreOffice进程状态
• JWT验证失败：确认JWT_SECRET一致性及时间同步ntpdate pool.ntp.org

5.2 容器健康检查

配置Docker健康检查：

docker run ... \
  --health-cmd="curl -f http://localhost:8080/healthcheck || exit 1" \
  --health-interval=30s \
  --health-retries=3 \
  ...

通过docker inspect onlyoffice | grep Health查看容器健康状态。

六、性能调优建议

6.1 并发处理优化

对于高并发场景，建议调整以下参数：

• MAX_CONCURRENT_CONVERSIONS=10：文档转换并发数
• WORKER_PROCESSES=4：Node.js工作进程数
• MEMORY_LIMIT=2048：内存限制（单位MB）

6.2 缓存机制配置

启用Redis缓存可显著提升性能：

docker run -d --name redis redis
docker run ... \
  -e REDIS_SERVER=redis \
  -e REDIS_PORT=6379 \
  ...

七、升级与版本管理

7.1 滚动升级策略

1. 拉取新版本镜像：docker pull onlyoffice/documentserver:7.5.0
2. 创建临时容器测试：

   docker run -d --name onlyoffice_temp \
   -e JWT_SECRET=your_secret \
   -p 8081:80 \
   onlyoffice/documentserver:7.5.0

3. 验证功能正常后，停止旧容器并重命名：

   docker stop onlyoffice
   docker rename onlyoffice onlyoffice_old
   docker rename onlyoffice_temp onlyoffice

7.2 回滚机制

若升级出现问题，可通过以下命令快速回滚：

docker stop onlyoffice
docker rename onlyoffice onlyoffice_new
docker rename onlyoffice_old onlyoffice
docker start onlyoffice

八、企业级扩展方案

8.1 集群部署架构

采用Docker Swarm实现多节点部署：

# 初始化Swarm集群
docker swarm init
# 部署服务
docker service create --name onlyoffice \
  --publish published=8080,target=80 \
  --replicas 3 \
  --env JWT_SECRET=cluster_key \
  onlyoffice/documentserver

8.2 监控系统集成

推荐Prometheus+Grafana监控方案，关键指标包括：

• 文档转换成功率
• 平均响应时间
• 内存使用率
• 并发连接数

通过以上完整流程，开发者可在30分钟内完成OnlyOffice社区版的Docker私有化部署，并建立完善的运维管理体系。实际部署中需根据具体业务场景调整参数配置，建议首次部署后进行压力测试验证系统稳定性。