Установка и настройка KadrSync

Как устроен KadrSync

Сервис состоит из трёх компонентов:

• Облако KadrSync — управляемое хранилище, которое принимает зашифрованные блоки, проверяет их целостность и реплицирует в три зоны. Для тарифа «Бизнес» вместо облака может использоваться выделенный узел на инфраструктуре клиента.
• Приложения — для iOS, Android, Windows, macOS и Linux. Выполняют шифрование, разбиение на блоки и дельта-синхронизацию.
• Личный кабинет — app.kadrsync.space: управление подпиской, устройствами, участниками семейного или корпоративного тарифа. Доступа к содержимому файлов не имеет.

Связывание мобильного приложения по токену

Новое устройство подключается к аккаунту с помощью одноразового токена связывания. Токен действует 10 минут, используется только один раз и не даёт доступа к ключам шифрования — они передаются отдельно, напрямую между вашими устройствами.

1. 1

   На уже подключённом устройстве или в личном кабинете откройте Настройки → Устройства → Добавить устройство. Будет показан QR-код и токен вида KSP-7QX4-M2RD-91HF.

2. 2

   Установите приложение KadrSync на телефон, нажмите «Войти по токену» и отсканируйте QR-код либо введите токен вручную. Клиенты тарифа «Бизнес» с выделенным узлом дополнительно указывают его адрес.

3. 3

   Сверьте шестизначный код безопасности на обоих экранах. Совпадение кодов подтверждает, что обмен ключами X25519 прошёл без посредника.

4. 4

   Выберите альбомы для резервного копирования и условия загрузки (только Wi-Fi, только при зарядке). Первичная синхронизация начнётся в фоне.

Под капотом приложение обменивает токен связывания на сессионный маркер устройства:

POST /v1/devices/pair HTTP/1.1
Host: api.kadrsync.space
Content-Type: application/json

{
  "pairing_token": "KSP-7QX4-M2RD-91HF",
  "device_name": "Pixel 8",
  "platform": "android",
  "device_public_key": "x25519:Hk3v9Q1mZ0p6cR4bT8wY2uN7aJ5eL1sD0fG3hK6xV9o="
}

HTTP/1.1 201 Created
{
  "device_id": "dev_01JA8M4Z7K2Q9W3E5R6T",
  "session_token": "ks_sess_…",
  "expires_in": 2592000,
  "plan": "family",
  "quota_bytes": 2199023255552,
  "chunk_size": 4194304
}

Развёртывание выделенного узла хранения

Клиенты тарифа «Бизнес» могут хранить зашифрованные блоки на собственной инфраструктуре: в своём дата-центре, на NAS или в частном облаке. Узел работает по лицензионному ключу, который выдаётся в личном кабинете в разделе Организация → Выделенный узел. Учёт пользователей, подписка и личный кабинет остаются в облаке KadrSync.

1. 1

   Подготовьте каталог и загрузите манифест

   Создайте рабочий каталог и получите файлы конфигурации. Ссылка на загрузку доступна в личном кабинете после активации тарифа.

   bashКопировать

   sudo mkdir -p /opt/kadrsync && cd /opt/kadrsync
   curl -fsSL -H "Authorization: Bearer $KADRSYNC_LICENSE_KEY" \
     https://dl.kadrsync.space/node/latest/bundle.tar.gz | tar xz

2. 2

   Укажите лицензию и параметры узла

   Отредактируйте файл .env: задайте лицензионный ключ, публичный адрес узла и сгенерируйте секрет для подписи сессионных маркеров.

   .envКопировать

   # Лицензионный ключ из личного кабинета (Организация → Выделенный узел)
   KADRSYNC_LICENSE_KEY=
   # Публичный адрес, по которому приложения обращаются к узлу
   KADRSYNC_PUBLIC_URL=https://storage.company.ru
   # Каталог для зашифрованных блоков
   KADRSYNC_BLOB_PATH=/srv/kadrsync/blobs
   # Секрет для подписи сессионных маркеров: openssl rand -hex 32
   KADRSYNC_SESSION_SECRET=
   POSTGRES_PASSWORD=

3. 3

   Запустите узел и привяжите его к организации

   После запуска узел проверит лицензию и появится в личном кабинете со статусом «Активен». Новые устройства сотрудников будут автоматически направлены на него.

   bashКопировать

   docker compose up -d
   docker compose exec node kadrsync-node license status
   # organization: org_01JA7…  plan: business  seats: 25  status: active

4. 4

   Настройте TLS и обратный прокси

   Приложения отказываются подключаться к узлу без HTTPS. Пример конфигурации Caddy с автоматическим выпуском сертификата:

   CaddyfileКопировать

   storage.company.ru {
       request_body {
           max_size 8MB
       }
       reverse_proxy node:8080
   }

REST API: аутентификация

Все запросы выполняются по HTTPS к https://api.kadrsync.space/v1 (или к адресу выделенного узла) и содержат сессионный маркер устройства в заголовке Authorization. Ответ на запрос /me содержит текущий тариф и использованный объём.

curl -s https://api.kadrsync.space/v1/me \
  -H "Authorization: Bearer $KADRSYNC_SESSION_TOKEN"

{
  "account_id": "acc_01JA7ZK3M0Q8R5T2V6W",
  "plan": "family",
  "subscription_status": "active",
  "renews_at": "2026-11-15T00:00:00Z",
  "quota_bytes": 2199023255552,
  "used_bytes": 230535987200
}