OnlyOffice怎么清理缓存_解决OnlyOffice加载缓慢
遇到OnlyOffice文档加载慢、界面响应卡顿，或者字体样式显示不正常？别急着怀疑是服务器性能问题，很多时候，问题的根源其实在于“缓存”。无论是前端构建残留、Docker容器内的临时文件堆积，还是浏览器或云同步的缓存机制“卡壳”，都可能导致这类性能下降和显示异常。下面，我们就来系统地梳理一下，如何
遇到OnlyOffice文档加载慢、界面响应卡顿，或者字体样式显示不正常？别急着怀疑是服务器性能问题，很多时候，问题的根源其实在于“缓存”。无论是前端构建残留、Docker容器内的临时文件堆积，还是浏览器或云同步的缓存机制“卡壳”，都可能导致这类性能下降和显示异常。下面，我们就来系统地梳理一下，如何从五个层面彻底清理OnlyOffice的缓存。
一、清理前端构建缓存
首先得从源头看起。OnlyOffice Docs的前端资源（比如Ja vaScript、CSS文件）在构建过程中会产生缓存。如果这些缓存文件长期没有更新，浏览器加载到的可能就是过时的旧版本，结果就是页面渲染慢，甚至功能出错。清理它们，相当于强制系统重新生成一份最新的静态资源。
操作起来也不复杂：
1. 进入你的OnlyOffice Docs项目根目录，运行内置的更新脚本：
bash mr-update.sh
2. 如果脚本不可用，那就手动“打扫”几个关键目录：
rm -rf node_modules/ ~/.npm/_cacache/ dist/ build/
3. 最后，重新安装依赖并构建项目：
npm install && npm run build
二、清空 Docker 容器内运行时缓存
对于Docker部署的用户，容器内部同样是个缓存“重灾区”。OnlyOffice在运行时会向/var/tmp、/var/www/cache这样的路径持续写入临时文件和文档渲染缓存。日积月累，这些文件不仅占用空间，还会严重拖慢你首次打开文档的速度。
清理步骤需要按顺序来：
1. 先停下正在运行的容器：
docker stop onlyoffice
2. 然后进入容器内部，执行清理命令：
docker exec -it onlyoffice /bin/bash -c "rm -rf /var/tmp/* /var/www/cache/*"
3. 退出容器，再重新启动服务：
docker start onlyoffice
三、重置系统级缓存策略
OnlyOffice本身有一套基于LRU（最近最少使用）和文件修改时间的缓存淘汰机制。但问题是，如果系统没有配置自动清理任务，那些本该被淘汰的过期缓存文件就会一直赖着不走。所以，我们得主动干预，或者把定时清理的“闹钟”给补上。
可以这么做：
1. 直接手动删除所有缓存文件（放心，你的原始文档数据是安全的）：
rm -rf /var/www/cache/*
2. 更一劳永逸的方法是设置一个定时任务。比如，让系统每天凌晨2点自动清理7天前的缓存：
echo "0 2 * * * find /var/www/cache -type f -mtime +7 -delete" | crontab -
3. 设置完后，别忘了验证一下任务是否成功添加：
crontab -l
四、清除浏览器端缓存与 Service Worker
别忘了，问题也可能出在你自己的电脑上。浏览器会缓存OnlyOffice的各类资源，而更“顽固”的Service Worker甚至可能拦截网络请求，直接返回旧的缓存内容，导致界面卡顿或功能错乱。
彻底清理浏览器缓存的方法如下：
1. 打开浏览器，在地址栏输入：about:blank，然后按下快捷键（Windows是Ctrl+Shift+Delete，macOS是Cmd+Shift+Delete）打开清除数据对话框。
2. 在弹窗中，务必勾选上“缓存的图像和文件”、“Cookie及其他网站数据”以及“Service Worker”这三项。
3. 将时间范围设置为“所有时间”，然后点击“清除数据”。
4. 完成之后，关闭所有与OnlyOffice相关的浏览器标签页，重启浏览器再重新访问。
五、清理 Office 文档同步缓存
最后这个场景比较特定，但也很关键。当你把OnlyOffice与OneDrive、Nextcloud这类云存储集成使用时，本地会生成用于同步的临时缓存。一旦这个缓存损坏，就可能阻塞文档元数据的读取和版本对比，直接导致文档加载“转圈圈”。
解决方法主要针对Windows环境下的集成场景：
1. 首先，确保当前操作账户拥有管理员权限。为了排除干扰，建议先执行一次“干净启动”，暂时禁用所有非Microsoft的启动项。
2. 接下来，定位并删除Office文档的本地缓存目录：
%localappdata%\Microsoft\Office\16.0\WEF\
3. 光清理本地还不够，最好也同步重置一下云端链接。在OneDrive客户端中，右键点击任务栏图标，进入“设置” -> “账户”，选择“取消链接此电脑”，然后重新登录账户进行关联。
按照以上五个步骤逐一排查和清理，绝大多数由缓存引起的OnlyOffice性能问题都能得到有效解决。记住，定期维护这些缓存机制，能让你的协作编辑体验始终保持流畅。
正软商城本月促销专区，汇集办公、设计、安全、影音、系统工具及AI软件等正版软件优惠活动，提供限时折扣、特价授权和优惠购买信息，活动库存及价格以页面实时展示为准。
正软商城装机必备专区，精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件，帮助用户快速完成新电脑软件配置。
正软商城Windows软件专区，汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件，提供软件介绍、系统要求、正版授权及购买下载服务。
正软商城macOS软件专区，精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具，提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。
正软商城iOS软件专区，精选适用于iPhone和iPad的办公、学习、影音、设计、效率及AI应用，提供功能介绍、适用设备、系统要求和正版获取方式等信息。
正软商城AI软件专区，汇集AI写作、AI绘画、AI视频、AI办公、AI编程、AI翻译、智能客服和数据分析等人工智能工具，提供功能介绍、适用平台、收费方式及正版购买信息。
正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法，同时介绍常用PDF软件和工具的使用技巧。
赤友清理大师是一款为 Mac 设计的智能清理优化工具，可精准扫描垃圾、大文件、重复文件等，释放磁盘空间。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
