HHostingByteSoftware
Ctrl K
ComunidadGuías…

README.ko.md

Rama main · réplica de lectura del repositorio original.

Archivo original ↗Preguntar a KiBot
<p align="center">
  <img src="docs/assets/producthunt-thumbnail.png" alt="Channel Vault NAS 로고" width="112" height="112">
</p>

<h1 align="center">Channel Vault NAS</h1>

<p align="center">
  <a href="README.md">English</a> · <strong>한국어</strong>
</p>

<p align="center">
  <strong>YouTube 채널을 복구 가능한 NAS 아카이브로 만드세요.</strong><br>
  채널 URL을 붙여넣으면 기존 파일과 <code>archive.txt</code>를 재사용하고,
  없는 영상만 내려받으며 새 영상도 <code>yt-dlp</code>로 계속 백업합니다.
</p>

<p align="center">
  <a href="https://github.com/hyeonsangjeon/channel-vault-nas/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/hyeonsangjeon/channel-vault-nas/actions/workflows/ci.yml/badge.svg"></a>
  <a href="https://github.com/hyeonsangjeon/channel-vault-nas/releases"><img alt="릴리스" src="https://img.shields.io/github/v/release/hyeonsangjeon/channel-vault-nas?include_prereleases&label=release"></a>
  <a href="https://hub.docker.com/r/modenaf360/channel-vault-nas-api"><img alt="Docker pulls" src="https://img.shields.io/docker/pulls/modenaf360/channel-vault-nas-api?logo=docker&label=pulls"></a>
  <a href="LICENSE"><img alt="MIT 라이선스" src="https://img.shields.io/github/license/hyeonsangjeon/channel-vault-nas"></a>
</p>

<p align="center">
  <a href="docs/assets/user-manual/ko/01-home.png">
    <img src="docs/assets/user-manual/ko/01-home.png" alt="3단계 자동 백업 흐름을 보여주는 Channel Vault NAS 홈" width="100%">
  </a>
</p>

<p align="center">
  <a href="#빠른-시작"><strong>빠른 시작</strong></a>
  &nbsp;·&nbsp;
  <a href="docs/usage/migrate-existing-archive.ko.md"><strong>기존 아카이브 가져오기</strong></a>
  &nbsp;·&nbsp;
  <a href="https://hyeonsangjeon.github.io/channel-vault-nas/ko/"><strong>한국어 매뉴얼</strong></a>
</p>

## 일반 다운로드 큐가 놓치는 부분

- **기존 아카이브를 유지합니다.** NAS에 있는 영상, 썸네일, 자막,
  `info.json` 사이드카를 다시 받지 않고 색인합니다.
- **`archive.txt`의 판단을 보여줍니다.** 다운로드됨, 없음, 대기, 건너뜀 상태가
  명령행 옵션 안에 숨지 않습니다.
- **원본 목록의 변화를 확인합니다.** 저장한 영상이 원본의 공개 목록에서
  확인되지 않으면 로컬 사본을 보존된 영상으로 표시하고 목록을 내보낼 수 있습니다.
  삭제 여부나 다른 사본의 부재를 증명하지는 않습니다. 기본 조회 범위는 최근
  업로드 최대 500개이며, 시간 기준은 마지막 확인 이후 24시간입니다.
- **디스크에서 복구합니다.** 미디어는 영구 데이터이고 SQLite는 다시 만들 수 있는
  검색용 색인입니다.
- **한 번 설정하고 자동으로 보관합니다.** 간격과 한 번에 받을 영상 수를 고르고,
  같은 채널 화면에서 자동 백업을 시작하거나 일시정지합니다.

