OnlyOffice 9.0.4 前端定制记录：去除匿名命名弹窗、隐藏插件菜单、关闭页眉 Logo 链接

前言

本文记录在 OnlyOffice DocumentServer Web 前端侧的定制修改，适用于 9.0.4 版本。修改基于统一 SDK api.js，对所有编辑器生效（文档/表格/演示/PDF/Visio）。

一、修改目标

关闭“输入用于协作的名称”匿名命名弹窗
隐藏“插件”功能区选项卡，并禁用插件能力
隐藏页眉左上角的 OnlyOffice Logo（去除跳转链接）

二、变更文件与位置

生产服务真实使用目录（按你的安装方式选择其一）：
Docker: /var/www/onlyoffice/documentserver/web-apps/apps/api/documents/api.js
Linux 安装版: 同上路径
Windows 安装版: C:\Program Files\ONLYOFFICE\DocumentServer\web-apps\apps\api\documents\api.js

模板文件（务必同步）：api.js.tpl
压缩文件（务必处理）：api.js.gz（可能还有 api.js.br）
说明：OnlyOffice 实际加载的资源通常带有版本哈希前缀，例如 /9.0.4-xxxx/web-apps/.../api.js。重启/升级后该目录可能再生成，因此建议同时改模板并处理压缩文件，或在业务集成处直接传参覆盖（见文末“更稳妥做法”）。

三、代码改动点（统一 SDK 默认配置）

修改 DocsAPI.DocEditor.defaultConfig.editorConfig.customization：

// 关闭匿名命名弹窗
anonymous: {
    request: false
},

// 隐藏插件选项卡
layout: {
    toolbar: {
        plugins: false
    }
},

// 完全禁用插件能力
plugins: false,

// 隐藏页眉 Logo（无渲染自然无链接）
logo: {
    visible: false
}

以上片段出现在：
apps/api/documents/api.js 内 DocsAPI.DocEditor.defaultConfig 对象中
同步到 apps/api/documents/api.js.tpl，避免重启后被模板覆盖

四、同步到服务端并处理压缩文件

/web-apps/apps/api/documents/api.js?_ts=1690000000000 ## 五、验证步骤 1) 打开浏览器开发者工具 Network，搜索 api.js，确认实际请求路径（可能是带版本号的路径）。 2) 点开响应，搜索关键字： anonymous 且包含 ```text request: false layout.toolbar.plugins = false customization.plugins = false logo.visible = false ``` 3) 打开任一文档：不再出现“输入用于协作的名称”弹窗顶部“插件”选项卡消失页眉左上角 Logo 不显示（无链接） ## 六、常见问题与排查 ### 修改后又“恢复默认”：可能只改了非模板文件，重启后由 api.js.tpl 重新生成可能改了非版本目录；服务端实际使用的是带版本目录 ### 浏览器仍旧显示老配置：优先返回 .gz/.br，未处理压缩文件导致浏览器/代理/CDN 缓存未清 ### 个别页面仍有“插件”按钮或弹窗：该页面在 new DocsAPI.DocEditor(..., config) 显式传参覆盖了默认值

OnlyOffice 9.0.4 前端定制记录：去除匿名命名弹窗、隐藏插件菜单、关闭页眉 Logo 链接

前言

一、修改目标

二、变更文件与位置

三、代码改动点（统一 SDK 默认配置）

四、同步到服务端并处理压缩文件

评论 (0)