# Public files: Caddy + Cloudflare на том же домене Цель: использовать один домен `shineup.me`, но обрабатывать `/files/` отдельно от UI/API. - `PUT /files/` -> Java SHiNE server, потому что нужна session-signature и проверка SHA-256; - `GET/HEAD /files/` -> 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/` может получить 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/ curl -i -H 'Range: bytes=0-1023' https://shineup.me/files/ -o /dev/null -D - # Ожидается: HTTP 206, Content-Range: bytes 0-1023/, Content-Length: 1024 # Без Range: 200; Range: bytes=999999999999- : 416 + Content-Range: bytes */ ``` Ожидается: ```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/` публичен: это вложение публичного сообщения; - удаление сообщения не должно автоматически удалять объект из `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 и не переносит старые объекты при миграции пользователя.