Files
SHiNE-server/deploy/PUBLIC_FILES_CADDY_CLOUDFLARE.md
T

6.6 KiB
Raw Blame History

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

Например:

/home/player/shine-public-files

Java запускается с:

-Dpublic.files.storageDir=/home/player/shine-public-files

deploy/scripts/deploy_server.sh поддерживает переменную:

REMOTE_PUBLIC_FILES_DIR=/home/player/shine-public-files

Caddy должен иметь право прохода к родительским каталогам и чтения файлов. PublicFileServlet после успешного PUT выставляет финальному файлу права 0644 на POSIX-системах, но права родительского каталога всё равно нужно проверить. Например:

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:

@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.

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.

После изменения любого варианта:

sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy

3. Cloudflare Cache Rules

Rule 1: public files

Условие:

Hostname equals shineup.me
AND URI Path starts with /files/

Настройки:

Cache eligibility: Eligible for cache
Edge TTL: Override origin / большой TTL (например 1 год)

URL immutable: новые байты всегда имеют новый SHA-256 и, следовательно, новый URL. Поэтому purge при обновлении файла не нужен.

Rule 2: всё остальное

Чтобы исключить случайное кэширование динамики, можно добавить правило:

Hostname equals shineup.me
AND URI Path does not start with /files/

и выставить:

Cache eligibility: Bypass cache

UI дополнительно уже отправляет Cache-Control: no-store через Caddy.

4. Проверка

Загрузить файл через UI, затем проверить:

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>

Ожидается:

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 может использоваться другими сообщениями или пользователями.