# 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 Маршруты `/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/ ``` Ожидается: ```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 может использоваться другими сообщениями или пользователями.