SHA256
Поддержать range-загрузку публичных файлов
This commit is contained in:
@@ -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` не являются частью текущего протокола.
|
||||
|
||||
Reference in New Issue
Block a user