mirror of
https://github.com/Govor-team/Govor.git
synced 2026-11-16 20:56:03 +00:00
632ac04b56
Add message forwarding and reply lookup, friend removal and blocking endpoints, and database-backed Govor+ privileges with customizable profile tags. Include migrations, integration tests, and updated API and operations documentation.
110 lines
11 KiB
Markdown
110 lines
11 KiB
Markdown
# Частые вопросы
|
||
|
||
## Запуск и сервер
|
||
|
||
### Нужны ли Firebase и production-БД для разработки?
|
||
|
||
Нет. Для запуска API нужна отдельная PostgreSQL, а Firebase можно выключить `Firebase__Enabled=false`. Серверные тесты по умолчанию используют SQLite in-memory и подменённые зависимости. [Быстрый старт](getting-started.md), [тесты](testing.md).
|
||
|
||
### Почему сборка проходит, а сервер не запускается?
|
||
|
||
Сборка не проверяет runtime-секреты, доступ к БД и Firebase credentials. Проверьте обязательные переменные, файл модерации, порт и журналы. [Диагностика](diagnostics.md).
|
||
|
||
### Почему /server/ping отвечает 200, а /server/ready — 503?
|
||
|
||
Процесс доступен, но БД недоступна либо есть неприменённые миграции. Примените миграции отдельным `--migrate-only` на нужной БД. Не запускайте его вслепую на неизвестной базе.
|
||
|
||
### Создаётся ли первый администратор автоматически?
|
||
|
||
Сам аккаунт автоматически не создаётся. Оператор задаёт `InvitationAdmin__Key` и создаёт административное приглашение через `/api/admin/InviteUser/InvitationWithKey`, передавая секрет в теле. JWT для этого метода не нужен; без настроенного ключа — 503. Затем выполняется обычная регистрация по коду. После настройки отключите этот способ, убрав ключ. [Администрирование](endpoints/admin-and-groups.md).
|
||
|
||
### Можно ли запускать несколько серверов?
|
||
|
||
Не без дополнительной работы: presence, подключения, SRP challenge и rate limit локальны процессу; файлы тоже локальные. Нужны общая инфраструктура событий/файлов и согласованная обработка challenge. [Эксплуатация](operations.md).
|
||
|
||
## Вход и история
|
||
|
||
### Чем access отличается от refresh?
|
||
|
||
Access авторизует HTTP/SignalR; refresh меняет пару токенов на `/api/auth/token/refresh`. Refresh не работает как bearer access. По умолчанию access действует 10 минут, refresh-сессия — 30 дней с продлением. [Аутентификация](endpoints/authentication/README.md).
|
||
|
||
### Почему старый парольный login перестал работать?
|
||
|
||
SRP-аккаунт получает `Auth.PasswordProofRequired`: используйте обновлённый клиент. Старый bcrypt-вход остался только для миграции. Не делайте автоматический fallback с передачей открытого пароля. [Переход](password-recovery.md).
|
||
|
||
### Почему после обновления токена второй запрос получил InvalidToken?
|
||
|
||
Refresh одноразово заменяет хеш. Параллельные обновления конкурируют; используйте один общий refresh и сохраните новую пару. Потеря ответа после сохранения также может потребовать нового входа.
|
||
|
||
### Вошёл на новом устройстве, но старые сообщения не читаются. Почему?
|
||
|
||
Авторизация и ключи истории — разные данные. Если парольная копия настроена, архив восстанавливается по паролю; иначе нужен резервный код или доверенное устройство с ключами. Сервер не может создать отсутствующий приватный ключ. [Восстановление](password-recovery.md).
|
||
|
||
### Что делать, если забыт пароль?
|
||
|
||
Администратор может сбросить доступ, но не расшифровать историю. После входа задайте новый пароль и восстановите архив кодом/с устройства. Без старого пароля, кода и устройства можно лишь явно начать с новыми ключами. Полученные собеседниками копии этим не удаляются.
|
||
|
||
### Нужно ли удалять ключи при выходе или сетевой ошибке?
|
||
|
||
Не удаляйте единственную копию истории автоматически. Завершение сессии и стирание архива — разные операции. Перед отказом от старого устройства проверьте восстановление на новом.
|
||
|
||
### Может ли сервер читать зашифрованные сообщения?
|
||
|
||
Он хранит ciphertext и зашифрованные архивы, но не пользовательские секреты. Метаданные, участники, время и размеры видны; профиль, аватары и реакции не входят в ciphertext сообщения. Первая встреча и состав группы доверяют серверу. FS/PCS и прозрачности ключей нет. [Подробные границы E2EE](e2ee.md).
|
||
|
||
## Чаты, файлы и события
|
||
|
||
### Что передавать в recipientId личного сообщения?
|
||
|
||
ID PrivateChat, полученный через `/api/user/{friendId}/private-chat`. Это не friendId. Для группы передаётся groupId и `recipientType=1`.
|
||
|
||
### Почему «публичная» группа не отдаёт историю всем?
|
||
|
||
Публичность разрешает поиск и вступление. История и команды требуют активного незаблокированного членства. Администратор сервера и администратор группы — разные роли. [Группы](groups.md).
|
||
|
||
### Почему отправка сообщает E2EE_DEVICES_CHANGED?
|
||
|
||
Каталог устройств изменился между загрузкой ключей и отправкой. Перечитайте его и заново подготовьте согласованный конверт. Не переходите на открытый текст.
|
||
|
||
### Можно ли повторить Send после сетевого сбоя?
|
||
|
||
Тот же E2EE-конверт с тем же messageId и контекстом распознаётся как сохранённая отправка. Новый messageId создаёт другую операцию. События могут повториться, поэтому объединяйте по ID. Это не общая идемпотентность всех методов.
|
||
|
||
### Почему HTTP возвращает id, а хаб — messageId?
|
||
|
||
Это разные DTO. Явно преобразуйте их в общую клиентскую модель. Также различаются структуры HTTP/SignalR вложений. [Сериализация](code-docs/hubresult-less-than-t-greater-than.md).
|
||
|
||
### Почему загрузка обычной картинки как вложения даёт 400?
|
||
|
||
Вложение сообщения сначала шифруется клиентом. MIME upload — `application/vnd.govor.encrypted`, ключ не передаётся открытым полем. Лимит 20 000 000 байт относится ко всему запросу, а не только исходному файлу. [Медиа](endpoints/mediacontroller.md).
|
||
|
||
### Почему отправленное сообщение не равно прочитанному?
|
||
|
||
Сохранение, доставка SignalR, принятие FCM и просмотр пользователем — разные этапы. Прочтение фиксируется отдельной командой. [Прочтение](endpoints/message-read.md).
|
||
|
||
### Почему online не означает доступность для push?
|
||
|
||
Online отражает соединения PresenceHub в памяти процесса. Push зависит от FCM-токена сессии, разрешений ОС и провайдера. HTTP ping отдельно обновляет lastSeen.
|
||
|
||
### Как восстановить пропущенные события?
|
||
|
||
После reconnect загрузите HTTP-снимки истории, счётчиков, реакций, групп/прав, заявок и открытых профилей. SignalR не предоставляет долговременный журнал. Порядок параллельных событий не определяет актуальные права.
|
||
|
||
### Почему при выключенном Firebase нет отложенных push после включения?
|
||
|
||
NullPushProvider считает задачи обработанными. Он предназначен для работы без доставки, а не для накопления. [Push](endpoints/push.md).
|
||
|
||
## Обновления и поддержка
|
||
|
||
### Сохранятся ли вложения после нового Docker-образа?
|
||
|
||
Только при постоянном uploads и правильном mount. Сама БД хранит ссылки, но не заменяет файлы. [VPS](vps-deployment.md), [резервные копии](operations.md).
|
||
|
||
### Можно ли откатить только образ после миграций?
|
||
|
||
Только если старый код совместим с новой схемой. Скрипт не откатывает БД автоматически. Нужны проверенная копия и план восстановления.
|
||
|
||
### Какие данные приложить к сообщению об ошибке?
|
||
|
||
Версию сервера/клиента, UTC-время, метод/маршрут или команду хаба, HTTP/HubResult status, errorCode и обезличенный фрагмент лога. Не прикладывайте пароли, токены, runtime.env, service account или приватные ключи.
|