6.4 KiB
SHiNE — патч DM R2 v3 (15.11.2026)
Основа патча
Накладывать поверх версии проекта с применённым патчем SHiNE-R2-public-MVP-patch-2026.11.14.zip на архив SHiNE-bundle-2026.11.14-13.22.24.zip (либо поверх более новой версии, совместимой с этими серверными API).
Патч не заменяет изменённый после предыдущей работы attachment-format.js и не трогает новую публичную загрузку, Arweave и аватары.
Что изменилось
- Новые DM: формат
S:file;v=3, root manifest и AES-256-GCM-шифрование отдельных кусков до 8 МиБ, id = Base58(SHA-256(ciphertext)); никаких новых BitTorrent/Merkle-хешей. - Клиент отправляет JSON
fileId, sizeнаPOST /api/dm-files/prepareсо старым session key Ed25519 и отдельным доменом подписиDM_R2_PREPARE_V1. - Java подписывает PUT только в корзину
shine-dm. Ciphertext загружается браузером напрямую в S3 endpoint R2. PUT используетIf-None-Match: *;Content-Type: application/octet-stream. - Скачивание напрямую
https://dm-files.shineup.me/<fileId>по публичной ссылке; получатель перед расшифровкой проверяет SHA-256/Base58 каждого объекта. - Никакой ключ AES и исходный MIME в R2 не передаются, они находятся только в E2EE DM.
- Чтение старых вложений v1 и v2 сохранено. В старых v2 BitTorrent ещё проверяется — исключительно ради совместимости. UI не показывает подпись BitTorrent для v3.
- Передача голосовых вложений использует тот же v3.
- Лимит одного исходного файла в MVP 500 МиБ, один ciphertext-объект ≤8 МиБ+16; нет S3 Multipart и нет строгой гарантии отсутствия повреждённого R2-объекта при первом недобросовестном PUT.
Настройка Cloudflare
- Проверьте, что корзина R2
shine-dmсуществует и пользовательский доменdm-files.shineup.meимеет статус Active. - К
shine-dmприменено Object Lifecycle → Delete after 14 days → All objects. По согласованной политике это очистка R2, не гарантия исчезновения CDN-копий. - У
shine-dmустановлен CORS дляhttps://shineup.me(и реально используемых клиентских доменов). MethodsGET,HEAD,PUT; Headers*; ExposeContent-Length,ETag. - R2 API credential server имеет права Object Read & Write для
shine-filesиshine-dm. Никакие ключи не передаются в UI.
Настройка Java-сервера
В приватной конфигурации приложения:
r2.dmBucket=shine-dm
В переменных окружения сервиса Java (используются и публичным R2-модулем):
R2_ENDPOINT=https://<account-id>.r2.cloudflarestorage.com
R2_ACCESS_KEY_ID=<серверный S3 Access Key ID>
R2_SECRET_ACCESS_KEY=<серверный S3 Secret Access Key>
В случае jurisdiction-specific endpoint использовать именно значение из Cloudflare. Не включать переменные в Git или клиентский JS. После применения патча обновить JAR и выполнить restart службы.
Caddy / Nginx: добавить точный маршрут POST /api/dm-files/prepare (и CORS OPTIONS на тот же URL) к той же Java/Jetty, которая обрабатывает /ws и публичный /api/files/prepare. Маршрут должен быть выше SPA fallback; /dm-files/* оставить для старых файлов v1/v2.
Проверки
node scripts/tests/test-dm-r2-v3.mjs
node scripts/tests/test-r2-file-preparation.mjs
python3 scripts/check_docs.py
Нужно дополнительно сделать полноценную Java-сборку и live R2 интеграционный тест на тестовом сервере, поскольку в среде сборки этого патча Gradle не может скачать дистрибутив.
Рекомендуемый живой сценарий: отправить файл ~9 МиБ из личного чата; убедиться, что появились 2 ciphertext-части и 1 зашифрованный manifest в shine-dm, что ключи не попали в R2, а получатель скачал и открыл исходный файл. Затем проверить отправку голосового сообщения, файл 0 байт, файл около 500 МиБ, отсутствующую CORS-настройку и старую переписку v2.
Ограничения перед production
- Нужны rate limits на выдачу подписанных URL и мониторинг расходов R2; сервер не проверяет байты против объявленного SHA-256 (это проверяет скачивающий клиент).
If-None-Match: *запрещает перезапись уже существующего ID, но не предотвращает первоначальную загрузку неправильных байтов под этим ID.- Старые клиенты не умеют читать v3 — потребуется обновить клиентов обоих участников DM.
- Пропуск зашифрованного файла через Java не происходит, но Java подписывает каждую новую часть; возможны десятки prepare-запросов на одно крупное вложение.
- Production deployment не выполнялся.