本文详细介绍了在OnlyOffice中自定义Logo的四种实用方法，涵盖企业版后台配置、Docker容器文件替换、Linux本地CSS注入以及前端JavaScript动态修改，帮助用户根据部署环境和权限灵活实现品牌标识替换。
当您希望在OnlyOffice中将系统默认的左上角Logo更换为企业专属品牌标识时，可能会遇到管理后台缺乏上传选项或设置无效的情况。这通常与当前使用的版本权限限制或资源路径未正确加载有关。为应对不同部署场景，以下提供多种有效解决方案。
一、企业版与开发者版：图形化品牌定制功能
对于拥有企业版或开发者版授权的用户，系统内置了完整的品牌个性化管理界面，支持通过可视化操作上传多规格Logo，并自动同步至编辑器、登录页及通知邮件等位置，全程无需手动修改代码或文件。
1. 登录OnlyOffice协作空间的管理控制台，依次进入“个性化定制” → “品牌设置”模块。
2. 在“协作空间Logo（422×48像素）”区域点击“选择文件”，上传符合尺寸标准的PNG或SVG格式图片。
3. 继续上传“紧凑侧边栏Logo（56×56像素）”和“登录页Logo（810×92像素）”对应的图像资源。
4. 在“品牌名称”输入框中填写您的企业全称，该名称将自动应用于邮件通知、邀请链接及界面文案中。
5. 启用“从文本生成Logo”功能后，输入指定文字并点击“生成”按钮，系统将智能创建适配不同场景的矢量风格标识。
6. 完成所有设置后，滚动至页面底部并点击保存按钮，新品牌配置将立即生效。
二、Docker部署：容器内文件直接替换方案
若您通过Docker方式部署OnlyOffice文档服务，可通过直接替换容器内部静态资源文件的方式实现Logo更新。此方法需确保文件名与路径完全匹配，避免因资源引用错误导致图标无法显示。
1. 提前准备好符合要求的新Logo文件，主界面Logo命名为header-logo_s.svg，登录页Logo命名为logo.png。
2. 在终端执行 docker ps 查看当前运行的OnlyOffice容器名称（例如：onlyoffice_documentserver）。
3. 使用以下命令将主Logo文件复制到容器指定目录：
docker cp header-logo_s.svg onlyoffice_documentserver:/usr/share/onlyoffice/documentserver/web-apps/apps/documenteditor/main/resources/img/header/header-logo_s.svg
4. 执行另一条命令替换登录页Logo：
docker cp logo.png onlyoffice_documentserver:/usr/share/onlyoffice/documentserver/DocumentServer/DocService/public/logo.png
5. 最后运行 docker restart onlyoffice_documentserver 重启容器，强制刷新所有静态资源缓存。
三、Linux本地部署：CSS样式覆盖法
针对社区版或无法直接修改服务端文件的场景，可通过注入自定义CSS样式来覆盖默认Logo显示。该方法无需改动原始程序文件，具备良好的兼容性与安全性。
1. 新建一个名为 custom-logo.css 的样式文件，写入如下规则：
.logo-header { background-image: url("/custom/logo.svg") !important; }
.login-logo { background-image: url("/custom/login-logo.png") !important; }
2. 将此CSS文件放置于Web服务器静态资源目录（如 /var/www/html/custom/），确保可通过URL直接访问。
3. 打开OnlyOffice前端入口文件 /var/www/onlyoffice/documentserver/web-apps/apps/documenteditor/main/index.html，在 </head> 标签前加入：
<link rel="stylesheet" href="/custom/custom-logo.css" rel="external nofollow" >
4. 执行 sudo systemctl restart onlyoffice-documentserver 重启服务。
5. 清除浏览器缓存并强制刷新页面（Ctrl+F5），检查左上角及登录页Logo是否已成功切换。
四、社区版临时方案：前端JavaScript动态替换
在权限受限或仅需临时展示自定义Logo的情况下，可通过浏览器控制台执行JavaScript代码，实时修改页面中Logo元素的资源路径。此方式仅影响当前会话，适合快速验证效果。
1. 打开OnlyOffice文档编辑器，按下F12键打开开发者工具，切换到“控制台（Console）”标签页。
2. 输入以下代码替换主界面Logo：
document.querySelector(".logo-header img").src = "https://your-domain.com/logo.svg";
3. 输入以下代码更新登录页Logo：
document.querySelector(".login-logo img").src = "https://your-domain.com/login-logo.png";
4. 若希望每次访问自动生效，可将上述脚本封装为浏览器扩展的内容脚本，并设置匹配规则为 *://*/ds-vpath/*。
5. 在“元素（Elements）”面板中确认 .logo-header 和 .login-logo 节点的 src 或 style 属性已指向新的Logo地址。
