# Server SDK

> Подготовка сервисов документов, хранилища и прав доступа для приложения.

- Human documentation: [https://docs.univer.ai/ru-RU/server](https://docs.univer.ai/ru-RU/server)

- Agent Markdown: [https://docs.univer.ai/ru-RU/server.md](https://docs.univer.ai/ru-RU/server.md)

- Requested language: `ru-RU`

- Content language: `ru-RU`

- Documentation version: `1.2.0`

- Source: [index.ru-RU.mdx](https://github.com/dream-num/documentation/blob/dev/content/server/index.ru-RU.mdx)

---

**Univer Server SDK предоставляет набор комбинируемых модулей.** Подключите нужные модули к своему backend и разверните приложение. Аутентификация, права, принадлежность документов, хранение файлов и эксплуатация остаются ответственностью приложения.

Эта страница описывает настройку сервера, хранилища и прав. [Интеграция совместного редактирования](https://docs.univer.ai/ru-RU/server/collaboration/browser-integration.md) подключает редактор к общим документам. [Интеграция обмена файлами](https://docs.univer.ai/ru-RU/server/import-export.md) охватывает загрузку, преобразование и скачивание. Выберите руководство нужной функции. Для лицензируемых функций начните с [настройки лицензии](https://docs.univer.ai/ru-RU/server/license.md). Редактирование только в браузере не требует сервиса совместной работы.

## Последовательность интеграции

1. [Quick Start](https://docs.univer.ai/ru-RU/server/collaboration/quick-start.md): проверить двустороннее редактирование в двух независимых браузерных контекстах.
2. [Постоянное хранение](https://docs.univer.ai/ru-RU/server/collaboration/database-adapters.md#verify-persistence): перезапустить SQLite и проверить значение.
3. [Идентификация и права](https://docs.univer.ai/ru-RU/server/collaboration/identity-and-authorization.md#verify-permissions): проверить editor и viewer.
4. [Frontend приложения](https://docs.univer.ai/ru-RU/server/collaboration/browser-integration.md): заменить демонстрационную идентификацию, создание документов и URL.
5. [Расширения](https://docs.univer.ai/ru-RU/server/collaboration/examples.md): после базового сценария добавить историю, комментарии, Worktree или Exchange. Для одной конвертации начать с [Exchange](https://docs.univer.ai/ru-RU/server/import-export/node.md).

## Выбор сервисов

| Потребность                     | Подготовка сервера                                 | Руководство                                                                                                      |
| ------------------------------- | -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Редактирование общих документов | Collaboration SDK, хранение документов и права     | [Быстрый старт совместного редактирования](https://docs.univer.ai/ru-RU/server/collaboration/quick-start.md)                                    |
| Импорт и экспорт файлов Office  | Преобразование, загрузки, опрос задач и скачивание | [Преобразование файлов](https://docs.univer.ai/ru-RU/server/import-export/node.md) и [пример Exchange](https://docs.univer.ai/ru-RU/server/collaboration/examples.md#exchange) |
| История или общие комментарии   | Соответствующие сервисы, хранение и права          | [Модули расширений](https://docs.univer.ai/ru-RU/server/collaboration/extensions.md)                                                            |

Выбирайте только нужные возможности. Преобразование файлов само по себе не требует совместного редактирования. Подготовьте [среду SDK](https://docs.univer.ai/ru-RU/server/requirements.md) и обеспечьте совместимость версий пакетов Univer.

## Подключение приложения и хранилища

Запустите пример выбранного сервиса и подключите его к своему серверу. Для совместных документов приложение создаёт документ, записывает владельца и возвращает ID браузеру. API создания описаны в разделе [Границы модулей](https://docs.univer.ai/ru-RU/server/collaboration/modules.md). Приложение продолжает управлять пользователями, проектами и папками.

Пример совместного редактирования использует память и теряет данные при перезапуске. Подключите базу данных по разделу [Адаптеры баз данных](https://docs.univer.ai/ru-RU/server/collaboration/database-adapters.md) и проверьте сохранность документов после перезапуска.

Преобразование файлов также требует хранения и очистки загрузок, задач и скачиваемых результатов. Следуйте [примеру Exchange](https://docs.univer.ai/ru-RU/server/collaboration/examples.md#exchange).

## Подключение входа и прав доступа

Следуйте разделу [Идентификация и авторизация](https://docs.univer.ai/ru-RU/server/collaboration/identity-and-authorization.md), чтобы проверять существующие учётные данные и право пользователя читать или изменять документ. Замените фиксированных пользователей и разрешающие всё правила примера.

Защитите чтение документов, подключения совместного редактирования, отправку изменений и включённые функции истории, комментариев и скачивания. Режим только для чтения в браузере не заменяет проверки прав на сервере.

## Развёртывание и подключение клиента

Разместите интерфейсы на домене приложения. Для совместного редактирования прокси должны передавать HTTP и WebSocket; HTTPS-страницы должны использовать WSS. Ограничьте загрузку файлов, обрабатывайте ошибки и тайм-ауты преобразования. Чтобы перейти от одной машины к отдельному узлу импорта и экспорта и к нескольким узлам совместного редактирования, следуйте [Руководству по развертыванию](https://docs.univer.ai/ru-RU/server/deployment.md).

После подготовки сервера завершите нужную интеграцию:

* [Совместное редактирование](https://docs.univer.ai/ru-RU/server/collaboration/browser-integration.md): подключение редактора, создание и открытие общих документов, проверка синхронизации.
* [Обмен файлами](https://docs.univer.ai/ru-RU/server/import-export.md): подключение загрузки, преобразования и скачивания с проверкой на реальных файлах.