Question 1

왜 내 yt-dlp 출력 경로에 'mp4_' 폴더 접두사가 추가될까요?

Accepted Answer

이 버그는 yt-dlp 버전 2025.08.22에서 발생했으며, `--output` 템플릿 사용 시 파일 형식(예: `mp4`)이 출력 디렉터리에 잘못 앞에 붙는 문제였습니다. 문제가 있는 기능이 되돌려진 최신 릴리스나 Docker 이미지로 업데이트하십시오.

썸네일 파일명(예: `mp4_thumbnail.jpg`)에서 여전히 문제가 발생한다면 최신 버전인지 확인하십시오. Docker의 경우:

```bash
docker pull mikenye/yt-dlp:latest
```

수동 해결 방법은 필요 없으며, 업그레이드만 하면 됩니다.

Question 2

2026.04.10으로 업그레이드 후 MeTube 브라우저 확장 프로그램이 작동하지 않는 문제를 해결하는 방법?

Accepted Answer

버전 2026.04.10에서는 엄격한 `CORS_ALLOWED_ORIGINS` 요구 사항이 도입되어 브라우저 확장 프로그램이 작동하지 않게 되었습니다. 해결하려면 MeTube 2026.04.13(이상)으로 업그레이드하고 `CORS_ALLOWED_ORIGINS`를 `*`로 설정하세요:

**Docker run**
```bash
docker run -d -p 8080:8080 -e CORS_ALLOWED_ORIGINS='*' alexta69/metube:2026.04.13
```

**Docker Compose**
```yaml
environment:
  CORS_ALLOWED_ORIGINS: '*'
```

이렇게 하면 리버스 프록시 없이도 확장 프로그램 기능이 복원됩니다. 업그레이드할 수 없는 경우 임시 해결 방법으로 2026.04.09로 다운그레이드하세요.

Question 3

MeTube가 Clip start 또는 Clip end를 사용할 때 오디오는 정상 작동하는데 검은색 또는 빈 비디오 트랙을 생성하는 이유는 무엇인가요?

Accepted Answer

이것은 MeTube가 컷 지점에서 keyframes를 강제하지 않은 채 download_sections/download_ranges를 yt-dlp에 전달하기 때문에 발생합니다. 그러면 트리밍된 VP9/H.264 비디오에는 디코딩 가능한 프레임이 전혀 없을 수 있는 반면, Opus/AAC 오디오는 여전히 유효합니다.

임시 해결 방법: MeTube의 YTDL_OPTIONS에 force_keyframes_at_cuts를 추가하고 컨테이너를 다시 시작하세요:

environment:
  YTDL_OPTIONS: '{"format": "bv*+ba/b", "merge_output_format": "mp4", "force_keyframes_at_cuts": true}'

동등한 yt-dlp 동작:

yt-dlp -f "bv*+ba/b" --merge-output-format mp4 \
  --download-sections "*0:00-0:20" \
  --force-keyframes-at-cuts \
  'https://www.youtube.com/watch?v=H8g4B5ZN7LM'

영구적인 수정은 MeTube가 clip_start 또는 clip_end가 사용될 때마다 force_keyframes_at_cuts를 자동으로 설정하는 것입니다. 이슈 #1092에 대한 수정이 포함된 릴리스로 업그레이드하세요.

Question 4

yt-dlp가 성공적으로 저장했음에도 불구하고 MeTube WebUI에서 완료된 비디오를 다운로드할 때 "file not found"가 표시되는 이유는 무엇인가요?

Accepted Answer

이 문제는 `PUBLIC_HOST_URL` 또는 `PUBLIC_HOST_AUDIO_URL`이 실제로 다운로드 디렉터리를 제공하고 있지 않은 URL을 가리킬 때 발생합니다. `docker-compose.yml`에서 두 설정을 모두 제거하세요:

```yaml
# 다음 줄을 삭제하세요:
PUBLIC_HOST_URL: video/
PUBLIC_HOST_AUDIO_URL: audio/
```

그런 다음 컨테이너를 다시 생성하세요:

```bash
docker compose up -d --force-recreate
```

기본적으로 MeTube는 자체 URL을 통해 완료된 파일을 제공하므로, 다운로드 디렉터리를 별도의 웹 서버에서 호스팅하는 경우가 아니라면 이 변수들은 필요하지 않습니다. 이 변수들을 사용하는 경우에는 외부에서 접근 가능한 기본 URL(예: `https://downloads.example.com/video/`)로 설정하세요.

Question 5

MeTube가 다운로드할 때마다 새 폴더를 생성하는 이유는 무엇이며, 이를 어떻게 막을 수 있나요?

Accepted Answer

이는 MeTube 2026.02.07의 회귀 문제로, `CUSTOM_DIRS=false` 및 `CREATE_CUSTOM_DIRS=false`로 설정되어 있어도 다운로드별 폴더가 생성되었습니다. 동일한 이미지 태그를 다시 가져오고 컨테이너를 재생성하여 재빌드된 릴리스로 업데이트하세요:

```bash
docker compose pull
docker compose up -d
```

일반 Docker를 사용하는 경우:

```bash
docker pull alexta69/metube:2026.02.07
```

그런 다음 기존 컨테이너를 중지 및 제거하고 다시 시작하세요. 환경에 다음이 포함되어 있는지 확인하세요:

```yaml
CUSTOM_DIRS=false
CREATE_CUSTOM_DIRS=false
```

업데이트 후에는 다운로드가 `DOWNLOAD_DIR`로 바로 저장되고 `OUTPUT_TEMPLATE`이 정상적으로 작동합니다. 이미 남아 있는 빈 폴더는 자동으로 제거되지 않으므로 필요한 경우 수동으로 삭제하세요.

MeTube

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트