如何为OnlyOffice服务器配置自定义URL前缀实现内部重定向？

要让OnlyOffice内部重定向URL带上自定义前缀，不能通过前端editorConfig的customUrlPrefix参数配置，必须修改OnlyOffice服务器端的配置文件，具体步骤如下：

1. 定位服务器配置文件 #

根据你的部署方式找到对应的配置文件：

• Docker部署：找到你挂载的local.json文件，通常路径为/app/onlyoffice/DocumentServer/config/local.json（具体路径取决于你挂载的目录）
• 手动安装（Linux）：路径为/etc/onlyoffice/documentserver/local.json
• 手动安装（Windows）：路径为%ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json

2. 修改URL前缀配置 #

打开local.json，找到services.CoAuthoring节点，修改以下两个URL配置项，添加你的自定义前缀：

{
  "services": {
    "CoAuthoring": {
      "api": {
        "url": "http://domain:port/customPrefix/"
      },
      "client": {
        "url": "http://domain:port/customPrefix/"
      }
    }
  }
}

替换customPrefix为你需要的前缀名称，确保两个URL的前缀保持一致。

3. 重启OnlyOffice服务 #

修改完配置后必须重启服务才能生效：

• Docker部署：执行命令 docker restart onlyoffice-documentserver
• Linux手动安装：执行命令 systemctl restart onlyoffice-documentserver
• Windows手动安装：打开服务管理器，找到ONLYOFFICE DocumentServer服务并重启

说明 #

前端的customUrlPrefix参数仅用于指定前端页面加载编辑器静态资源的路径，无法控制服务器内部的重定向逻辑，所以之前的配置不会生效，必须通过修改服务器端的local.json来实现URL前缀的自定义。

内容的提问来源于stack exchange，提问作者Hason SANG