SHA256
212 lines
8.1 KiB
Markdown
212 lines
8.1 KiB
Markdown
# Public files: Caddy + Cloudflare на том же домене
|
|
|
|
Цель: использовать один домен `shineup.me`, но обрабатывать `/files/<sha256>` отдельно от UI/API.
|
|
|
|
- `PUT /files/<sha256>` -> Java SHiNE server, потому что нужна session-signature и проверка SHA-256;
|
|
- `GET/HEAD /files/<sha256>` -> Caddy напрямую с диска;
|
|
- `/ws`, `/dm-files/*` и остальные маршруты работают как раньше;
|
|
- Cloudflare кэширует только `/files/*`.
|
|
|
|
## 1. Один каталог для Java и Caddy
|
|
|
|
Например:
|
|
|
|
```text
|
|
/home/player/shine-public-files
|
|
```
|
|
|
|
Java запускается с:
|
|
|
|
```text
|
|
-Dpublic.files.storageDir=/home/player/shine-public-files
|
|
```
|
|
|
|
`deploy/scripts/deploy_server.sh` поддерживает переменную:
|
|
|
|
```bash
|
|
REMOTE_PUBLIC_FILES_DIR=/home/player/shine-public-files
|
|
```
|
|
|
|
Caddy должен иметь право прохода к родительским каталогам и чтения файлов. `PublicFileServlet` после успешного PUT выставляет финальному файлу права `0644` на POSIX-системах, но права родительского каталога всё равно нужно проверить. Например:
|
|
|
|
```bash
|
|
chmod 755 /home/player/shine-public-files
|
|
```
|
|
|
|
Если `/home/player` закрыт для пользователя `caddy`, используйте каталог в `/srv`/`/var/lib` или настройте группу/ACL вместо расширения доступа ко всему home.
|
|
|
|
## 2. Caddyfile
|
|
|
|
### Вариант A: GET/HEAD/PUT через Java (надежный MIME и HTTP Range)
|
|
|
|
Для запуска предпросмотра видео проще всего добавить **в каждый site block**
|
|
(`shineup.me`, `:80` и соответствующие тестовые домены) до общего SPA `handle`:
|
|
|
|
```caddyfile
|
|
@shinePublicFiles path_regexp shine_public_file ^/files/[0-9a-f]{64}$
|
|
handle @shinePublicFiles {
|
|
reverse_proxy 127.0.0.1:7070
|
|
}
|
|
```
|
|
|
|
Java проверяет подпись/хеш при PUT, а при GET поддерживает `206`, Range,
|
|
`Accept-Ranges`, `Content-Range`, узнаёт MP4/WebM по сигнатуре и отдаёт
|
|
байты потоково без SHA-256 проверки при каждом скачивании. Маршрут должен
|
|
располагаться раньше SPA fallback; иначе `/files/<sha256>` может получить HTML.
|
|
Проверьте порт Java-сервера (в примере `7070`). Для больших потоков это
|
|
проще в настройке, но нагружает Java больше, чем прямая раздача Caddy.
|
|
|
|
### Вариант B: прямая отдача Caddy (лучше для большого трафика)
|
|
|
|
|
|
Маршруты `/files/*` должны стоять **до SPA fallback**.
|
|
|
|
```caddyfile
|
|
shineup.me {
|
|
encode zstd gzip
|
|
|
|
@publicFilesRead {
|
|
method GET HEAD
|
|
path_regexp public_file ^/files/[0-9a-f]{64}$
|
|
}
|
|
handle @publicFilesRead {
|
|
uri strip_prefix /files
|
|
root * /home/player/shine-public-files
|
|
header {
|
|
Cache-Control "public, max-age=31536000, immutable"
|
|
Access-Control-Allow-Origin "*"
|
|
Cross-Origin-Resource-Policy "cross-origin"
|
|
}
|
|
file_server
|
|
}
|
|
|
|
@publicFilesWrite {
|
|
method PUT OPTIONS
|
|
path /files/*
|
|
}
|
|
handle @publicFilesWrite {
|
|
reverse_proxy 127.0.0.1:7070
|
|
}
|
|
|
|
@ws path /ws /ws/*
|
|
handle @ws {
|
|
reverse_proxy 127.0.0.1:7070
|
|
}
|
|
|
|
@dmfiles path /dm-files /dm-files/*
|
|
handle @dmfiles {
|
|
reverse_proxy 127.0.0.1:7070
|
|
}
|
|
|
|
handle {
|
|
root * /home/player/SHiNE/shine-ui
|
|
try_files {path} /index.html
|
|
file_server
|
|
header -Etag
|
|
header {
|
|
Cache-Control "no-store, no-cache, must-revalidate, max-age=0"
|
|
Pragma "no-cache"
|
|
Expires "0"
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
Если используется отдельный `:80` site block, тот же `/files` routing нужно добавить и туда либо перенаправлять HTTP на HTTPS.
|
|
|
|
После изменения любого варианта:
|
|
|
|
```bash
|
|
sudo caddy validate --config /etc/caddy/Caddyfile
|
|
sudo systemctl reload caddy
|
|
```
|
|
|
|
## 3. Cloudflare Cache Rules
|
|
|
|
### Rule 1: public files
|
|
|
|
Условие:
|
|
|
|
```text
|
|
Hostname equals shineup.me
|
|
AND URI Path starts with /files/
|
|
```
|
|
|
|
Настройки:
|
|
|
|
```text
|
|
Cache eligibility: Eligible for cache
|
|
Edge TTL: Override origin / большой TTL (например 1 год)
|
|
```
|
|
|
|
URL immutable: новые байты всегда имеют новый SHA-256 и, следовательно, новый URL. Поэтому purge при обновлении файла не нужен.
|
|
|
|
### Rule 2: всё остальное
|
|
|
|
Чтобы исключить случайное кэширование динамики, можно добавить правило:
|
|
|
|
```text
|
|
Hostname equals shineup.me
|
|
AND URI Path does not start with /files/
|
|
```
|
|
|
|
и выставить:
|
|
|
|
```text
|
|
Cache eligibility: Bypass cache
|
|
```
|
|
|
|
UI дополнительно уже отправляет `Cache-Control: no-store` через Caddy.
|
|
|
|
## 4. Проверка
|
|
|
|
Загрузить файл через UI, затем проверить:
|
|
|
|
```bash
|
|
curl -I https://shineup.me/files/<sha256>
|
|
curl -i -H 'Range: bytes=0-1023' https://shineup.me/files/<sha256> -o /dev/null -D -
|
|
# Ожидается: HTTP 206, Content-Range: bytes 0-1023/<size>, Content-Length: 1024
|
|
# Без Range: 200; Range: bytes=999999999999- : 416 + Content-Range: bytes */<size>
|
|
```
|
|
|
|
Ожидается:
|
|
|
|
```text
|
|
HTTP/2 200
|
|
cache-control: public, max-age=31536000, immutable
|
|
content-length: ...
|
|
etag: ...
|
|
```
|
|
|
|
При повторных запросах после прогрева Cloudflare в ответе должен появиться соответствующий cache status (`HIT`).
|
|
|
|
## 5. Важно
|
|
|
|
- сам Java server не должен использоваться как основной download path в production;
|
|
- Caddy читает ровно те же файлы, которые записывает Java;
|
|
- никакие имена пользователей или MIME не входят в path;
|
|
- `/files/<sha256>` публичен: это вложение публичного сообщения;
|
|
- удаление сообщения не должно автоматически удалять объект из `public-files`, потому что тот же SHA-256 может использоваться другими сообщениями или пользователями.
|
|
|
|
## Независимые R2 у access-серверов (16.11.2026)
|
|
|
|
Для `https://node2.example.net` организуйте отдельные публичные DNS-домены:
|
|
`https://files.node2.example.net` и `https://dm-files.node2.example.net`.
|
|
Оба должны указывать на R2-корзины **этого** оператора (отдельные от
|
|
R2 основного SHiNE), а не на Java `/files` и `/dm-files` legacy.
|
|
|
|
На Java-сервере владельца задайте:
|
|
```properties
|
|
# Публичные адреса файлов вычисляются автоматически из server-PDA:
|
|
# https://files.node2.example.net
|
|
# https://dm-files.node2.example.net
|
|
```
|
|
Дополнительные переменные `R2_PUBLIC_BASE_URL` и `R2_DM_PUBLIC_BASE_URL` не нужны: домены всегда определяются по server-PDA текущего сервера.
|
|
Оставшиеся `R2_ENDPOINT`, `R2_ACCESS_KEY_ID`, `R2_SECRET_ACCESS_KEY`,
|
|
`r2.publicBucket`, `r2.dmBucket` также должны указывать на его собственные
|
|
корзины/ключи. Публичные R2 требуют GET/HEAD/Range и браузерного CORS,
|
|
DM R2 — также lifecycle на 14 дней. На access-сервере просмотрщика
|
|
маршрут `GET /api/files/user-server` должен проксироваться к Jetty до SPA
|
|
fallback. Это не меняет Solana PDA и не переносит старые объекты при миграции
|
|
пользователя.
|