fix

docs/ssh-core-tunnel.md

@@ -194,6 +194,24 @@ VMANGOS_CHARACTERS_DB_PASSWORD="ПАРОЛЬ_БД_ЯДРА"
 
 ## 4. Запуск на веб-сервере
 
+Для полного деплоя используйте обновлённый скрипт:
+
+```bash
+./scripts/deploy-production.sh --ssh-tunnel
+```
+
+Флаг добавляет файл туннеля во все production-команды Compose, собирает и
+запускает SSH-контейнер, ждёт его `healthy`, затем проверяет обе БД через
+`SELECT 1` перед миграциями. Если `VMANGOS_AUTH_DB_HOST` либо
+`VMANGOS_CHARACTERS_DB_HOST` уже равен `core-db-tunnel`, режим включается
+автоматически. Файл туннеля задаёт адреса и порты БД приложения независимо
+от устаревших `*_DB_HOST=db` в `.env`; имена баз и учётные данные берутся из `.env`.
+Удалите `VMANGOS_*_DB_URL`, чтобы они не переопределяли адрес подключения.
+Предупреждение про `stalwart` относится к отдельному `compose.mail.yaml`;
+скрипт не удаляет orphan-контейнеры.
+
+Команды ниже позволяют запустить и проверить туннель отдельно от полного деплоя.
+
 Из папки `moonwell-web`:
 
 ```bash