Run the panel as its own compose project behind the host Caddy

The instance's internal Caddy is only for Stoat itself, so the panel no
longer goes through it: the bot ships its own compose project, publishes
3005 on loopback, and the host's external Caddy gives it a domain.

extra_hosts pins the instance domain to host-gateway, so the bot reaches
the API, gateway and LiveKit through the external proxy with a valid
certificate instead of depending on router NAT loopback. The old
in-project layout stays available as a fallback example, together with a
step-by-step guide for when voice fails to connect.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

deploy/Caddyfile.snippet

@@ -1,15 +1,8 @@
-# Добавьте отдельным блоком в /opt/stoat/Caddyfile, рядом с {$HOSTNAME} { ... }.
-#
-# У вас Caddy слушает только 80 (127.0.0.1:8880 → 80), а TLS терминирует
-# внешний прокси на хосте, поэтому используем схему http:// —
-# так Caddy не будет пытаться сам выпускать сертификат.
-http://music.example.com {
-	reverse_proxy http://mbot:3005
+# Внешний Caddy на хосте: /etc/caddy/Caddyfile
+# Добавьте блок рядом с остальными вашими сайтами.
+music.example.com {
+	reverse_proxy 127.0.0.1:3005
 }
 
-# Если внешнего прокси нет и Caddy сам держит 80/443 — просто:
-# music.example.com {
-# 	reverse_proxy http://mbot:3005
-# }
-#
-# WebSocket (/ws) проксируется автоматически, отдельных директив не нужно.
+# Внутренний Caddy инстанса трогать не нужно: панель к нему не относится.
+# WebSocket (/ws) Caddy апгрейдит сам, отдельных директив не требуется.

deploy/compose.override.yml.example

@@ -1,28 +0,0 @@
-# /opt/stoat/compose.override.yml
-#
-# Раскладка:
-#   /opt/stoat       — ваш self-hosted Stoat (compose.yml, Caddyfile, ...)
-#   /opt/stoat-mbot  — этот репозиторий
-#
-# Сервис живёт в том же compose-проекте, поэтому попадает в сеть stoat_default:
-# Caddy видит его как http://mbot:3005, а бот — Stoat API как http://api:14702.
-services:
-  # ваш существующий override для Caddy — оставьте как есть
-  caddy:
-    ports: !override
-      - "127.0.0.1:8880:80"
-
-  mbot:
-    build: ../stoat-mbot
-    restart: always
-    env_file: ../stoat-mbot/.env
-    depends_on:
-      api:
-        condition: service_started
-    volumes:
-      # cookies.txt для yt-dlp и/или локальная медиатека
-      - ../stoat-mbot/data:/data
-    # Панель отдаётся через Caddy. Порт наружу нужен, только если панель
-    # проксирует внешний nginx на хосте, минуя Caddy:
-    # ports:
-    #   - "127.0.0.1:3005:3005"

deploy/compose.stoat-network.yml.example

@@ -0,0 +1,25 @@
+# Запасной вариант: если по какой-то причине бот должен ходить в Stoat
+# по внутренним именам сервисов, а не через внешний домен.
+#
+# Кладётся в /opt/stoat/compose.override.yml (в дополнение к вашему caddy-блоку),
+# при этом в /opt/stoat-mbot/.env нужно указать STOAT_API_URL=http://api:14702.
+#
+# Минус: LiveKit-URL из join_call всё равно приходит публичным, и его придётся
+# резолвить изнутри сети — поэтому по умолчанию рекомендуется отдельный
+# compose-проект (см. compose.yml в корне репозитория).
+services:
+  caddy:
+    ports: !override
+      - "127.0.0.1:8880:80"
+
+  mbot:
+    build: ../stoat-mbot
+    restart: always
+    env_file: ../stoat-mbot/.env
+    depends_on:
+      api:
+        condition: service_started
+    ports:
+      - "127.0.0.1:3005:3005"
+    volumes:
+      - ../stoat-mbot/data:/data