5.2 KiB
SHiNE — патч R2 для публичных вложений (14.11.2026)
База: SHiNE-bundle-2026.11.14-13.22.24.zip. Это overlay-патч: распаковать поверх точно этой версии репозитория, сохраняя пути. Не раскатывать без проверки на тестовом сервере.
Что изменено
S:att;v=1поддерживаетpr(BitTorrent v2 pieces root, base64url) и необязательноеmm(MIME);arсохраняется. Старыйsha256остаётся читаемым.- SHA-256 у аватаров и существующий
/files/<sha256>не меняются. - Новый
file-preparation-service.jsвычисляетprчерез существующий аккумулятор порциями 1 МиБ; по окончательному файлу. - Новый
POST /api/files/prepareпринимает{pr,size,mm}, проверяет Ed25519 подпись существующей сессии, возвращаетuploadUrl/requiredHeadersилиexists=true. - Клиент напрямую делает один PUT в Cloudflare R2 (без проксирования байтов Java), максимальный размер 500 МиБ, без Multipart.
- Для публичных вложений нет встроенного медиа-превью — только файловые карточки и прямые URL; в DM просмотрщик не меняется.
- Для новых Arweave-вложений считаем
prи сохраняемmm, но аватары и транзакции прошлых версий остаются на SHA-256.
Конфигурация Java-сервера
В защищённом окружении процесса Java задать:
R2_ENDPOINT=https://<account_id>.r2.cloudflarestorage.com
R2_ACCESS_KEY_ID=<secret>
R2_SECRET_ACCESS_KEY=<secret>
И r2.publicBucket=shine-files в обычной конфигурации. Убедиться, что используется endpoint юрисдикции, соответствующей bucket. Значения в Git НЕ добавлять.
Cloudflare CORS bucket shine-files должен позволять PUT, GET, HEAD с origins SHiNE и с заголовками Content-Type, If-None-Match (можно AllowedHeaders: ["*"]). Для тестового UI-домена добавить соответствующий origin в Cloudflare CORS; Java API в патче разрешает https://test.shineup.me наряду с основным доменом. Custom Domain: https://files.shineup.me.
Запрос подписанного разрешения
POST /api/files/prepare
Content-Type: application/json
X-Shine-Session-Id: <sessionId>
X-Shine-Time-Ms: <epoch-ms>
X-Shine-Signature: <Ed25519 signature>
{"pr":"<43-char-base64url>","size":12345,"mm":"video/mp4"}
Подпись по UTF-8 строке:
PUBLIC_R2_PREPARE_V1:<sessionId>:<pr>:<size>:<mm>:<epoch-ms>
От сервера клиент получает requiredHeaders: передать ровно эти заголовки при PUT в uploadUrl. If-None-Match: * запрещает перезапись. Ключи API никогда не отправляются клиенту.
Тесты
node scripts/tests/test-r2-file-preparation.mjs
python3 scripts/check_docs.py
./gradlew compileJava test
В среде подготовки патча проверки JavaScript и документации прошли. Java-сборку нельзя было завершить: Gradle Wrapper хотел скачать Gradle 8.14 с services.gradle.org, но сеть контейнера недоступна. Выполнить Gradle-сборку и сквозной тест реального R2 до production deploy. Реальный R2 не тестировался.
Риски, которые остаются в MVP
- Клиент задаёт
pr; сервер не пересчитывает хеш содержимого. Возможна первоначальная подмена объекта под заявленным ключом; проверка размера иIf-None-Matchне решают эту проблему полностью. Для доверенной дедупликации нужна независимая проверка или механизм карантина. - Сервер проверяет заявленный размер до подписи, но простой Presigned PUT сам по себе не обеспечивает строгий лимит фактически переданных байтов. Обязательно ограничить расходы/злоупотребления в окружении R2; для публичного production это отдельный вопрос безопасности.
- Один PUT при обрыве загружается заново. Multipart пока исключён по согласованию.
- Для тестового домена нужны правильные CORS origins; кэширование Cloudflare необязательно.