别再手动折腾了！用Docker Compose一键部署DzzOffice+OnlyOffice协同办公平台（附完整配置文件）

基于Docker Compose的DzzOffice+OnlyOffice协同办公平台全自动部署指南

在当今快节奏的数字化工作环境中，企业团队对高效协同办公工具的需求日益增长。传统的手动部署方式不仅耗时耗力，还容易因配置差异导致环境不一致问题。本文将介绍如何利用Docker Compose技术，实现DzzOffice与OnlyOffice文档服务的一键式标准化部署，彻底告别繁琐的手动配置过程。

1. 环境准备与架构设计

1.1 系统需求分析

部署前需确保宿主机满足以下基本要求：

• 操作系统：推荐使用Ubuntu 20.04 LTS或CentOS 8+
• Docker版本：19.03.0及以上
• Docker Compose版本：1.25.0及以上
• 硬件配置：
  • CPU：至少4核
  • 内存：建议8GB以上
  • 存储：50GB可用空间

提示：可通过docker --version和docker-compose --version命令验证当前环境版本

1.2 服务架构解析

本方案采用三组件协同工作模式：

1. MySQL 5.7.27：作为DzzOffice的后端数据库
2. DzzOffice：提供协同办公平台核心功能
3. OnlyOffice Document Server：实现文档在线编辑能力

# 检查系统资源使用情况 free -h df -h

2. Docker Compose配置文件详解

2.1 完整配置方案

创建docker-compose.yml文件，内容如下：

version: '3.8' services: mysql: image: mysql:5.7.27 container_name: dzz-mysql environment: MYSQL_ROOT_PASSWORD: your_secure_password MYSQL_DATABASE: dzzoffice volumes: - mysql_data:/var/lib/mysql networks: - dzz-network restart: unless-stopped dzzoffice: image: imdevops/dzzoffice:latest container_name: dzz-office depends_on: - mysql environment: - DB_HOST=mysql - DB_NAME=dzzoffice - DB_USER=root - DB_PASSWORD=your_secure_password volumes: - dzz_data:/var/www/html/data networks: - dzz-network ports: - "9090:80" restart: unless-stopped onlyoffice: image: onlyoffice/documentserver container_name: dzz-onlyoffice networks: - dzz-network ports: - "9000:80" restart: unless-stopped volumes: mysql_data: dzz_data: networks: dzz-network: driver: bridge

2.2 关键配置说明

• 网络配置：创建专用网络dzz-network确保服务间安全通信
• 数据持久化：
  • MySQL数据存储在mysql_data卷
  • DzzOffice应用数据存储在dzz_data卷
• 环境变量：
  • 必须修改your_secure_password为强密码
  • 数据库连接参数通过环境变量注入

注意：生产环境务必使用复杂密码替代示例中的your_secure_password

3. 部署与初始化流程

3.1 一键启动服务

执行以下命令启动所有服务：

docker-compose up -d

系统将自动完成：

1. 拉取所需镜像（首次运行）
2. 创建持久化卷
3. 建立专用网络
4. 按依赖顺序启动容器

3.2 服务健康检查

验证各容器运行状态：

docker-compose ps

预期输出应显示三个服务的状态均为running：

3.3 DzzOffice初始化配置

1. 访问http://服务器IP:9090/install/index.php
2. 按向导完成安装：
   • 数据库配置：
     • 主机地址填写mysql（使用Docker服务名）
     • 密码为your_secure_password
   • 管理员账户设置
3. 安装完成后进入应用市场，启用OnlyOffice插件

4. 高级配置与优化

4.1 性能调优建议

修改docker-compose.yml添加资源限制：

services: onlyoffice: deploy: resources: limits: cpus: '2' memory: 4G reservations: memory: 2G

4.2 安全加固措施

1. 修改默认端口：

   ports: - "192.168.1.100:18080:80" # 限制只监听内网IP

2. 启用HTTPS：
   • 为OnlyOffice配置SSL证书
   • 使用Nginx反向代理实现全站HTTPS

4.3 备份与恢复方案

创建备份脚本backup.sh：

#!/bin/bash BACKUP_DIR=/opt/dzz_backup/$(date +%Y%m%d) mkdir -p $BACKUP_DIR # 备份MySQL数据 docker exec dzz-mysql mysqldump -uroot -p"your_secure_password" dzzoffice > $BACKUP_DIR/dzzoffice.sql # 备份应用数据 docker run --rm --volumes-from dzz-office -v $BACKUP_DIR:/backup alpine \ tar cvf /backup/dzz_data.tar /var/www/html/data

5. 常见问题排查

5.1 服务启动失败排查

检查容器日志定位问题：

docker-compose logs mysql # 查看MySQL日志 docker-compose logs dzzoffice # 查看DzzOffice日志

5.2 OnlyOffice集成问题

确保DzzOffice中配置的API地址为：

http://服务器IP:9000

5.3 文件权限问题处理

若出现文件上传失败，执行：

docker exec dzz-office chown -R www-data:www-data /var/www/html/data

6. 生产环境部署建议

对于企业级部署，建议考虑以下增强方案：

• 高可用架构：
  • MySQL主从复制
  • OnlyOffice多实例负载均衡
• 监控方案：
  • 使用Prometheus+Grafana监控容器资源使用
  • 设置异常告警机制
• 自动化维护：
  • 通过CI/CD管道实现配置版本控制
  • 定期自动备份验证

实际部署中发现，为OnlyOffice分配充足内存（≥4GB）能显著提升文档渲染性能。网络带宽方面，建议保证至少100Mbps的可用带宽以获得流畅的协同编辑体验。