Support a proxy for networks where YouTube is unreachable

YTDLP_PROXY routes every yt-dlp call — search, metadata and the audio
stream, for YouTube and SoundCloud alike — through an http(s) or SOCKS
proxy such as a local Psiphon. Startup logs which proxy is in use with
any credentials stripped.

ffmpeg has no SOCKS support, so with a proxy configured playback always
goes through the yt-dlp pipe instead of a resolved CDN URL: nothing
escapes past the proxy, at the cost of slower seeking. Direct links keep
using ffmpeg, which gets the proxy only when it speaks http(s).

Verified against a dead proxy: requests fail through it rather than
quietly going direct.

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

.env.example

@@ -40,6 +40,18 @@ YTDLP_PATH=yt-dlp
 # Подробности — в README, раздел «Учётка YouTube (cookies)».
 # YTDLP_COOKIES=/data/cookies.txt
 
+# Необязательно: прокси для всех запросов yt-dlp — YouTube и SoundCloud,
+# поиск, метаданные и сам аудиопоток. Пригодится, когда из сети сервера
+# YouTube недоступен (Psiphon, свой SOCKS и т.п.).
+# Схемы: http://, https://, socks5:// и socks5h:// (socks5h резолвит DNS на
+# стороне прокси — обычно нужен именно он). Можно с логином и паролем:
+# socks5h://user:pass@host:1080
+# YTDLP_PROXY=socks5h://127.0.0.1:1080
+#
+# Внимание: 127.0.0.1 внутри контейнера — это сам контейнер. Если прокси поднят
+# на хосте, используйте socks5h://host.docker.internal:1080 и добавьте в
+# compose.yml к extra_hosts строку "host.docker.internal:host-gateway".
+
 # Необязательно: дополнительные --extractor-args, через ";".
 # Помогает, когда YouTube не отдаёт форматы серверному IP:
 # YTDLP_EXTRACTOR_ARGS=youtube:player_client=default,web_safari