Утилита, которая через временный docker-контейнер скачивает YouTube видео. Можно собрать и локальный бинарник, но тогда внешние зависимости будут тоже локально запускаться - а это риск безопасности. Поэтому лучше через изолированный контейнер :-)
  • Go 70.3%
  • Dockerfile 12.5%
  • Batchfile 8.7%
  • Shell 8.5%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-10 16:44:31 +03:00
.dockerignore Initial commit 2026-10-11 15:28:59 +03:00
.gitignore Initial commit 2026-10-11 15:28:59 +03:00
docker-compose.yml Initial commit 2026-10-11 15:28:59 +03:00
Dockerfile Fix YouTube bot check: install yt-dlp-ejs to solve n-challenge 2026-11-10 03:57:04 +03:00
go.mod Initial commit 2026-10-11 15:28:59 +03:00
main.go Fix YouTube bot check: install yt-dlp-ejs to solve n-challenge 2026-11-10 03:57:04 +03:00
README.md Добавлен раздел и описание проблемы "YouTube просит залогиниться" 2026-11-10 16:44:31 +03:00
yt.cmd Fix yt.cmd 2026-11-10 03:57:46 +03:00
yt.sh Initial commit 2026-10-11 15:28:59 +03:00

youtube-downloader

Скачивание видео с YouTube по ссылке. Все зависимости собираются и запускаются внутри изолированного docker-контейнера, чтобы не тащить их в операционную систему компьютера.

Подготовка

  1. Установить Docker Desktop: https://docs.docker.com/get-started/get-docker/

  2. В Windows если Docker Desktop сам не предложит установить WSL 2, то установить вручную по инструкции: https://docs.docker.com/desktop/features/wsl/

  3. Выбрать директорию, где будет лежать утилита, и скачать (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-репозитория в неё.

  4. Добавить директорию с файлами проекта (youtube-downloader - где лежат файлы yt.cmd и yt.sh) в PATH в системе, чтобы можно было запускать скачку из любой директории в консоли. После правки PATH откройте новый терминал.

  5. Собрать образ контейнера:

    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. Что делать:

  1. Смените IP: домашний интернет или VPN. IP адресов VPS и дата-центров YouTube блокирует чаще всего — в одном из случаев скачивание заработало после переключения с VPS на VPN с ирландским IP.

  2. Если запуск идёт с VPS, направьте трафик через прокси с «живым» IP:

    yt -x "--proxy,socks5://host.docker.internal:1080" "https://youtu.be/VIDEO_ID"
    

    В клиенте прокси включите «разрешить подключения из локальной сети».

  3. Передайте cookies из браузера, где вы залогинены в YouTube, — см. раздел «Возрастные/приватные видео». Cookies снимают проверку для возрастных и приватных видео, но против антибот-фильтра по IP помогают не всегда.

  4. Если 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 — это снимает всю изоляцию.