Правки локального размещения дева, перенос тунеля в контейнер

docker-compose.test.yml

@@ -1,11 +1,10 @@
 # Локальный «клон прода» в контейнере — для проверки прод-сборки на своей машине
-# (а не на Raspberry Pi). Тот же образ, что и прод, но изолированные тома, единый .env
-# и порт 8080 (чтобы не конфликтовать с dev-uvicorn на :8000).
+# (а не на Raspberry Pi). Тот же образ, что и прод, изолированные тома, единый .env.
+# Портов на хост НЕТ: тест виден ТОЛЬКО снаружи на https://forbidden-stars.ru через
+# сервис tunnel (контейнер ssh -R 9001:app:8000 на VPS).
 #
-# Обычно запускается лаунчером при APP_ENV=test (run.ps1 / run.sh). Вручную:
-#   docker compose -f docker-compose.test.yml up --build -d
-# Открыть:  http://localhost:8080   (Swagger: /api/docs)
-# Остановить и стереть данные:  docker compose -f docker-compose.test.yml down -v
+# Запуск (обычно лаунчером при APP_ENV=test):  docker compose -f docker-compose.test.yml up --build -d
+# Остановить и стереть данные:                 docker compose -f docker-compose.test.yml down -v
 services:
   app:
     build: .
@@ -19,8 +18,8 @@ services:
       # Окружение test: прод-клон, но отличимый от прода (см. config.is_test).
       # Форсим здесь, чтобы значение не зависело от APP_ENV внутри .env.
       APP_ENV: test
-    ports:
-      - "8080:8000"
+    # Портов на хост НЕТ: тест доступен только изнутри сети compose; наружу — через
+    # сервис tunnel (ниже) на forbidden-stars.ru. Из LAN/localhost — недоступно.
     volumes:
       - db-data-test:/data            # изолированные тестовые данные
       - uploads-data-test:/data/uploads
@@ -36,6 +35,26 @@ services:
       start_period: 40s
     mem_limit: 512m
 
+  # SSH reverse-туннель к VPS: forbidden-stars.ru (VPS:9001) -> app:8000 (по сети compose).
+  # Ключ — ./deploy/tunnel/id_tunnel (gitignore), pubkey в authorized_keys у tunnel@VPS.
+  # Внимание: слот 9001 общий с dev-туннелем (run.ps1); поднимай что-то одно за раз.
+  tunnel:
+    build: ./deploy/tunnel
+    image: forbidden-stars-tunnel:test
+    restart: unless-stopped
+    init: true
+    depends_on:
+      app:
+        condition: service_healthy
+    environment:
+      VPS_TUNNEL_HOST: ${VPS_TUNNEL_HOST}
+      VPS_TUNNEL_USER: ${VPS_TUNNEL_USER:-tunnel}
+      VPS_TUNNEL_PORT: "9001"          # forbidden-stars.ru (dev/test)
+      UPSTREAM: app:8000
+    volumes:
+      - ./deploy/tunnel/id_tunnel:/key/id_tunnel:ro
+    mem_limit: 64m
+
 volumes:
   db-data-test:
   uploads-data-test: