Page History

...

Официальные дистрибутивы ONLYOFFICE Docs Community для различных операционных систем, а также руководства по их установке доступны в [официальной документации ONLYOFFICE|https://www.onlyoffice.com/ru/download-community?ysclid=mraefple9q580120155(https://www.onlyoffice.com/ru/download-community?ysclid=mraefple9q580120155^{Image Removed})].

После успешного развертывания ONLYOFFICE Docs на отдельном сервере можно переходить к пошаговой настройке интеграции с Vitro-CAD.

...

Для работы редактора должны выполняться 4 сетевых соединения:

• DocumentServerUrl — сетевой адрес сервера ONLYOFFICE Docs. Должен быть доступен из браузеров пользователей и с сервера Vitro-CAD.
• PortalPublicUrl — сетевой адрес сервера Vitro-CAD. Должен быть доступен с сервера ONLYOFFICE Docs.

...

1. Выберите адреса подключения:
   1. DocumentServerUrl (например, https://docs.example.ru/(https://www.google.com/search?q=https://docs.example.ru/Image Removed)) — —  сетевой адрес сервера ONLYOFFICE Docs, доступный с рабочих мест и с сервера Vitro-CAD.
   2. PortalPublicUrl (например, https://vitro.example.ru/(https://www.google.com/search?q=https://vitro.example.ru/Image Removed)) —  —  сетевой адрес Vitro-CAD, доступный с сервера ONLYOFFICE Docs.
      
      
2. Проверьте доступность адресов и портов между серверами:
   1. Windows (PowerShell):
      

      Code Block
      language powershell
      Test-NetConnection docs.example.ru -Port 443 Test-NetConnection vitro.example.ru -Port 443

   2. Linux (Bash):
      

      Code Block
      language bash
      curl -I [https://docs.example.ru/healthcheck](https://www.google.com/search?q=https://docs.example.ru/healthcheck) curl -I [https://vitro.example.ru/](https://www.google.com/search?q=https://vitro.example.ru/)

      
      

...

1. Создайте или отредактируйте файл onlyoffice.json на сервере Vitro-CAD:
   1. Windows: C:\Program Files\Vitro Software\Vitro\Server\Conf\onlyoffice.json
   2. Linux: /etc/Vitro/Server/Conf/onlyoffice.json

2. Укажите параметры конфигурации:
   

   Code Block
   { "DocumentServerUrl": "[https://docs.example.ru/](https://www.google.com/search?q=https://docs.example.ru/)", "PortalPublicUrl": "[https://vitro.example.ru/](https://www.google.com/search?q=https://vitro.example.ru/)", "JwtSecret": "<JWT_SECRET>", "SessionLookupDays": 7 }

Параметры конфигурации:

...

1. • Windows (PowerShell):

     Code Block
     powershell powershell
     $bytes = New-Object byte[] 32$generator32 $generator = [System.Security.Cryptography.RandomNumberGenerator]::Create() $generator.GetBytes($bytes) [Convert]::ToBase64String($bytes) $generator.Dispose()

   • Linux:

     Code Block
     bash bash
     openssl rand -base64 32

2. Укажите полученное значение в параметре JwtSecret файла onlyoffice.json.
3. Откройте файл local.json на сервере ONLYOFFICE Docs:
   1. Windows: C:\Program Files\ONLYOFFICE\DocumentServer\config\local.json
   2. Linux: /etc/onlyoffice/documentserver/local.json
4. Включите проверку JWT и укажите тот же секрет (добавьте в файл local.json):
   

   Code Block
   { "services": { "CoAuthoring": { "token": { "enable": { "browser": true, "request": { "inbox": true, "outbox": true } } }, "secret": { "inbox": { "string": "<JWT_SECRET>" }, "outbox": { "string": "<JWT_SECRET>" }, "session": { "string": "<JWT_SECRET>" } } } } }

...

Если PortalPublicUrl содержит частный IP-адрес, ONLYOFFICE Docs может заблокировать загрузку файла и callback. В этом случае добавьте в local.json на сервере ONLYOFFICE Docs:

 {
  "services": {
    "CoAuthoring": {
      "request-filtering-agent": {
        "allowPrivateIPAddress": true,
        "allowMetaIPAddress": false
      }
    }
  }
}

...

6. HTTPS и сертификаты

Для производственной установки следует использовать доверенные сертификаты и HTTPS для Vitro-CAD и ONLYOFFICE Docs.

...

1. Браузеры пользователей доверяют сертификату DocumentServerUrl.
2. Сервер ONLYOFFICE Docs доверяет сертификату PortalPublicUrl.

...

1. .

...

...

7. Перезапуск служб

После изменения local.json на сервере ONLYOFFICE Docs и onlyoffice.json на сервере Vitro-CAD перезапустите службы.

...

1. В Vitro-CAD откройте файл docx, xlsx или pptx.
2. Убедитесь, что файл открылся в новой вкладке ONLYOFFICE.
3. Внесите изменение и нажмите кнопку сохранения.
4. Закройте вкладку редактора.
5. Проверьте появление новой версии файла в Vitro-CAD.

При нажатии кнопки сохранения ONLYOFFICE выполняет ForceSave и отправляет callback со статусом 6. После закрытия измененного документа отправляется финальный callback со статусом 2.

...

9. Права пользователей

Vitro-CAD передает в ONLYOFFICE идентификатор и имя пользователя текущей сессии.

...

10. Диагностика и устранение неполадок

Журналы (логи) ONLYOFFICE Docs:

• Windows: C:\Program Files\ONLYOFFICE\DocumentServer\Log\docservice, ...\converter
• Linux: /var/log/onlyoffice/documentserver/docservice/, ...\converter

11. Текущие ограничения

• История изменений и changes.zip не сохраняются отдельно в Vitro-CAD и не отображаются в интерфейсе истории ONLYOFFICE.
• Сравнение версий средствами ONLYOFFICE не подключено.
• Редактируется только актуальная версия; исторические версии открываются только для просмотра.
• После ForceSave финальный callback со статусом 2 может создать дополнительную версию с тем же содержимым.