别再手动折腾了！用Docker Compose一键部署DzzOffice+OnlyOffice协同办公环境（附完整YAML配置）
高效协同办公新方案：Docker Compose全栈部署DzzOffice与OnlyOffice
在团队协作场景中，文档处理与文件共享是刚需，但传统部署方式往往需要繁琐的环境配置和组件调试。想象一下这样的场景：当你需要为团队快速搭建一套完整的在线办公系统时，传统方法可能需要分别安装数据库、Web应用和文档服务，处理各种依赖关系和网络配置，整个过程耗时且容易出错。这正是容器化技术大显身手的领域——通过Docker Compose，我们能够用声明式配置一键部署所有服务。
本文将介绍如何利用Docker Compose编排MySQL、DzzOffice和OnlyOffice三个关键组件，构建一个开箱即用的协同办公环境。与手动逐个启动容器的方式相比，这种方法具有以下显著优势：
- 环境一致性：所有服务版本和配置集中管理，避免"在我机器上能运行"的问题
- 快速部署：单个命令即可启动完整系统，适合开发、测试和生产环境
- 资源隔离：各服务运行在独立容器中，互不干扰又可通过网络通信
- 配置即文档：docker-compose.yml文件本身就是系统架构的最佳说明
1. 环境准备与架构设计
在开始部署前，我们需要明确整个系统的架构设计。这套协同办公解决方案由三个核心组件构成：
- MySQL 5.7：作为DzzOffice的后端数据库存储用户数据和系统配置
- DzzOffice：提供文件管理和协作平台的基础框架
- OnlyOffice Document Server：实现文档的在线编辑和协作功能
这三个组件的关系如下图所示（虽然不能展示实际图表，但可以描述）：DzzOffice作为前端界面与用户交互，将文档数据存储在MySQL中，当用户需要编辑文档时，通过集成接口调用OnlyOffice的服务。
1.1 系统要求
确保部署机器满足以下最低配置：
- 操作系统：支持Docker的Linux发行版（如Ubuntu 18.04+、CentOS 7+）
- 内存：至少4GB（OnlyOffice需要2GB以上内存）
- 磁盘空间：20GB以上可用空间
- Docker版本：19.03+
- Docker Compose版本：1.25+
使用以下命令检查环境是否符合要求：
# 检查Docker版本 docker --version # 检查Docker Compose版本 docker-compose --version1.2 目录结构规划
合理的目录结构能有效管理配置和数据文件。建议在宿主机上创建如下目录：
/opt/office_stack/ ├── docker-compose.yml # 编排配置文件 ├── mysql/ │ └── data/ # 数据库持久化数据 └── dzzoffice/ └── data/ # DzzOffice应用数据提示：生产环境建议将数据目录挂载到独立的数据盘或存储系统上，避免系统盘空间不足。
2. Docker Compose编排配置
下面是我们精心设计的docker-compose.yml文件，它定义了三个服务及其相互关系：
version: '3.8' services: mysql: image: mysql:5.7.27 container_name: office_mysql environment: MYSQL_ROOT_PASSWORD: "SecurePass123!" MYSQL_DATABASE: dzzoffice MYSQL_USER: dzzuser MYSQL_PASSWORD: "UserPass456!" volumes: - /opt/office_stack/mysql/data:/var/lib/mysql networks: - office_network restart: unless-stopped healthcheck: test: ["CMD", "mysqladmin", "ping", "-h", "localhost"] interval: 5s timeout: 5s retries: 5 dzzoffice: image: imdevops/dzzoffice:latest container_name: office_dzz depends_on: mysql: condition: service_healthy volumes: - /opt/office_stack/dzzoffice/data:/var/www/html/data environment: - TZ=Asia/Shanghai ports: - "9090:80" networks: - office_network restart: unless-stopped onlyoffice: image: onlyoffice/documentserver container_name: office_docs ports: - "9000:80" networks: - office_network restart: unless-stopped environment: - JWT_ENABLED=false - TZ=Asia/Shanghai networks: office_network: driver: bridge这个配置文件的几个关键设计点：
- 网络隔离：创建专用网络
office_network，确保服务间通信安全 - 健康检查：MySQL服务添加健康检查，确保DzzOffice只在数据库就绪后启动
- 环境变量：集中管理敏感信息，实际生产环境应使用Docker secrets
- 时区设置：统一设置Asia/Shanghai时区，避免时间显示问题
2.1 配置参数说明
下表列出了主要可定制参数及其作用：
| 参数 | 服务 | 说明 | 默认值 | 是否必需 |
|---|---|---|---|---|
| MYSQL_ROOT_PASSWORD | mysql | 数据库root密码 | 无 | 是 |
| MYSQL_DATABASE | mysql | 自动创建的数据库名 | dzzoffice | 否 |
| MYSQL_USER | mysql | 自动创建的用户名 | dzzuser | 否 |
| MYSQL_PASSWORD | mysql | 自动用户的密码 | 无 | 否 |
| TZ | 所有 | 容器时区设置 | Asia/Shanghai | 否 |
| JWT_ENABLED | onlyoffice | 是否启用JWT验证 | false | 否 |
注意：生产环境中务必使用强密码，并考虑使用
.env文件管理敏感信息，避免将密码直接写入YAML文件。
3. 部署与初始化
有了docker-compose.yml文件后，部署变得异常简单。在配置文件所在目录执行：
# 启动所有服务（后台模式） docker-compose up -d # 查看服务状态 docker-compose ps系统启动后，需要进行DzzOffice的初始化配置。打开浏览器访问：
http://<服务器IP>:9090/install/index.php按照安装向导完成以下步骤：
数据库配置：
- 数据库服务器：
mysql（使用Docker服务名） - 数据库名：
dzzoffice（或compose中指定的名称） - 用户名和密码：对应compose中的MYSQL_USER和MYSQL_PASSWORD
- 数据库服务器：
管理员账户设置：创建系统管理员账号
OnlyOffice集成：
- 进入"应用市场"安装"OnlyOffice"插件
- 在插件设置中输入OnlyOffice服务地址：
http://<服务器IP>:9000 - 设置DzzOffice服务器地址：
http://<服务器IP>:9090
3.1 常见问题排查
部署过程中可能会遇到以下问题及解决方案：
权限问题：如果DzzOffice无法写入data目录，执行：
docker exec office_dzz chown -R www-data:www-data /var/www/html/dataOnlyOffice无法连接：
- 检查OnlyOffice容器是否正常运行：
docker logs office_docs - 确保防火墙开放了9000端口
- 检查OnlyOffice容器是否正常运行：
MySQL连接失败：
- 确认MySQL容器健康状态：
docker inspect office_mysql - 检查网络连通性：
docker exec office_dzz ping mysql
- 确认MySQL容器健康状态：
4. 系统优化与维护
部署完成后，还需要考虑以下优化措施：
4.1 数据备份策略
定期备份是生产环境的基本要求。建议设置以下备份方案：
# MySQL数据库备份 docker exec office_mysql mysqldump -u root -p"SecurePass123!" dzzoffice > backup.sql # DzzOffice文件备份 tar czvf dzzoffice_backup.tar.gz /opt/office_stack/dzzoffice/data可以将这些命令加入crontab实现自动备份：
0 2 * * * /usr/bin/docker exec office_mysql mysqldump -u root -p"SecurePass123!" dzzoffice > /backups/mysql_$(date +\%Y\%m\%d).sql 0 3 * * * /bin/tar czvf /backups/dzzoffice_$(date +\%Y\%m\%d).tar.gz /opt/office_stack/dzzoffice/data4.2 性能调优
对于团队使用场景，可以调整以下参数提升性能：
OnlyOffice：
- 增加文档处理worker数量
- 配置Redis缓存
MySQL：
- 调整InnoDB缓冲池大小
- 优化查询缓存
对应的docker-compose.yml调整示例：
onlyoffice: environment: - WORKER_PROCESSES=4 - REDIS_SERVER_HOST=redis redis: image: redis:alpine networks: - office_network4.3 版本升级
当需要升级组件版本时，推荐流程：
- 备份数据和配置
- 修改docker-compose.yml中的镜像版本
- 执行：
docker-compose pull docker-compose up -d
这种基于Docker Compose的部署方式，使得系统维护和升级变得简单可控。