Добавить лицензию CC0 1.0

This commit is contained in:
AidarKC
2026-11-16 23:50:28 +03:00
parent 548160f7f8
commit c477560632
39 changed files with 901 additions and 138 deletions
+22 -3
View File
@@ -4,7 +4,7 @@
Все **новые** файлы и голосовые сообщения DM официального PWA загружаются непосредственно в R2 `shine-dm`.
Содержимое файлов Java-сервером не проксируется, а сервер выдаёт временные S3 PUT URL после проверки Ed25519-сессии.
Скачивание публичное по `https://dm-files.shineup.me/<id>`: там хранится **только ciphertext**.
Скачивание публичное по `https://dm-files.<домен access-сервера отправителя>/<id>`: там хранится **только ciphertext**.
Ключ AES, префикс IV, имя, MIME и размер помещаются внутрь уже E2EE-зашифрованного сообщения.
В v3 **нет BitTorrent, Merkle/`pieces root` и infohash**. Они сохранились только для чтения ранее отправленных DM v2.
@@ -67,13 +67,13 @@ DM_R2_PREPARE_V1:{sessionId}:{fileId}:{size}:{timeMs}
1. Скачать ciphertext root manifest по адресу, записанному в E2EE-сообщении.
2. Проверить `Base58(SHA-256(ciphertext)) == id`.
3. Расшифровать AES-GCM и проверить структуру манифеста.
4. Получить каждую зашифрованную часть напрямую с `dm-files.shineup.me/<id>`.
4. Получить каждую зашифрованную часть напрямую с `dm-files.<домен access-сервера отправителя>/<id>`.
5. Проверить SHA-256 каждой части, расшифровать AES-GCM, проверить порядок и длину.
6. Последовательно записать исходные данные в браузерный поток сохранения или Blob fallback.
## Настройка Cloudflare
- R2 Bucket: `shine-dm`, публичный custom domain `dm-files.shineup.me` (в R2 только шифротекст).
- R2 Bucket: `shine-dm`, публичный custom domain `dm-files.<домен access-сервера>` (в R2 только шифротекст).
- Object Lifecycle: удалить объекты через 14 дней (Cloudflare выполняет удаление асинхронно).
- CDN-кэширование разрешено: файлы могут оставаться доступными из кэша после удаления из R2, гарантий точного срока недоступности нет.
- CORS: с origin сайта SHiNE разрешить `GET`, `HEAD`, `PUT`; `AllowedHeaders: ["*"]`; `ExposeHeaders: ["Content-Length", "ETag"]`.
@@ -96,3 +96,22 @@ DM v1 и DM v2 читаются прежними обработчиками (с
## Журнал выдачи R2 разрешений (PostgreSQL v42)
Сервер записывает в `dm_file_uploads` одну строку **на каждый зашифрованный объект**, для которого был выдан URL, либо обнаружено существование объекта. Поля: `user_login`, `file_hash` (Base58 SHA-256 ciphertext), `file_size_bytes`, `requested_at`, `disposition`. Это *не* подтверждение успешной передачи в R2 и *не* одна строка на исходный файл: один DM может содержать много частей и манифест. Ни исходное имя, ни MIME, ни AES-ключ не попадают в журнал. Криптография и формат `S:file;v=3` не меняются.
## Обновление: отдельный R2 каждого access-сервера (16.11.2026)
- Новое `<S:file;v=3;id=...;key=...;ivp=...;...;at=...>` **не передаёт URL**:
клиент восстанавливает `https://dm-files.<access-server отправителя>/<id>` через
общий REST-resolver и RAM-кэш. Старая форма v3 с `url` принимается на чтение.
- `at` — время завершения загрузки манифеста (миллисекунды Unix); при его
отсутствии применяется timestamp сообщения. По истечении 14 дней UI
заменяет вложение пояснением, без обращения к R2 и resolver.
- По требованию пользователя нет клиентского сохранения сервера в IndexedDB,
повторных периодических проверок или миграции файлов. При загрузке ошибки
resolver обновляется не чаще одного раза в час на отправителя; в рамках
одновременных ошибок запросы объединяются.
- Старые DM v1/v2 не подпадают под новое правило 14 дней, т.к. их историческое
локальное хранение регулируется отдельным механизмом.
- Для каждого access-сервера оператор настраивает DNS/R2 CORS/lifecycle.
Java автоматически формирует URL по собственной server-PDA в PostgreSQL,
отдельное `r2.dmPublicBaseUrl` не требуется. Изменений
бинарного контейнера DM, AES-GCM и SHA-256 не происходит.