应通过CDN托管字体、提升并发限制、精简字体依赖、启用Nginx缓存及禁用非必要模块五步优化OnlyOffice性能：一、将fonts目录部署至CDN并修改local.json配置；二、调高concurrency值与Nginx worker_connections；三、保留高频字体并重启转换服务；四、配置Nginx proxy_cache缓存静态资源；五、在default.json中禁用spellchecker等冗余服务。
如果您在使用OnlyOffice Document Server时发现编辑器加载缓慢、字体渲染卡顿或多人协作响应迟滞，则很可能是由于静态资源加载阻塞、服务端并发限制或字体解析开销过大所致。以下是提升OnlyOffice服务器性能的具体操作步骤：
一、将fonts目录托管至CDN加速
OnlyOffice 8.0.0-99版本默认从Document Server本地加载/fonts/路径下的全部字体文件，单次请求可能达数十MB，极易因带宽不足或网络延迟导致页面长时间白屏。通过将fonts目录剥离源站并部署至CDN，可显著降低源站负载并提升全球用户字体获取速度。
1、在CDN服务商（如Cloudflare R2、阿里云OSS+CDN、腾讯云COS+CDN）中创建存储桶，并上传完整fonts目录（含所有.ttf/.otf及转换后专有格式文件）。
2、修改Document Server配置文件/etc/onlyoffice/documentserver/local.json，定位到“services.CoAuthoring.server.fonts”节点，将"value"字段值替换为CDN域名路径，例如"https://cdn.yourdomain.com/fonts/"。
3、执行sudo supervisorctl restart all重启服务，确保配置生效。
4、在浏览器开发者工具Network面板中刷新编辑器页面，验证所有/fonts/请求是否返回CDN域名且状态码为200，Waterfall中Stalled与Download时间应明显缩短。
二、解除默认并发连接数限制
官方Docker镜像默认仅允许20个并发文档会话，当多用户同时打开或编辑文档时，新连接将排队等待甚至被拒绝，直接表现为“正在连接…”长时间不响应。提升该阈值是释放协作性能的关键一步。
1、进入运行中的OnlyOffice容器：docker exec -it onlyoffice bash。
2、使用nano编辑器打开主配置文件：nano /etc/onlyoffice/documentserver/default.json。
3、搜索字符串"concurrency"，定位到"services.CoAuthoring.server.limits.concurrency"字段，将其数值由20修改为200（建议按团队人数×2设定，上限不超过宿主机CPU核心数×50）。
4、同步调整Nginx工作连接数，在/etc/nginx/nginx.conf的events区块内，将worker_connections值设为4096。
5、重启Nginx与supervisor服务：sudo nginx -s reload && sudo supervisorctl restart all。
三、精简首次加载字体依赖
OnlyOffice在初始化时会预加载全部注册字体，但实际文档通常仅用到其中3–5种。若未做干预，中文字体（单个5–20MB）叠加加载将严重拖慢首屏时间。通过构建最小化字体依赖列表，可将初始字体下载量压缩80%以上。
1、分析高频使用字体：检查历史文档CSS中出现频次最高的font-family值，例如"SimSun, Microsoft YaHei, Noto Sans CJK SC, Liberation Sans"。
2、进入服务器fonts目录：cd /app/onlyoffice/DocumentServer/fonts/。
构建并调试跨Office自动化流程，实现Word、Excel、PowerPoint之间的内容迁移，使用Open XML、VBA、python-docx、openpyxl、py...
3、保留上述字体对应文件（含其WASM专用格式如000、001等编号文件），其余全部移出该目录并备份至其他位置。
4、执行sudo supervisorctl restart ds:converter重启转换服务，使字体索引重新生成。
5、验证效果：在编辑器中新建空白文档，打开Network面板过滤/fonts/，确认请求数量由原先的30+下降至不超过5个。
四、启用Nginx反向代理缓存加速
Nginx作为Document Server前端代理，可在不修改应用代码的前提下，对静态资源（如SDK JS、图标、CSS）实施边缘缓存，避免重复回源，大幅降低后端压力与用户等待时间。
1、编辑Nginx站点配置文件，通常位于/etc/nginx/conf.d/onlyoffice.conf。
2、在location /块内添加缓存指令：proxy_cache_valid 200 302 10m; proxy_cache_valid 404 1m; proxy_cache_min_uses 1; proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;
3、在http区块顶部定义缓存区：proxy_cache_path /var/cache/nginx/onlyoffice levels=1:2 keys_zone=onlyoffice:100m max_size=1g inactive=60m use_temp_path=off;
4、确保location /static/或location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff2)$等静态路径已显式启用proxy_cache onlyoffice;指令。
5、重载Nginx配置：sudo nginx -t && sudo nginx -s reload。
五、禁用非必要服务模块
Document Server默认启用拼写检查（spellchecker）、文档转换（converter）、协作服务（coauthoring）等多个子模块。对于仅需基础编辑功能的场景，关闭冗余模块可减少内存占用与CPU争用，尤其适用于低配服务器（≤2核CPU/4GB内存）。
1、编辑/etc/onlyoffice/documentserver/default.json，找到"services"对象。
2、将"spellchecker"节点的"enable"字段设为false；若无需PDF转Word或PPTX转PDF等功能，将"converter"节点下"enable"也设为false。
3、保存后执行sudo supervisorctl stop ds:spellchecker ds:converter停用对应进程。
4、观察top命令输出，确认onlyoffice-spellchecker与onlyoffice-converter进程不再运行，系统空闲内存提升至少300MB。
