Skip to content

Sync and Devices ru

Se.Cherkasov edited this page Aug 23, 2026 · 1 revision

Синхронизация и устройства

English · Русский

Синхронизация необязательна и всегда идёт на ваш сервер: облака вендора не существует. Сервер хранит шифротексты и метаданные; мастер-пароль и ключи шифрования до него не доходят.

Запуск сервера

Быстрее всего — готовый образ:

docker run -d --name skerry-sync -p 8080:8080 \
  -e SKERRY_JWT_SECRET="$(openssl rand -base64 48)" \
  -e SKERRY_ADMIN_TOKEN="$(openssl rand -hex 16)" \
  -v skerry-data:/data \
  secherkasov/skerry-sync:latest

Он слушает http://localhost:8080, держит SQLite в томе и отдаёт встроенный офлайн-фронтенд: публичная страница /, кабинет аккаунта /account, консоль оператора /console. Конфигурация, PostgreSQL, терминация TLS, резервные копии, метрики и админ-CLI описаны в server/README.md; сам протокол — в Протоколе синхронизации.

TLS: сервер говорит по обычному HTTP и ждёт обратный прокси (Caddy, nginx, Traefik) перед собой. По http:// полезная нагрузка всё равно зашифрована end-to-end и пароль не передаётся, но JWT, метаданные и админ-токен видны в сети. Работа только в доверенной локальной сети по http:// — осознанно поддерживаемый режим, и клиент всё равно предупреждает об URL.

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

Настройки → Синхронизация → Настроить: URL сервера, id аккаунта (e-mail), мастер-пароль. Клиент выводит ключи локально и загружает SRP-верификатор и обёрнутый ключ данных — ничего, чем можно было бы что-то расшифровать.

«Оставаться подключённым» переподключает после перезапуска, не спрашивая пароль снова.

Добавление второго устройства

Два пути:

  1. Вход — тот же сервер, тот же id аккаунта, тот же мастер-пароль.
  2. Привязка по QR — на уже подключённом устройстве Настройки → Синхронизация → Привязать устройство выдаёт QR и одноразовый код (sk1.…) на несколько минут. Новое устройство сканирует или вставляет его и выбирает свой пароль устройства.

Что синхронизируется

Хосты и группы, ключи и пароли, известные хосты и доверенные CA, сниппеты, ранбуки и журналы прогонов, туннели, настройки, история терминала и корзина. Два намеренных исключения:

  • Ключи из файла — такой ключ локален для устройства; путь ничего не значит на другой машине.
  • Ничего в открытом виде — каждая запись покидает устройство уже зашифрованной.

Живые обновления и конфликты

WebSocket несёт сигнал «есть изменения», содержащий только новый курсор, но не содержимое; клиент затем забирает дельту. Конфликты решаются last-writer-wins по версии записи, при равенстве — по id устройства. Удаления идут надгробиями и физически чистятся на сервере по истечении срока.

Устройства

Настройки → Синхронизация перечисляют привязанные устройства с платформой и временем последней синхронизации и позволяют отозвать любое. Отозванное устройство больше не может забирать данные.

Веб-доступ

Настройки → Синхронизация → Веб-доступ задают отдельный веб-пароль (8–256 символов) для страницы /account в браузере. Он не связан ни с одним ключом хранилища: браузерная сессия читает метаданные, которые сервер и так держит открыто — устройства, команды, живые сессии, конверты записей, собственный журнал аккаунта — и может отозвать устройство, но не может расшифровать запись. Снятие пароля также завершает открытую браузерную сессию.

Если что-то не так

Сообщение Что значит
Plain http:// — not encrypted in transit URL не https://; допустимо в доверенной локальной сети, иначе нет
Повторно включить отпечаток подключение к аккаунту сменило ключ хранилища, поэтому биометрия отключилась
Couldn't load devices. Try Sync now. список устройств не получен — сервер недоступен или токен истёк

Подробнее — в Диагностике.

Clone this wiki locally