IT技术之家 网络技术 Dzzoffice 2.4.1 + onlyoffice 通过Docker-compose快速部署教程(实现在线协同办公)

    Dzzoffice 2.4.1 + onlyoffice 通过Docker-compose快速部署教程(实现在线协同办公)

    DzzOffice介绍

    DzzOffice是一套开源办公套件,适用于企业、团队搭建自己的 类似“Google企业应用套件”、“微软Office365”的企业协同办公平台。系统本身是一款图形化,简单易用的网盘管理软件。

    实现企业文档、文件统一管理的目的。然后通各类办公应用的接入(如文档在线查看编辑、图片在线查看编辑、讨论板、任务板等)实现企业在线协同办公、提高工作效率的目的。

    DzzOffice第三方扩展插件推荐阅读:Dzzoffice 插件离线安装教程 + 第三方实用插件包下载

    DzzOffice使用手册推荐阅读:Dzzoffice 使用教程

    DzzOffice

    更新日志

    V2.4.1 主要更新内容

    一、新增功能(Added)

    • 【网盘】新增文件夹和文件的单独权限设置功能,优先遵循自身权限,未设置时自动继承上级目录权限;新增分享文件的重命名功能
    • 【网盘】支持设置同名文件的处理方式(覆盖/重命名)及文档显示模式;支持文件并发上传,提升多文件上传效率
    • 【网盘】群组管理支持按群组名称搜索,支持显示群组已使用空间和总空间大小情况
    • 【网盘】新增文件元数据悬停提示,方便查看文件核心信息
    • 【组件】评论附件与编辑器附件支持保存到网盘,扩展附件存储渠道
    • 【应用管理】应用市场-本地应用管理支持显示未安装的管理员应用,便于统一管理
    • 【界面自定义】注册页支持“隐藏”或“可选”邮箱字段,登录页支持隐藏找回密码按钮,适配不同场景需求
    • 【系统工具】计划任务页面添加触发方式提示,提高操作指导性
    • 【分享页面】新增用户举报功能,支持用户反馈违规的分享内容,管理员可在后台进行处理。

    二、优化改进(Improved)

    • 【网盘】整体性能大幅提升,优化权限处理逻辑,减少冗余查询
    • 【网盘】优化文件夹详情页加载速度,异步获取文件夹大小及文件数量,减少等待时间
    • 【网盘】优化移动设备体验;修复点击网络挂载时滚动条跳动的问题;优化分享文件/删除文件的缩略图展示
    • 【网盘】移除历史版本列表的独立展示,归入“版本”选项卡统一管理,简化界面布局
    • 【UI】优化安装页面、首页、通知中心、用户中心、登录模板4及系统设置侧边栏的UI,提升视觉一致性
    • 【系统】优化用户登录后的页面跳转逻辑;优化安装程序代码及数据库检测逻辑,解决初始化提示问题
    • 【系统】优化头像展示逻辑:当UID为空/0时默认显示游客头像;优化头像生成性能(减少对user/user_setting表的重复查询),提升加载速度;优化数据表格交互体验
    • 【系统】优化fetch_all_ext方法,避免重复查询appid;优化模板解析器,修复部分场景下的报错问题
    • 【系统】优化lang()函数的缓存机制,减少重复解析的开销,提升系统整体性能
    • 【组件】Layui 组件更新至 V2.13.2,提升组件稳定性与兼容性
    • 【组件】精简文件位置选择组件功能并修复已知问题
    • 【环境适配】安装程序适配环境变量,自动初始化数据库信息,检测到Redis则启用内存优化;完成PHP8兼容性处理
    • 【系统】调整系统报错时的默认展示规则,默认仅显示错误本身,以防范安全问题
    • 【系统】优化用户删除逻辑,清理更多关联用户数据,减少冗余数据残留
    • 【机构用户】优化机构用户验证表单的提示信息,提高错误指引的清晰度和准确性
    • 【文件管理】【系统日志】【评论】支持URL地址变化适配

    三、Bug修复(Fixed)

    3.1 核心功能模块

    • 【网盘】修复上传非文件夹时触发左侧栏文件夹层级更新、拖拽上传文件夹重复创建的问题
    • 【网盘】修复纯数字排序异常、排序切换两次请求、前端文件/文件夹名称数字排序异常问题
    • 【网盘】修复搜索文件后按修改时间排序报错及多个搜索场景误触问题
    • 【网盘】修复删除文件夹后子文件夹状态未更新、获取文件夹大小属性值异常的问题
    • 【网盘】修复新建文件夹无限递归无响应、新建文件触发两次加载缩略图问题
    • 【网盘】修复在Redis缓存场景下网盘功能设置失效、文件不显示的问题
    • 【网盘】修复文件夹删除/复制权限判断错误、前端重命名功能权限判断错误的问题
    • 【网盘】修复查看机构部门信息时权限判断错误提示、链接类型文件权限显示不正确的问题
    • 【网盘】修复因文件夹可创建历史版本而导致的一系列问题;修复部分情况下不显示上传更新文件版本及历史版本信息错误的问题
    • 【网盘】修复无法保存分享文件、下载文件夹内容以及在分享框中无法删除分享文件的问题
    • 【网盘】修复部分缩略图显示异常、在网盘异常情况下无提示的问题
    • 【网盘】修复按文件类型查看文件时,排序方式无法保存的问题
    • 【网盘】修复取消分享时的错误提示文案,提升提示准确性
    • 【网盘】修复网络挂载无法正常显示文件列表及提示无权限的问题
    • 【系统】修复普通成员可进入后台及系统管理员权限异常的问题
    • 【系统】修复应用启用/关闭后缓存未实时显示/隐藏的问题;修复应用卸载的bug、在线更新应用页面链接错误及跨域兼容性问题
    • 【系统】修复配置文件config_default配置合并丢失的问题;修复伪静态已知问题
    • 【系统】修复 WOPI 接口系列问题及相关安全风险
    • 【系统】修复后台访问操作记录中部分参数缺失的问题,完善日志数据的完整性
    • 【系统】修复登录日志重复记录的问题,确保日志数据的唯一性

    3.2 机构与用户管理

    • 【机构用户】在修复已存在的用户数据时,会删除用户所在群组的问题
    • 【机构用户】解决导出用户数据时无法选择真实姓名、生肖、星座字段的问题
    • 【机构用户】修复机构用户中部门无法更改为机构(二级部门不能转换为一级部门)的问题
    • 【机构用户】修复添加机构部门管理员时权限判断错误的问题(已更正为判断上级权限)
    • 【机构用户】修复普通管理员可修改系统管理员信息的权限越权问题

    3.3 组件与表单

    • 【组件】修复文件选择框打开时默认路径未被选中的交互问题
    • 【组件】修复当仅选择自己所在机构部门时,无法选择子级的问题
    • 【表单】修复部分表单不支持填充内容的问题;修复登录注册表单自动填充异常的问题
    • 【系统设置】修复无法新建权限包的问题

    3.4 分享管理

    • 【分享】修复在分享文件不存在时状态被错误恢复的问题;修复分享管理页面的若干显示异常问题

    3.5 其他修复

    • 【通用】解决一些已知问题,提升系统整体稳定性

    四、安全增强(Security)

    • 【网盘】修复了即使没有下载权限也能下载文件的漏洞,index.php?mod=io&op=download 接口新增了权限验证。
    • 【权限管理】调整网盘回收站权限:系统管理员只能通过文件管理查看非管理文件,加强数据隔离
    • 【权限管理】分享管理应用和文件管理应用调整为仅管理员可用,以防止越权操作的风险。
    • 【访问控制】在多个位置添加游客权限拦截逻辑,限制未授权访问
    • 【漏洞修复】修复其他已知的安全漏洞及潜在风险点

    五、架构调整(重构)

    • 【环境要求】将运行环境要求调整为 MySQL 5.7+ 和 PHP 7.4+,以提升系统稳定性与兼容性。
    • 【代码清理】删除V1版本的残留代码、重复代码、多余代码及弃用文件
    • 【模块移除】移除与solr相关的代码;删除与tp模式相关的废弃文件和C::tp_t()调用
    • 【数据库】删除已弃用的数据库表:folder_default、folder_event、folder_flag、folder_perm、folder_sub、thame、user_thame、attach、iconview
    • 【代码重构】重构 dfsockopen 函数的底层代码,优化网络请求连接的稳定性、超时处理机制和异常捕获逻辑,修复部分网络环境下请求失败的问题,同时简化函数调用流程,提升代码可维护性。
    • 【代码重构】为通用数据表操作基类添加注释,以提高代码的可维护性
    • 【代码重构】简化avatar_block和avatar_group函数逻辑,消除重复代码,提升头像相关功能执行效率
    • 【管理页面】修改管理员系统信息显示内容,优化管理端信息展示

    六、升级注意事项

    1. 环境检查:请确认服务器环境满足MySQL 5.7+、PHP 7.4+及以上要求,否则可能导致升级失败或系统异常。
    1. 网盘新增设置默认打开文件方式,用户可自行设置默认打开文件的应用。
    2. 系统工具新增内存优化模块,支持显示配置情况、清理内容缓存,可查看PHP扩展环境支持情况及Config设置是否开启。
    3. 系统设置新增通知设置模块,支持设置通知刷新时间间隔、通知消息的重复接收与计数。

    问题修复

    1. 修复应用中心页面加载频繁更新记录的问题。
    2. 修复因上传的空文件实际上不存在而导致的打开和下载失败问题,同时避免数据库记录重复的问题。
    3. 修复存储型XSS漏洞,增强输入过滤机制。
    4. 修复无法取消正在等待上传的文件的问题。
    5. 修复使用容器安装时端口获取不正确的问题。
    6. 修复在某些情况下上传文件夹后需要刷新才能打开的问题,现在上传完成后可直接进入文件夹,操作更加流畅。
    7. 其他已知漏洞修复,安全问题修复。

    Optimize and improve

    1. 改进系统日志、分享管理、文件管理、评论应用的数据表格的搜索框、渲染及搜索逻辑。
    2. 处理创建目录时参数缺失的情况。
    3. 处理无法实时携带sid和preview参数的缓存数据的情况。
    4. 优化站点关闭时已登录用户的页面显示。
    5. 调整验证码机制:前端限制4次尝试,后端进行单次验证并自动删除验证码以防止重复使用。
    6. 优化网盘回收站逻辑(当彻底删除设置为0天时,直接删除文件,不进入回收站)。
    7. 网盘空搜索行为优化:去除空条件限制,现在空搜索将返回所有权限内的文件。
    8. 网盘搜索逻辑优化:修复选择文件位置为机构部门时可能显示无权限个人文件的问题,修复无法搜索本级文件的问题,优化重置时的标签和位置选中交互逻辑。
    9. 完善网盘资源事件的动态数据:补充文件位置和文件链接,确保动态信息完整。
    10. 网盘UI优化与交互优化。
    11. 网络硬盘右侧的信息栏支持查看机构/部门/群组中包含的文件数量和大小属性。
    12. 将邮箱地址长度校验从32位调整为40位,与数据库字段长度保持一致,解决因长度限制导致的合法邮箱无法创建用户的问题。

    PHP版本:仅支持PHP 7.0及以上版本,请确保您的服务器环境符合要求。

    (一)新增功能

    • 网盘操作菜单新增“文件副本创建”功能选项。
    • 新增网盘群组选择成员权限控制逻辑:默认情况下,所有用户仅能选择所在部门成员或可管理的部门成员;管理员可通过设置切换为 “选择全站所有成员”。
    • 网盘目录权限设置和分享权限设置中新增评论选项(默认关闭),同时网盘的评论功能跟随评论权限生效。

    (二)功能修复

    • 修复网盘回收站模块数据加载异常问题。
    • 修复网盘收藏功能无法滚动加载数据的问题。
    • 修正网盘文件类型修改后界面元素错位的显示异常。
    • 解决网盘复制/剪切文件粘贴后仍显示粘贴按钮的问题。
    • 修复网络挂载存储空间文件粘贴功能失效问题。
    • 修复复制文件类型为链接时,复制后的文件无法跳转到链接的问题。
    • 解决网盘多选文件时类型未翻译的问题。
    • 修复网盘批量上传文件夹时,因并发创建导致的目录冗余问题。
    • 修改网盘查看机构部门与我的网盘属性时不显示大小问题。

    (三)交互与体验优化

    • 优化网盘UI与交互体验。
    • 重构网盘最近使用记录的排序算法,采用访问时间与编辑时间综合排序机制。
    • 优化移动端网盘右键菜单的触控交互设计。
    • 优化分享页面UI。
    • 分享页右键菜单移动端交互优化。
    • 网盘合并 layui.use 调用,减少模块重复初始化,优化性能。
    • 优化网盘 json.php响应速度,移除冗余代码,减少执行开销。

    DzzOffice2.3.4主要更新内容

    1. 添加网络挂载
    • 将 dzz1.0 中“我的云”功能迁移至 dzz2.0,实现云存储与云存储、云存储与云应用间通信,方便文件在云存储间灵活迁移,支持第三方应用编辑和管理云存储文件,成员可接入私有网盘、云笔记等统一管理,提升办公效率。
    1. 版本管理
      • 新增文件历史版本查看、删除、版本描述功能
      • 修复历史版本数据加载不全问题
    2. 标签管理:修复文件类型标签无法删除问题
    3. 交互优化:上传失败时显示明确错误提示
    4. UI适配:全面适配光年模板样式
    1. DzzOffice2.3.3主要更新内容

      修复

      1. 已知问题修复
        • 修复了一些已知问题,提升系统稳定性。
        • 修复了网盘移动端上传文件受损无法打开的问题。
        • 修复上传分块大小会变成 0 导致上传文件失败或受损的问题。
        • 修复光年模板加载页面时抖动问题。
        • 修复网盘应用移动端在部分浏览器中不支持加载更多文件的问题。
        • 修复部分情况下无法正常更新用户状态信息的问题。
        • 修复网盘应用移动端部分情况下目录权限不正确的问题。
        • 修复在网盘应用回收站无法恢复机构部门删除的文件的问题。
        • 修复默认模板下普通用户使用文件管理和分享管理可以查看所有数据的问题。
        • 修复网盘应用在 Linux 环境下部分语言不能翻译的问题。
        • 修复数据表格点击重置按钮后不按类型加载数据的问题,并添加了刷新按钮。
      2. PHP8 兼容性修复
        • 解决了 PHP8 环境下的多个致命问题,包括加密解密、验证码显示、新建网址、权限控制、文件缩略图生成及网盘应用功能等。

    部署前提

    在开始 Dzzoffice 部署之前,系统应该已安装 docker 和 docker-compose

    当前使用的是 Dzzoffice:2.4.1 最新版本(补丁更新到最新的2026年1月18日)

    已经安装过docker的直接跳过

    #检测是否已经安装
    docker -v

    docker

    如果能够显示版本号则已经安装。

    Centos 8.x安装步骤

    #一键安装docker容器以及docker-compose,并添加阿里云私有加速镜像
    wget -O install-docker.sh https://yun.ittel.cn:1443/f/55914227a93d4c50b3ce/?dl=1 && sh install-docker.sh 

    Ubuntu 20.x/22.x安装步骤

    #一键安装docker容器以及docker-compose,并添加阿里云私有加速镜像 
    wget -O install-docker.sh https://yun.ittel.cn:1443/f/bb8ecd197bed4521a59d/?dl=1 && sudo bash install-docker.sh

    下载最新源码以及dzzoffice镜像

    • php+nginx环境镜像我已经制作好,直接下载导入即可。
    • 当然如果有宝塔环境,dzzoffice源码下载后,在宝塔网站里启动也是可以的。
    #下载最新2.4.1源码
    #更新到最新2026年1月18日安全补丁
    wget -O dzzoffice-2.4.1.tar.gz https://yun.ittel.cn:1443/f/fc68b57c3ab34674964c/?dl=1
    
    #下载导入dzzoffice镜像,宝塔部署dzzoffice可以跳过
    # dzz 2.3.7以下版本用下面的镜像
    wget -O ittel_dzzoffice_2.02.1.tar https://yun.ittel.cn:1443/f/b8d678f5b59b45a39dc7/?dl=1 && docker load -i  ittel_dzzoffice_2.02.1.tar && rm -rvf ittel_dzzoffice_2.02.1.tar
    
    # dzz 2.4.0以上版本用下面的镜像
    wget -O ittel_dzzoffice_2.4.x.tar  https://yun.ittel.cn:1443/f/0e030882c6bf41d988b5/?dl=1 && docker load -i ittel_dzzoffice_2.4.x.tar && rm -rvf ittel_dzzoffice_2.4.x.tar

    部署 Dzzoffice

    创建挂载数据目录(后期用作备份数据使用)

    这里\opt为例,其他目录可以对应修改。

    #创建数据库和dzzoffice数据目录
    mkdir /opt/html/  /opt/mysql/
    #解压源码到dzzoffice目录
    tar -xzvf  dzzoffice-2.4.1.tar.gz  -C /opt/html && rm -rvf dzzoffice-2.4.1.tar.gz && chmod -R 777 /opt/html/

    下载并修改Docker-Compose.yml 配置:

    • 需要修改的地方都已经备注。
    • 在线编辑默认使用社区版,如需换成自定义版onlyoffice镜像,对应修改镜像名称即可。

    默认配置

    总共三个地方需要修改,都已经备注,如果不修改就默认使用以下配置

    数据库目录:/opt/mysql
    dzzoffice附件目录:/opt/html/dzzoffice-2.4.1
    dzzoffice访问端口:8800
    在线编辑端口:8889
    #下载并修改docker-compose.yml,不修改就使用默认配置。
    # dzz 2.3.7以下版本用下面的文件
    wget -O docker-compose.yml https://yun.ittel.cn:1443/f/9cf096aaea134934b968/?dl=1
    
    # dzz 2.4.0以上版本用下面的文件
    wget -O .env https://yun.ittel.cn:1443/f/a50cb0a148254c13b47b/?dl=1
    wget -O docker-compose.yml https://yun.ittel.cn:1443/f/9ae1228b77f745d6a75e/?dl=1

    启动dzzoffice服务

    如果上面docker-compose.yml 没有问题,过1分钟就可以直接访问dzzoffice了

    # 运行
    docker-compose up -d
    # 查看状态
    docker-compose ps

    配置 Dzzoffice 初始化

    浏览器访问

    # 默认登陆链接
    http://宿主机IP:8800
    # 普通用户登陆入口:
    http://宿主机IP:8800/user.php?mod=login
    # 管理员登陆入口:
    http://宿主机IP:8800/admin.php?mod=orguser

    配置MySQL 连接配置

    • 数据库服务器:mysql
    • 数据库密码:gmtools
    • 除了上面两个固定,其他都可以自定义

    集成Onlyoffice 在线预览和编辑

    应用启用

    • 管理 –> 应用市场 –> 在应用市场内找到对应应用,单击一键安装;
    • 管理 –> 应用市场 –> 已安装 中 点击启用按钮 启用此应用
    • 管理 –> 应用市场 –> 在应用市场内找到 onlyoffice 应用 点击 一键安装,安装完后,你可以通过 http://ip:8889地址来测试 onlyoffice 是否安装成功,成功后进入下一步设置;

    • 管理 –> 应用市场 –> 已安装 中 点击设置按钮 进入设置页面

    使用效果

    使用效果

    Dzzoffice 离线升级指南

    1、进入您原来的系统,关闭您的站点。进行数据备份;

    # 切换到实际安装目录
    cd  /opt/html/
    tar -czvf dzzoffice-2.3.5.tar.gz --exclude='data' dzzoffice-2.3.5/

    2、下载并解压缩最新版的程序包;

    # 下载需要更新的版本
    # 2.3.7 (2025年8月30日发布)
    wget -O dzzoffice-2.3.7.tar.gz  https://yun.ittel.cn:1443/f/53075aa9a4da4daa9a09/?dl=1
    # 2.4.1 (2026年1月18日发布)
    wget -O dzzoffice-2.4.1.tar.gz https://yun.ittel.cn:1443/f/fc68b57c3ab34674964c/?dl=1

    3、程序包解压并覆盖原网站根目录;

    # dzzoffice-2.3.7.tar.gz替换成实际更新包
    tar -xzvf dzzoffice-2.3.7.tar.gz
    # 覆盖
    cp -rvf dzzoffice-2.3.7/* dzzoffice-2.3.5/
    

    4、访问 http://您的域名/install/update.php

    按照程序提示,直至所有升级完毕。删除install/update.php 程序,以免被恶意利用。

    5、管理员登录后,系统工具 -> 更新系统缓存。

    6、系统设置 -> 打开站点。

    Dzzoffice 数据备份恢复指南

    备份

    备份整个数据库目录以及dzzoffice网站目录,默认在主机的

    • 数据库目录:/opt/mysql
    • 附件目录:/opt/html/dzzoffice-2.02.1

    附件目录可以定期备份,但是数据库目录因为实时读写的,所以无法直接备份文件,可以通过dzzoffice定期任务进行数据库备份。

    备份sql文件会在【附件目录/data/】下

    恢复

    数据库恢复

    如果出现上述提示,请修改附件目录下的config/config.php, 如下图所示:

    #改成1即可,0是防止误点击,导致数据还原。
    $_config['admincp']['dbimport']	= 1;
    

    当然,我觉得各位大佬们还是喜欢用mysql工具进行备份还原,比如navcat dbForge等。

    文件恢复

    DzzOffice 文件默认存储在 网站根目录 /data/attachment/dzz 下,这里推荐整个附件目录,以免漏备份。

    • 默认附件目录:主机的/opt/html/dzzoffice-2.02.1

    如果添加了存储位置(本地磁盘 oss 等)也会存储在这些位置上

    更多:

    Dzzoffice 官方+第三方插件汇总下载地址

    onlyoffice 9.4.0 社区版定制版下载

    需要安装支持,支持可以底部联系我

    1、本站提供的软件均为 “试用版” 或者 “免费版”,仅供学习和研究使用
    2、友情提醒:内容全部搜集自网络,安装教程参照压缩包内的Readme.txt编写
    3、因使用本站软件产生的法律责任由使用者自行承担,本站不承担任何连带责任。
    4、如有内容不慎侵犯了您的权益,请速与我联系!
    如有转载请注明出处:https://www.ittel.cn/archives/27697.html
    guest
    10 评论
    内联反馈
    查看所有评论
    weihx1992
    weihx1992
    3 月 前

    这个镜像是否支持arm系统

    达文
    达文
    1 年 前

    插件包里面怎么没有cad插件了

    yty
    yty
    1 年 前

    请问onlyoffice插件的设置页面,也就是mod=onlyoffice&op=admin打不开,是什么原因呢,有没有别的方法去配置那两个地址,比如改php文件改数据库之类的

    yty
    yty
    1 年 前
    回复给  无欢不爱

    肯定是安装了的,商店一键安装按钮会显示安装或更新文件丢失,所以下载了离线安装包,解压进dzz文件夹,导入xml也成功了,商店里显示已安装,我是在已安装列表中点了onlyoffice的设置按钮,弹出来了index.php?mod=onlyoffice&op=admin页面是空白页面,onlyoffice的编辑页面就能正常打开。

    yty
    yty
    1 年 前
    回复给  无欢不爱

    我是用docker compose装的,都清掉重装了四五次了,也没有装其他可能冲突的插件。之前在另一套环境里装成功过,当时很顺利,这次居然卡在设置页面打不开上,怀疑人生中😂

    联系我们

    联系我们

    QQ:877196754

    在线咨询: QQ交谈

    邮箱: ittel@qq.com

    工作时间:周一至周日,8:00-21:00
    返回顶部
    10
    0
    希望看到您的想法,请您发表评论x