srt_proxy_connect_timeout
Директива srt_proxy_connect_timeout задаёт максимальное время ожидания установления соединения при проксировании SRT-потоков.
Описание
Директива srt_proxy_connect_timeout задаёт таймаут на установление соединения с восходящим (upstream) сервером в контексте проксирования SRT (Secure Reliable Transport). Когда SRT-поток проксируется, если соединение с назначением не удаётся установить в течение указанного периода ожидания, NGINX прекращает попытки подключения и записывает ошибку в журнал. Это важно для минимизации времени простоя и предотвращения бесконечного ожидания со стороны NGINX при попытках достучаться до недоступного сервиса. Аргумент этой директивы — целое число, указывающее таймаут в секундах.
Эта директива особенно полезна в сценариях, когда бэкенд‑серверы SRT могут отвечать медленно или быть временно недоступны. Установка разумного значения помогает избежать истощения ресурсов на стороне NGINX, обеспечивает своевременную обработку ошибок и даёт возможность применять альтернативную логику маршрутизации. Следует внимательно подбирать значение: слишком короткий таймаут может привести к частым ошибкам соединения в нормальных условиях, тогда как слишком длинный может задерживать обработку ошибок при отказах.
В рамках хороших практик при использовании этой директивы рекомендуется мониторить фактическое поведение соединений и соответствующим образом корректировать таймаут, поскольку различные сетевые условия и производительность серверов могут существенно влиять на время установления соединения.
Пример конфига
stream {
server {
listen 4321;
srt_proxy_pass srt://127.0.0.1:5678;
srt_proxy_connect_timeout 30;
}
}Установка слишком короткого таймаута может привести к тому, что попытки подключения будут часто завершаться неудачей, даже если сервер доступен, но отвечает дольше.
Если не задано, значение таймаута по умолчанию может привести к неожиданным задержкам, если upstream-сервер медленно устанавливает соединение.