From 4d10096ba24ca86d51c46c39aa00e0881e6b020661320af6489f262696d220cf Mon Sep 17 00:00:00 2001 From: AidarKC Date: Sat, 10 Oct 2026 16:48:22 +0300 Subject: [PATCH] =?UTF-8?q?=D0=9F=D0=BE=D0=B4=D0=B4=D0=B5=D1=80=D0=B6?= =?UTF-8?q?=D0=B0=D1=82=D1=8C=20range-=D0=B7=D0=B0=D0=B3=D1=80=D1=83=D0=B7?= =?UTF-8?q?=D0=BA=D1=83=20=D0=BF=D1=83=D0=B1=D0=BB=D0=B8=D1=87=D0=BD=D1=8B?= =?UTF-8?q?=D1=85=20=D1=84=D0=B0=D0=B9=D0=BB=D0=BE=D0=B2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../java/server/files/PublicFileServlet.java | 135 +++++++++++++++--- .../server/files/PublicFileRangeTest.java | 39 +++++ VERSION.properties | 4 +- deploy/PUBLIC_FILES_CADDY_CLOUDFLARE.md | 27 +++- docs/API/21_Public_File_Storage_API.md | 54 +++++-- shine-UI/js/services/attachment-format.js | 35 ++++- shine-UI/styles/components/attachments.css | 19 +++ 7 files changed, 278 insertions(+), 35 deletions(-) create mode 100644 SHiNE-server/src/test/java/server/files/PublicFileRangeTest.java diff --git a/SHiNE-server/src/main/java/server/files/PublicFileServlet.java b/SHiNE-server/src/main/java/server/files/PublicFileServlet.java index 6c91db2c..fa9dfef0 100644 --- a/SHiNE-server/src/main/java/server/files/PublicFileServlet.java +++ b/SHiNE-server/src/main/java/server/files/PublicFileServlet.java @@ -14,11 +14,15 @@ import utils.crypto.Ed25519Util; import java.io.IOException; import java.io.InputStream; +import java.nio.ByteBuffer; +import java.nio.channels.FileChannel; import java.io.OutputStream; import java.nio.charset.StandardCharsets; import java.nio.file.AtomicMoveNotSupportedException; import java.nio.file.FileAlreadyExistsException; import java.nio.file.Files; +import java.nio.file.LinkOption; +import java.nio.file.StandardOpenOption; import java.nio.file.Path; import java.nio.file.StandardCopyOption; import java.nio.file.attribute.PosixFilePermission; @@ -37,10 +41,10 @@ import java.util.regex.Pattern; * имя, расширение, MIME или владельца внутри пути файла. Одинаковые байты всех * пользователей дедуплицируются в один объект: data/public-files/. * - * В production GET/HEAD /files/ рекомендуется отдавать Caddy напрямую с - * того же каталога и кэшировать Cloudflare. Этот servlet оставляет GET/HEAD как - * рабочий fallback; PUT всегда проходит через Java, с проверкой session-signature - * и повторным вычислением SHA-256 полученных байтов. + * GET поддерживает HTTP Range для потокового просмотра видео без полной загрузки. + * Проверка SHA-256 выполняется при PUT; GET/HEAD читают метаданные файла без + * повторного хеширования всего содержимого. Caddy также может отдавать immutable + * файлы напрямую, если настроен на корректную выдачу байтовых диапазонов и MIME. */ public final class PublicFileServlet extends HttpServlet { @@ -202,29 +206,118 @@ public final class PublicFileServlet extends HttpServlet { String fileId = extractFileId(req); Path target = fileId == null ? null : safeTarget(fileId); - if (target == null || !Files.isRegularFile(target)) { + // Не следуем по символическим ссылкам: без повторной проверки хеша GET не должен + // иметь возможность прочитать посторонний файл из-за подмены пути. + if (target == null || !Files.isRegularFile(target, LinkOption.NOFOLLOW_LINKS)) { writeError(resp, HttpServletResponse.SC_NOT_FOUND, "FILE_NOT_FOUND", "Файл не найден"); return; } - StoredObjectCheck stored = verifyStoredObject(target, fileId); - if (!stored.valid()) { - Files.deleteIfExists(target); - writeError(resp, HttpServletResponse.SC_NOT_FOUND, "FILE_NOT_FOUND", "Файл не найден"); - return; - } - - resp.setStatus(HttpServletResponse.SC_OK); - resp.setContentType("application/octet-stream"); - resp.setHeader("Content-Length", Long.toString(stored.size())); - resp.setHeader("ETag", "\"" + fileId + "\""); + long size = Files.size(target); + String etag = "\"" + fileId + "\""; + resp.setHeader("ETag", etag); + resp.setHeader("Accept-Ranges", "bytes"); resp.setHeader("Cache-Control", "public, max-age=31536000, immutable"); resp.setHeader("Cross-Origin-Resource-Policy", "cross-origin"); - if (!headOnly) { - try (InputStream in = Files.newInputStream(target); OutputStream out = resp.getOutputStream()) { - in.transferTo(out); + resp.setContentType(detectContentType(target)); + + // По HTTP заголовок Range относится к GET. Для HEAD отдаём обычные + // метаданные целого объекта, что нужно в том числе проверке вложений в UI. + String rangeHeader = headOnly ? null : req.getHeader("Range"); + String ifRange = req.getHeader("If-Range"); + if (rangeHeader != null && ifRange != null && !ifRange.trim().equals(etag)) { + rangeHeader = null; // неподтверждённая версия: отправляем обычный 200 + } + ByteRange range = null; + if (rangeHeader != null) { + range = parseSingleRange(rangeHeader, size); + if (range == null) { + resp.setStatus(HttpServletResponse.SC_REQUESTED_RANGE_NOT_SATISFIABLE); + resp.setHeader("Content-Range", "bytes */" + size); + resp.setHeader("Content-Length", "0"); + return; } } + + long firstByte = range == null ? 0L : range.start(); + long byteCount = range == null ? size : range.length(); + resp.setStatus(range == null ? HttpServletResponse.SC_OK : HttpServletResponse.SC_PARTIAL_CONTENT); + resp.setHeader("Content-Length", Long.toString(byteCount)); + if (range != null) resp.setHeader("Content-Range", "bytes " + range.start() + "-" + range.end() + "/" + size); + if (headOnly || byteCount == 0) return; + + // Файловый канал позиционируется в начале запрошенного участка — не читаем + // все предыдущие байты и не буферизуем видео целиком в памяти. + try (FileChannel channel = FileChannel.open(target, StandardOpenOption.READ, LinkOption.NOFOLLOW_LINKS)) { + channel.position(firstByte); + OutputStream out = resp.getOutputStream(); + byte[] buffer = new byte[64 * 1024]; + long remaining = byteCount; + while (remaining > 0) { + ByteBuffer chunk = ByteBuffer.wrap(buffer, 0, (int) Math.min(buffer.length, remaining)); + int read = channel.read(chunk); + if (read < 0) break; // файл мог быть удалён/усечён во время чтения + if (read == 0) continue; + out.write(buffer, 0, read); + remaining -= read; + } + } + } + + // Поддерживается один диапазон (стандартные запросы браузерных