Поддержать range-загрузку публичных файлов

This commit is contained in:
AidarKC
2026-10-10 16:48:22 +03:00
parent 5e9699613d
commit 4d10096ba2
7 changed files with 278 additions and 35 deletions
+46 -8
View File
@@ -65,19 +65,55 @@ SHA256(received bytes) == sha256 из URL
Если корректный объект уже существует и размер совпадает, PUT идемпотентно отвечает `alreadyExists=true`.
## 4. GET и HEAD
## 4. GET и HEAD (включая HTTP Range)
Java servlet умеет `GET` и `HEAD` как fallback. В production рекомендуется не пропускать чтение через Java: Caddy должен отдавать файл непосредственно с диска.
Java servlet обслуживает `GET /files/<sha256>` и `HEAD /files/<sha256>`.
Проверка SHA-256 **при чтении не выполняется**: хеш проверяется при исходном PUT,
файл immutable, а скачивание не должно требовать предварительного прочтения всех байтов.
Проверка корректности при повторном PUT уже имеющегося объекта сохранена.
Ответ immutable:
Полный GET, как и прежде, возвращает `200 OK` и `Content-Length` всего файла.
HEAD всегда возвращает метаданные **полного объекта** без тела и без обхода
всего файла по байтам (Range в HEAD игнорируется).
```text
Cache-Control: public, max-age=31536000, immutable
ETag: "<sha256>"
Content-Type: application/octet-stream
Для `GET` с одним диапазоном:
```http
Range: bytes=0-262143
```
Файловое хранилище не определяет тип контента. Официальный клиент решает, как интерпретировать байты, на основании имени `nm` из `S:att`. Если пользователь указал неверное расширение или положил неподходящие байты, клиент просто не сможет отобразить такой media-файл.
Ответ:
```http
HTTP/1.1 206 Partial Content
Accept-Ranges: bytes
Content-Range: bytes 0-262143/<общий размер>
Content-Length: 262144
ETag: "<sha256>"
```
Поддерживаются формы `bytes=START-END`, `bytes=START-` и `bytes=-SUFFIX`.
Для составных или неудовлетворяемых диапазонов сервер возвращает `416` +
`Content-Range: bytes */<общий размер>`. `If-Range` поддерживает точный
совпадающий ETag; при несовпадении возвращается полный `200`.
Остальные заголовки:
```http
Cache-Control: public, max-age=31536000, immutable
Cross-Origin-Resource-Policy: cross-origin
Access-Control-Allow-Origin: *
```
Тип для MP4, WebM, Ogg и AVI Java определяет по первым байтам файла.
Неизвестные типы остаются `application/octet-stream`. Протокол `S:att`
не меняется, имя файла/тип на сервере не сохраняются.
При прямой выдаче Caddy (`file_server`) Range обеспечивает Caddy, а не Java.
Следует проверить `Content-Type` (у файлов с именем SHA-256 нет расширения),
а также корректность ответа `206` через публичный домен, особенно с CDN.
Если нужен корректный MIME по сигнатуре, используйте HTTP reverse_proxy к Java
из инструкции `deploy/PUBLIC_FILES_CADDY_CLOUDFLARE.md`.
## 5. Связь с `S:att`
@@ -101,4 +137,6 @@ https://<current-access-server>/files/<sha256>
## 6. Preview
В UI видео со storage=server получает прямую ссылку `/files/<sha256>` (без полного `fetch` в Blob): браузер сам запрашивает диапазоны, читает длительность и загружает стартовый кадр. Размер берётся из `sz` вложения. Для Arweave частичная загрузка зависит от gateway.
Отдельных preview-файлов сейчас нет. `preAr`, `preSha256`, `previewAr`, `previewSha256` не являются частью текущего протокола.