SHA256
Вложения файлов со своего сервера доступа пользователя
This commit is contained in:
@@ -0,0 +1,164 @@
|
||||
# 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
|
||||
|
||||
Маршруты `/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>
|
||||
```
|
||||
|
||||
Ожидается:
|
||||
|
||||
```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 может использоваться другими сообщениями или пользователями.
|
||||
Reference in New Issue
Block a user