1. 为什么选择Docker部署协同办公平台最近帮朋友公司搭建内部办公系统时发现传统部署方式实在太折腾了。光是配置LAMP环境就花了半天还要处理各种依赖冲突。后来改用Docker容器化部署整个流程从8小时缩短到30分钟这效率差距让我彻底成了Docker信徒。DzzOffice作为国内知名的开源协同办公平台搭配OnlyOffice的文档编辑能力完全可以替代收费的钉钉文档或腾讯文档。但传统部署方式存在几个痛点环境配置复杂需要手动安装PHP、MySQL、Nginx等组件迁移困难系统重装时所有配置都要从头再来资源隔离差多个服务容易产生端口冲突而Docker方案完美解决了这些问题一键部署所有依赖打包在镜像中快速迁移整个系统可以通过docker-compose文件重建资源隔离每个服务运行在独立容器中实测在4核8G的云服务器上整套系统部署时间不超过15分钟还包括了数据持久化配置。下面我就分享具体操作步骤帮你避开我踩过的那些坑。2. 部署前的准备工作2.1 硬件与系统要求建议使用x86架构的Linux服务器实测ARM架构会有兼容性问题配置建议最低配置2核CPU/4GB内存/50GB硬盘适合20人以内团队推荐配置4核CPU/8GB内存/100GB硬盘支持百人级协作操作系统选择任选其一Ubuntu 20.04/22.04 LTSCentOS 7/8Debian 10/11我在阿里云ECSUbuntu 22.04和本地虚拟机CentOS 7都测试过Docker的优势就是跨平台一致性。2.2 安装Docker引擎不同系统的安装命令略有差异# Ubuntu/Debian sudo apt update sudo apt install -y docker.io sudo systemctl enable --now docker # CentOS sudo yum install -y yum-utils sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo sudo yum install -y docker-ce sudo systemctl enable --now docker安装完成后验证版本docker --version # 推荐Docker 20.102.3 配置镜像加速国内用户建议配置阿里云镜像加速sudo mkdir -p /etc/docker sudo tee /etc/docker/daemon.json -EOF { registry-mirrors: [https://[你的专属ID].mirror.aliyuncs.com] } EOF sudo systemctl restart docker3. 部署MySQL数据库服务3.1 拉取官方镜像推荐使用MySQL 5.7与DzzOffice兼容性最好docker pull mysql:5.73.2 启动容器关键参数说明-v /opt/mysql:/var/lib/mysql数据持久化到宿主机-e MYSQL_ROOT_PASSWORD设置root密码--character-set-serverutf8mb4支持中文存储完整命令docker run -d --name mysql \ -p 3306:3306 \ -v /opt/mysql:/var/lib/mysql \ -e MYSQL_ROOT_PASSWORDyourpassword \ -e MYSQL_DATABASEdzzoffice \ mysql:5.7 \ --character-set-serverutf8mb4 \ --collation-serverutf8mb4_unicode_ci3.3 验证数据库进入容器检查数据库状态docker exec -it mysql mysql -uroot -p # 输入密码后执行 SHOW DATABASES;应该能看到创建的dzzoffice数据库。4. 部署DzzOffice服务4.1 获取官方镜像推荐使用国内优化版镜像docker pull imdevops/dzzoffice:latest4.2 解决数据持久化难题直接挂载data目录会导致权限问题正确做法分三步先创建临时容器获取初始数据docker run --rm -v /tmp/dzzdata:/backup imdevops/dzzoffice \ tar czf /backup/data.tar.gz -C /var/www/html/data .创建持久化目录并解压mkdir -p /opt/dzzoffice/data tar xzf /tmp/dzzdata/data.tar.gz -C /opt/dzzoffice/data chown -R 33:33 /opt/dzzoffice/data # www-data用户权限正式启动容器docker run -d --name dzzoffice \ -p 80:80 \ -v /opt/dzzoffice/data:/var/www/html/data \ --link mysql:mysql \ imdevops/dzzoffice4.3 初始化配置访问http://服务器IP进入安装向导数据库类型选MySQL主机地址填mysql因为用了--link数据库名填dzzoffice密码填之前设置的root密码遇到过安装卡在50%的情况通常是权限问题执行docker exec dzzoffice chown -R www-data:www-data /var/www/html即可解决。5. 集成OnlyOffice文档服务5.1 部署Document Serverdocker pull onlyoffice/documentserver docker run -d --name onlyoffice \ -p 9000:80 \ -v /opt/onlyoffice/logs:/var/log/onlyoffice \ -v /opt/onlyoffice/data:/var/www/onlyoffice/Data \ onlyoffice/documentserver5.2 配置DzzOffice插件登录DzzOffice后台进入应用市场安装OnlyOffice插件在插件设置中填写API地址http://服务器IP:9000文件服务器http://服务器IP5.3 常见问题排查如果文档无法保存检查防火墙是否开放9000端口在OnlyOffice容器内执行supervisorctl restart all查看日志定位问题docker logs -f onlyoffice6. 高级配置与优化6.1 使用docker-compose编排创建docker-compose.yml文件version: 3 services: mysql: image: mysql:5.7 volumes: - /opt/mysql:/var/lib/mysql environment: MYSQL_ROOT_PASSWORD: yourpassword MYSQL_DATABASE: dzzoffice command: - --character-set-serverutf8mb4 - --collation-serverutf8mb4_unicode_ci dzzoffice: image: imdevops/dzzoffice ports: - 80:80 volumes: - /opt/dzzoffice/data:/var/www/html/data depends_on: - mysql onlyoffice: image: onlyoffice/documentserver ports: - 9000:80 volumes: - /opt/onlyoffice/logs:/var/log/onlyoffice - /opt/onlyoffice/data:/var/www/onlyoffice/Data启动命令docker-compose up -d6.2 性能调优建议MySQL优化docker exec -it mysql bash -c echo innodb_buffer_pool_size1G /etc/mysql/conf.d/custom.cnf docker restart mysqlOnlyOffice内存限制# 在docker-compose.yml中添加 onlyoffice: deploy: resources: limits: memory: 2G定期备份方案# 数据库备份 docker exec mysql sh -c exec mysqldump --all-databases -uroot -p$MYSQL_ROOT_PASSWORD /backup/db-$(date %F).sql # 文件备份 tar czf /backup/dzzoffice-$(date %F).tar.gz -C /opt/dzzoffice/data .6.3 HTTPS安全配置使用Nginx反向代理配置SSLserver { listen 443 ssl; server_name office.yourdomain.com; ssl_certificate /path/to/cert.pem; ssl_certificate_key /path/to/key.pem; location / { proxy_pass http://dzzoffice; } location /office { proxy_pass http://onlyoffice:80; } }7. 实际使用体验分享部署完这套系统后朋友公司已经稳定使用了3个月。相比之前用某钉的付费版本主要有这些优势完全掌控数据所有文件都存在自己的服务器上深度定制可以根据需求修改界面和功能成本节约省去了每人每年几百元的SaaS费用遇到的坑也不少OnlyOffice中文乱码需要手动导入字体大文件上传超时要调整PHP的upload_max_filesize移动端适配DzzOffice的响应式设计还有优化空间建议日常维护时每周检查容器日志每月更新一次镜像版本使用docker system prune定期清理无用镜像
Docker容器化部署DzzOffice与OnlyOffice：打造高效私有化协同办公平台
1. 为什么选择Docker部署协同办公平台最近帮朋友公司搭建内部办公系统时发现传统部署方式实在太折腾了。光是配置LAMP环境就花了半天还要处理各种依赖冲突。后来改用Docker容器化部署整个流程从8小时缩短到30分钟这效率差距让我彻底成了Docker信徒。DzzOffice作为国内知名的开源协同办公平台搭配OnlyOffice的文档编辑能力完全可以替代收费的钉钉文档或腾讯文档。但传统部署方式存在几个痛点环境配置复杂需要手动安装PHP、MySQL、Nginx等组件迁移困难系统重装时所有配置都要从头再来资源隔离差多个服务容易产生端口冲突而Docker方案完美解决了这些问题一键部署所有依赖打包在镜像中快速迁移整个系统可以通过docker-compose文件重建资源隔离每个服务运行在独立容器中实测在4核8G的云服务器上整套系统部署时间不超过15分钟还包括了数据持久化配置。下面我就分享具体操作步骤帮你避开我踩过的那些坑。2. 部署前的准备工作2.1 硬件与系统要求建议使用x86架构的Linux服务器实测ARM架构会有兼容性问题配置建议最低配置2核CPU/4GB内存/50GB硬盘适合20人以内团队推荐配置4核CPU/8GB内存/100GB硬盘支持百人级协作操作系统选择任选其一Ubuntu 20.04/22.04 LTSCentOS 7/8Debian 10/11我在阿里云ECSUbuntu 22.04和本地虚拟机CentOS 7都测试过Docker的优势就是跨平台一致性。2.2 安装Docker引擎不同系统的安装命令略有差异# Ubuntu/Debian sudo apt update sudo apt install -y docker.io sudo systemctl enable --now docker # CentOS sudo yum install -y yum-utils sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo sudo yum install -y docker-ce sudo systemctl enable --now docker安装完成后验证版本docker --version # 推荐Docker 20.102.3 配置镜像加速国内用户建议配置阿里云镜像加速sudo mkdir -p /etc/docker sudo tee /etc/docker/daemon.json -EOF { registry-mirrors: [https://[你的专属ID].mirror.aliyuncs.com] } EOF sudo systemctl restart docker3. 部署MySQL数据库服务3.1 拉取官方镜像推荐使用MySQL 5.7与DzzOffice兼容性最好docker pull mysql:5.73.2 启动容器关键参数说明-v /opt/mysql:/var/lib/mysql数据持久化到宿主机-e MYSQL_ROOT_PASSWORD设置root密码--character-set-serverutf8mb4支持中文存储完整命令docker run -d --name mysql \ -p 3306:3306 \ -v /opt/mysql:/var/lib/mysql \ -e MYSQL_ROOT_PASSWORDyourpassword \ -e MYSQL_DATABASEdzzoffice \ mysql:5.7 \ --character-set-serverutf8mb4 \ --collation-serverutf8mb4_unicode_ci3.3 验证数据库进入容器检查数据库状态docker exec -it mysql mysql -uroot -p # 输入密码后执行 SHOW DATABASES;应该能看到创建的dzzoffice数据库。4. 部署DzzOffice服务4.1 获取官方镜像推荐使用国内优化版镜像docker pull imdevops/dzzoffice:latest4.2 解决数据持久化难题直接挂载data目录会导致权限问题正确做法分三步先创建临时容器获取初始数据docker run --rm -v /tmp/dzzdata:/backup imdevops/dzzoffice \ tar czf /backup/data.tar.gz -C /var/www/html/data .创建持久化目录并解压mkdir -p /opt/dzzoffice/data tar xzf /tmp/dzzdata/data.tar.gz -C /opt/dzzoffice/data chown -R 33:33 /opt/dzzoffice/data # www-data用户权限正式启动容器docker run -d --name dzzoffice \ -p 80:80 \ -v /opt/dzzoffice/data:/var/www/html/data \ --link mysql:mysql \ imdevops/dzzoffice4.3 初始化配置访问http://服务器IP进入安装向导数据库类型选MySQL主机地址填mysql因为用了--link数据库名填dzzoffice密码填之前设置的root密码遇到过安装卡在50%的情况通常是权限问题执行docker exec dzzoffice chown -R www-data:www-data /var/www/html即可解决。5. 集成OnlyOffice文档服务5.1 部署Document Serverdocker pull onlyoffice/documentserver docker run -d --name onlyoffice \ -p 9000:80 \ -v /opt/onlyoffice/logs:/var/log/onlyoffice \ -v /opt/onlyoffice/data:/var/www/onlyoffice/Data \ onlyoffice/documentserver5.2 配置DzzOffice插件登录DzzOffice后台进入应用市场安装OnlyOffice插件在插件设置中填写API地址http://服务器IP:9000文件服务器http://服务器IP5.3 常见问题排查如果文档无法保存检查防火墙是否开放9000端口在OnlyOffice容器内执行supervisorctl restart all查看日志定位问题docker logs -f onlyoffice6. 高级配置与优化6.1 使用docker-compose编排创建docker-compose.yml文件version: 3 services: mysql: image: mysql:5.7 volumes: - /opt/mysql:/var/lib/mysql environment: MYSQL_ROOT_PASSWORD: yourpassword MYSQL_DATABASE: dzzoffice command: - --character-set-serverutf8mb4 - --collation-serverutf8mb4_unicode_ci dzzoffice: image: imdevops/dzzoffice ports: - 80:80 volumes: - /opt/dzzoffice/data:/var/www/html/data depends_on: - mysql onlyoffice: image: onlyoffice/documentserver ports: - 9000:80 volumes: - /opt/onlyoffice/logs:/var/log/onlyoffice - /opt/onlyoffice/data:/var/www/onlyoffice/Data启动命令docker-compose up -d6.2 性能调优建议MySQL优化docker exec -it mysql bash -c echo innodb_buffer_pool_size1G /etc/mysql/conf.d/custom.cnf docker restart mysqlOnlyOffice内存限制# 在docker-compose.yml中添加 onlyoffice: deploy: resources: limits: memory: 2G定期备份方案# 数据库备份 docker exec mysql sh -c exec mysqldump --all-databases -uroot -p$MYSQL_ROOT_PASSWORD /backup/db-$(date %F).sql # 文件备份 tar czf /backup/dzzoffice-$(date %F).tar.gz -C /opt/dzzoffice/data .6.3 HTTPS安全配置使用Nginx反向代理配置SSLserver { listen 443 ssl; server_name office.yourdomain.com; ssl_certificate /path/to/cert.pem; ssl_certificate_key /path/to/key.pem; location / { proxy_pass http://dzzoffice; } location /office { proxy_pass http://onlyoffice:80; } }7. 实际使用体验分享部署完这套系统后朋友公司已经稳定使用了3个月。相比之前用某钉的付费版本主要有这些优势完全掌控数据所有文件都存在自己的服务器上深度定制可以根据需求修改界面和功能成本节约省去了每人每年几百元的SaaS费用遇到的坑也不少OnlyOffice中文乱码需要手动导入字体大文件上传超时要调整PHP的upload_max_filesize移动端适配DzzOffice的响应式设计还有优化空间建议日常维护时每周检查容器日志每月更新一次镜像版本使用docker system prune定期清理无用镜像
