ADR-012: именованные сборки (zip) рядом с номерными — /sol/; ^~ для служебных путей; два дефекта сборки фронтендера

tools/proxmox-nginx/game.nginx.conf

@@ -1,12 +1,14 @@
 # nginx для раздачи Unity-сборок «Бинарной ракеты» — LXC 152 (game-web, 192.168.76.152)
 # Файл: /etc/nginx/sites-available/game
 #
-# Модель версионирования:
-#   /opt/game/releases/<N>/           — файлы сборки N (Build/, TemplateData/, index.html)
+# Модель версионирования (два вида сборок, живут рядом):
+#   /opt/game/releases/<N>/     — номерные релизы (1, 2, 3, … 29) из CI/реестра
+#   /opt/game/releases/<имя>/   — именованные сборки (например `sol`), присланные zip'ом
 #   /opt/game/current -> releases/<N> — активная сборка (симлинк, переключает publish-release.sh)
 #
 #   https://smart-updown.binom.pw/            -> 302 на активную сборку (/29/)
-#   https://smart-updown.binom.pw/29/         -> конкретная сборка 29
+#   https://smart-updown.binom.pw/29/         -> номерная сборка 29
+#   https://smart-updown.binom.pw/sol/        -> именованная сборка `sol`
 #   https://smart-updown.binom.pw/29/Build/WebGL.data -> ассет сборки 29
 #
 # ⚠️ ПОЧЕМУ КОРЕНЬ РЕДИРЕКТИТ, А НЕ ОТДАЁТ ФАЙЛЫ:
@@ -18,16 +20,20 @@
 # просто перестаёт использоваться, и `immutable` становится корректным.
 # Номер активной сборки пишет publish-release.sh в отдельный include-файл /etc/nginx/game-active.inc.
 #
+# ⚠️ ПОРЯДОК LOCATION. Служебные пути (/api, /ws, /solana-rpc) объявлены с префиксом `^~`,
+# потому что regex-локейшн сборок `^/(?<build>…)` иначе перехватил бы их (regex в nginx
+# приоритетнее обычного префикса). `^~` подавляет проверку regex для этого префикса.
+#
 # API и WebSocket nginx НЕ обслуживает: их забирает Traefik на VDS
 # (router smart-updown-api: PathPrefix /api,/ws -> куб 192.168.76.120).
 # Локальные location /api, /ws, /solana-rpc — страховка для запросов,
 # которые всё же дойдут до nginx (прямой заход по IP, старые сборки).
 
-# Ассеты Unity внутри каталога версии неизменяемы -> immutable.
-# Всё, что НЕ под номером сборки, и index.html -> no-store.
+# Ассеты Unity внутри НОМЕРНОГО каталога неизменяемы -> immutable.
+# Всё остальное (включая именованные сборки: их папку могут перезалить) -> no-store.
 map $uri $game_cache_control {
     default                                                       "no-store";
-    ~^/[0-9]+/.+\.(js|wasm|data|mem|symbols|css|png|jpg|jpeg|gif|svg|woff2?)$  "public, max-age=604800, immutable";
+    ~^/[0-9]+/.+\.(js|wasm|data|mem|symbols|css|png|jpg|jpeg|gif|svg|woff2?|unityweb)$  "public, max-age=604800, immutable";
 }
 
 server {
@@ -51,18 +57,11 @@ server {
     # Файл переписывает publish-release.sh при --activate.
     include /etc/nginx/game-active.inc;
 
-    # --- версионированные сборки: /<число>/... -------------------------------
-    # /29/index.html -> /opt/game/releases/29/index.html
-    location ~ ^/(?<build>[0-9]+)(?<subpath>/.*)?$ {
-        root /opt/game/releases;
-        try_files /$build$subpath /$build$subpath/ =404;
-    }
-
-    # --- страховка: API -------------------------------------------------------
+    # --- страховка: API (^~ — приоритетнее regex-локейшна сборок) -------------
     # Нормальный /api идёт мимо nginx (Traefik VDS -> куб). Если запрос всё же
     # пришёл сюда — уходим в куб на k3s-Traefik с правильным Host, дальше
     # ingress smart-updown-api ведёт в шлюз :8895.
-    location /api {
+    location ^~ /api {
         proxy_pass http://192.168.76.120;
         proxy_set_header Host smart-updown.binom.pw;
         proxy_set_header X-Real-IP $remote_addr;
@@ -76,7 +75,7 @@ server {
     }
 
     # --- страховка: WebSocket -------------------------------------------------
-    location /ws {
+    location ^~ /ws {
         proxy_pass http://192.168.76.120;
         proxy_set_header Host smart-updown.binom.pw;
         proxy_set_header X-Real-IP $remote_addr;
@@ -92,10 +91,19 @@ server {
     # --- страховка: Solana RPC -------------------------------------------------
     # /solana-rpc/ НЕ ловится PathPrefix /api на VDS, поэтому уходит в корневой
     # router, т.е. сюда. Старые сборки игры стучатся именно в этот путь.
-    location /solana-rpc/ {
+    location ^~ /solana-rpc/ {
         proxy_pass http://192.168.76.181:8899/;
         proxy_set_header Host $host;
         proxy_http_version 1.1;
         proxy_read_timeout 300s;
     }
+
+    # --- сборки: /<N>/... и /<имя>/... ---------------------------------------
+    # /29/index.html      -> /opt/game/releases/29/index.html
+    # /sol/index.html     -> /opt/game/releases/sol/index.html
+    # /29/Build/WebGL.data -> /opt/game/releases/29/Build/WebGL.data
+    location ~ ^/(?<build>[a-zA-Z0-9][a-zA-Z0-9_-]*)(?<subpath>/.*)?$ {
+        root /opt/game/releases;
+        try_files /$build$subpath /$build$subpath/ =404;
+    }
 }