- Go 70.3%
- Dockerfile 12.5%
- Batchfile 8.7%
- Shell 8.5%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| .dockerignore | ||
| .gitignore | ||
| docker-compose.yml | ||
| Dockerfile | ||
| go.mod | ||
| main.go | ||
| README.md | ||
| yt.cmd | ||
| yt.sh | ||
youtube-downloader
Скачивание видео с YouTube по ссылке. Все зависимости собираются и запускаются внутри изолированного docker-контейнера, чтобы не тащить их в операционную систему компьютера.
Подготовка
-
Установить Docker Desktop: https://docs.docker.com/get-started/get-docker/
-
В Windows если Docker Desktop сам не предложит установить WSL 2, то установить вручную по инструкции: https://docs.docker.com/desktop/features/wsl/
-
Выбрать директорию, где будет лежать утилита, и скачать (https://bitbucket.org/bitsaround/youtube-downloader/src/master/) или склонировать (
git clone git@bitbucket.org:bitsaround/youtube-downloader.git- в windows через программу https://git-scm.com/install/windows) файлы проекта из git-репозитория в неё. -
Добавить директорию с файлами проекта (
youtube-downloader- где лежат файлыyt.cmdиyt.sh) в PATH в системе, чтобы можно было запускать скачку из любой директории в консоли. После правки PATH откройте новый терминал. -
Собрать образ контейнера:
cd youtube-downloader docker build -t yt-get:latest .Скрипты
yt.cmdиyt.shсами собирают образ, если он ещё не существует, так что шаг 5 можно пропустить — он нужен, только если образ нужен заранее.
Запуск
Наличие скриптов yt.sh (Git Bash / WSL) и yt.cmd (Windows shell) в PATH позволяет запускать скрипт скачки из консоли из любой директории:
-
Windows (через
cmdилиPowerShell):yt -q 1080 https://youtu.be/VIDEO_ID -
Linux:
yt -q 1080 "https://youtu.be/VIDEO_ID"
Скрипты запускают контейнер с текущим рабочим каталогом, поэтому файлы сохраняются в тот каталог, из которого вызвана команда.
Для безопасности запускайте
ytиз отдельной папки для загружаемых видео, а не, например, из домашнего каталога — всё содержимое директории запуска доступно внешним зависимостиям, запускаемым в контейнере.
Несколько ссылок
Ссылки можно передать аргументами — скачаются все по очереди с прогрессом [1/3] готово::
yt -q 1080 "https://youtu.be/ID1" "https://youtu.be/ID2" "https://youtu.be/ID3"
Можно сохранить список в текстовой файл и запустить скачку по этому списку:
yt -q 1080 < links.txt # Git Bash / WSL
Get-Content links.txt | yt -q 1080 # PowerShell
Если хотя бы одна ссылка не удалась, команда всё равно скачает остальные и завершится с ненулевым кодом возврата.
Флаги
| Флаг | Назначение |
|---|---|
-q PRESET |
пресет качества: best, 2160, 1440, 1080, 720, 480, 360, audio, mp3 |
--out DIR |
каталог сохранения (по умолчанию downloads, относительно рабочего каталога контейнера) |
-f FORMAT |
формат, синтаксис yt-dlp (по умолчанию bestvideo*+bestaudio/best) |
--max HEIGHT |
ограничить высоту, например --max 1080 |
--list |
показать доступные форматы, ничего не качать |
-x "arg1,arg2" |
дополнительные аргументы yt-dlp через запятую |
Указывать нужно что-то одно: -q, -f или --max.
Имя файла формируется как <название> [<id>].<расширение> — скобки с id защищают от совпадений с уже скачанным видео.
Скачивается только само видео, а не плейлист: если дать ссылку на плейлист, скачается первое
видео из него. Для остальных используйте -x с ключом --yes-playlist.
Про звук в пресетах
| Пресет | Звук |
|---|---|
| видео-пресеты | bestaudio — лучший доступный поток без перекодирования (обычно Opus/AAC ~128 кбит/с) |
audio |
bestaudio/best — только звук как есть, без перекодирования; расширение исходное (.webm/.m4a) |
mp3 |
тот же поток, перекодируется ffmpeg в mp3 V0 (~240 кбит/с) |
Перекодирование в mp3 качества не добавляет — исходник ~128 кбит/с, файл только тяжелее.
Свой битрейт: -x "--audio-format,mp3,--audio-quality,320K".
Видео-пресеты склеивают в mp4, аудиокодек при этом может остаться Opus — плееры
вроде iOS/QuickTime такой mp4 не всегда открывают. Строгий mp4 с AAC:
-x "--remux-video,mp4".
Пример: только аудио, ограничение 10 минут.
docker compose run --rm yt-get -q mp3 -x "--match-filter,duration < 600" "https://youtu.be/VIDEO_ID"
Прямой запуск через docker
В обход shell-скриптов:
docker run --rm -i --read-only --tmpfs /tmp --cap-drop ALL \
--security-opt no-new-privileges -e HOME=/tmp \
-v "$(pwd -W)/:/downloads" yt-get:latest --out /downloads "https://youtu.be/VIDEO_ID"
В Git Bash добавьте
MSYS_NO_PATHCONV=1передdocker run, иначе путь/downloadsбудет преобразован в путь Windows.$(pwd -W)тоже работает только в Git Bash — в обычном Linux используйте$(pwd).
Короткая альтернатива через docker compose (тоже монтирует ./downloads, пути не преобразуются):
docker compose run --rm yt-get "https://youtu.be/VIDEO_ID"
Возрастные/приватные видео
Примонтируйте файл cookies (экспорт из браузера через расширение «Get cookies.txt LOCALLY»)
и передайте --cookies.
Через yt отдельный монтаж не нужен: каталог, из которого вызвана команда, уже доступен
внутри контейнера как /downloads. Положите cookies.txt рядом с собой и укажите
именно этот путь:
yt -q 1080 -x "--cookies,/downloads/cookies.txt" "https://youtu.be/VIDEO_ID"
Через docker compose монтируется только ./downloads, поэтому cookies.txt нужно
смонтировать отдельно:
services:
yt-get:
volumes:
- ./downloads:/downloads
- ./cookies.txt:/cookies.txt:ro
и вызвать без лишних путей:
docker compose run --rm yt-get -q 1080 -x "--cookies,/cookies.txt" "https://youtu.be/VIDEO_ID"
Файл cookies.txt в .gitignore, случайно его не закоммитите.
Troubleshooting
Не скачивается: «Sign in to confirm you're not a bot»
Симптом: ERROR: [youtube] ... Sign in to confirm you're not a bot, а обёртка печатает
ОШИБКА <url>: exit status 1 — это лишь код возврата yt-dlp, причина в строке выше.
Проверку выдаёт YouTube не на видео, а на сам запрос: на одном IP видео скачивается, на другом — нет. Причин две: IP с плохой репутацией (чаще всего VPS или дата-центр) и не решённая JS-проверка (n-challenge) из-за устаревшего образа.
Шаг 1. Узнайте IP, с которого идёт контейнер. Он может отличаться от IP в браузере, потому что Docker не использует системный прокси Windows:
docker run --rm --entrypoint curl yt-get:latest -s https://api.ipify.org
Шаг 2. Посмотрите подробный лог:
docker run --rm --entrypoint=yt-dlp yt-get:latest -v --remote-components ejs:github --list-formats "https://youtu.be/VIDEO_ID"
- В логе есть
[youtube] [jsc:deno] Solving JS challenges using denoи таблица форматов — с видео всё в порядке. - В логе
playability status: LOGIN_REQUIREDи строки про solving нет — YouTube отклонил запрос ещё до JS-проверки, дело в IP.
Шаг 3. Что делать:
-
Смените IP: домашний интернет или VPN. IP адресов VPS и дата-центров YouTube блокирует чаще всего — в одном из случаев скачивание заработало после переключения с VPS на VPN с ирландским IP.
-
Если запуск идёт с VPS, направьте трафик через прокси с «живым» IP:
yt -x "--proxy,socks5://host.docker.internal:1080" "https://youtu.be/VIDEO_ID"В клиенте прокси включите «разрешить подключения из локальной сети».
-
Передайте cookies из браузера, где вы залогинены в YouTube, — см. раздел «Возрастные/приватные видео». Cookies снимают проверку для возрастных и приватных видео, но против антибот-фильтра по IP помогают не всегда.
-
Если IP в порядке, а JS-проверка не решается — пересоберите образ, чтобы обновить
yt-dlpиyt-dlp-ejs:docker build -t yt-get:latest .Скрипты
yt.cmdиyt.shсобирают образ, только если его ещё нет, поэтому после изменения Dockerfile образ нужно пересобрать вручную.
После смены IP проверьте той же командой из шага 1, что адрес действительно изменился.
Технические подробности
Этот проект — тонкая CLI-обёртка на языке Go, которая запускает yt-dlp + ffmpeg
внутри docker-контейнера, файлы сохраняются в смонтированную папку на хосте.
В образе также стоят python3, curl, Deno — JS-рантайм, который yt-dlp использует
для разбора защитных проверок YouTube, и пакет yt-dlp-ejs с их скриптом.
У контейнера заданы read_only, cap_drop: ALL, no-new-privileges и tmpfs для /tmp.
Граница изоляции — это смонтированный в контейнер каталог:
- скрипты
ytмонтируют текущий рабочий каталог (он становится/downloads); docker composeмонтирует каталог./downloadsпроекта.
Контейнер не может даже при полной компроментации yt-dlp: менять файлы хоста вне точки монтирования, ставить ПО, видеть процессы хоста. Что может: писать в примонтированный каталог и ходить в интернет.
Никогда не монтируйте docker.sock — это снимает всю изоляцию.