7년 전 공개한
[`youtube-dl-nas`](https://github.com/hyeonsangjeon/youtube-dl-nas)의 제작자가,
일회성 URL 다운로드가 아닌 장기 채널 아카이브를 위해 새로 만들었습니다.

## 나에게 맞을까요?

Channel Vault는 미디어 재생기가 아니라 **아카이브 운영 콘솔**입니다. 이미 NAS
폴더나 `archive.txt`가 있고, 모든 다운로드·건너뜀·누락 판단을 눈으로 확인하며
디스크에서 복구하고 싶을 때 가장 잘 맞습니다.

| 이런 게 필요하다면 | 이 도구부터 |
| --- | --- |
| 재생과 큰 커뮤니티를 갖춘 완성형 미디어 서버 | [TubeArchivist](https://github.com/tubearchivist/tubearchivist) |
| 단순하고 성숙한 구독 다운로더 | [Pinchflat](https://github.com/kieraneglin/pinchflat) |
| **기존 미디어를 재사용하고 `archive.txt` 판단을 보여주며, 원본 목록에서 확인되지 않는 저장 영상을 알려주는 디스크 우선 채널 아카이빙** | **Channel Vault NAS** |

자세한 비교: [나에게 맞을까요?](docs/about/comparison.ko.md)

## 빠른 시작

Channel Vault NAS는 **컨테이너 두 개**로 동작합니다 — `channel-vault-nas-api`
(백엔드)와 `channel-vault-nas-web`(UI). 하나로 합친 단일 이미지는 없으며, 아래
명령이 **두 이미지를 모두** 내려받아 함께 실행합니다. 저장소를 clone하거나
이미지를 직접 빌드할 필요가 없습니다.

```bash
mkdir channel-vault-nas && cd channel-vault-nas
curl -fsSLO https://raw.githubusercontent.com/hyeonsangjeon/channel-vault-nas/main/compose.release.yml
docker compose -f compose.release.yml up -d
```

구형 Synology Docker 패키지에서는 `docker compose` 대신 `docker-compose`를
사용하세요. 릴리스 파일은 Compose v2와 레거시 Compose 1.28.5에서 모두
검증했습니다.

NAS에 설치했다면 컴퓨터 브라우저에서 **`http://<NAS-IP>:5173/`**을 여세요.
Docker와 브라우저를 같은 컴퓨터에서 실행할 때만 **`http://127.0.0.1:5173/`**을
사용합니다. `CVN_WEB_PORT`를 바꿨다면 `5173`도 해당 포트로 바꾸세요. 다음으로:

1. **홈**에서 **채널 등록**을 누르고 URL 또는 `@handle`을 붙여넣은 뒤
   **채널 확인**을 누릅니다.
2. 확인된 채널 이름과 주소가 맞으면 **채널 등록**을 누릅니다.
3. 간격과 한 번에 받을 영상 수를 고르고 **자동 백업 시작**을 누른 뒤,
   같은 화면에서 자동 백업이 켜졌는지 확인합니다.

백업 진행 상태는 **확인한 영상** 기준이며, 채널 전체를 조회했다는 뜻은 아닙니다.
한 번에 `CVN_CHANNEL_PROBE_VIDEO_LIMIT`개(기본 `500`)까지 조회합니다. 소스 목록에
없고 로컬 파일도 없는 영상은 백업 완료에 포함하지 않습니다.

이미 파일이나 `archive.txt`가 있다면 자동 백업 전에 [기존 아카이브
가져오기](docs/usage/migrate-existing-archive.ko.md)를 따라 하세요. 기존 영상을
먼저 색인하므로 불필요한 재다운로드를 피할 수 있습니다.

Synology/QNAP 설치는 [한국어 NAS 설치
가이드](https://hyeonsangjeon.github.io/channel-vault-nas/ko/install/nas/)를,
확인된 환경은 [호환성 표](docs/install/compatibility.ko.md)를 참고하세요.

> 이 셀프 호스팅 릴리스는 localhost, 사설 LAN, VPN, 또는 신뢰할 수 있는 리버스
> 프록시용입니다. 공개 인터넷에 그대로 노출하지 마세요.

## 화면

| 오늘의 아카이브 상태 | 자동 백업 |
| --- | --- |
| ![간단한 홈 화면](docs/assets/screenshots/home.png) | ![채널 자동 백업](docs/assets/screenshots/channel-downloads.png) |

| 채널 등록 | 기존 아카이브 가져오기 |
| --- | --- |
| ![채널 등록](docs/assets/screenshots/channel-registration.png) | ![NAS 폴더와 archive.txt 가져오기](docs/assets/screenshots/existing-archive-import.png) |

## 현재 지원 범위

**알파를 벗어나 활발히 개발 중이며, 현재 릴리스는 0.3.1입니다.** 기본 화면은 홈·채널·저장한
영상·설정에 집중하고, 큐 점검과 저장소 진단, 런타임 제어는 필요할 때 열어보는
고급 관리로 정리했습니다.

- 채널 등록과 메타데이터 동기화
- 새 영상 후보 생성과 자동 다운로드 일정
- 이미 받은 영상 건너뜀과 `archive.txt` 가져오기
- 실제 `yt-dlp` 다운로드, 재시도, 취소, 실행 기록
- 미디어·썸네일·자막·사이드카 라이브러리 색인
- NAS 저장소 스캔, 드리프트와 고아 사이드카 확인
- Docker Hub/GHCR의 `amd64`·`arm64` 이미지
- 한국어·영어 매뉴얼과 5개 UI 언어

아직 다중 사용자 계정과 지원되는 쿠키/비공개 영상 흐름은 없습니다. 저작권과
서비스 이용약관을 준수하고, 소유하거나 보관 권한이 있는 콘텐츠에 사용하세요.

## 링크

- [한국어 사용 매뉴얼](https://hyeonsangjeon.github.io/channel-vault-nas/ko/)
- [Docker Hub API 이미지](https://hub.docker.com/r/modenaf360/channel-vault-nas-api)
- [Docker Hub Web 이미지](https://hub.docker.com/r/modenaf360/channel-vault-nas-web)
- [릴리스](https://github.com/hyeonsangjeon/channel-vault-nas/releases)
- [NAS 호환성 리포트](https://github.com/hyeonsangjeon/channel-vault-nas/discussions/7)
- [비교: 나에게 맞을까요?](docs/about/comparison.ko.md)
- [MIT License](LICENSE)