TubeSync
一个 YouTube 的个人录像机（PVR），自动下载频道/播放列表视频到本地，并更新媒体服务器（类似 Sonarr 但针对 YouTube）。
스마트 다운로드
프로젝트 홈페이지 방문
아직 설치 프로그램이 없습니다 — 소스 저장소로 이동하세요
自动追更 YouTube 频道，像录电视节目一样下载视频到本地。
주요 기능
- 自动同步 YouTube 频道和播放列表
- 支持自定义画质、格式（如 mp4、mkv）
- 内置 yt-dlp + ffmpeg，任务调度自动下载
- 失败自动重试，逐步延长等待时间，非常可靠
- 下载完成后自动更新 Jellyfin / Plex 媒体库
할 수 없는 것
- •必须使用 Docker 运行，不支持直接安装；2. 下载目录需有足够空间（高清视频很大）；3. 如果使用 Samba 卷，务必在挂载参数中指定 uid/gid 与 PUID/PGID 一致，否则可能因权限问题导致元数据写入失败；4. 默认监听 4848 端口，注意防火墙；5. 首次添加源后需要等待一段时间才能开始下载（后台任务定时执行）。
사용 사례
- 想把自己喜欢的 YouTube 频道视频全部下载到本地，离线观看
- 搭建家庭媒体服务器（Jellyfin/Plex），自动追更 YouTube 节目
- 备份某个 YouTube 播放列表或频道，防止视频被删除
TubeSync 是一个专为 YouTube 设计的个人视频录像机（PVR）。它能自动同步你订阅的频道和播放列表，按你指定的画质下载视频，并整理到本地文件夹。底层基于 yt-dlp 和 ffmpeg，提供 Web 界面和任务调度器，自动完成索引、下载、重试（失败后逐步增加等待时间）。下载完成后，可选地更新 Jellyfin 或 Plex 等媒体服务器，让你像追剧一样追 YouTube 内容。以 Docker 容器运行，支持 amd64 和 arm64 架构，配置和下载目录通过挂载卷管理。
태그
시작하기
소프트웨어 설치
다운로드한 설치 프로그램을 더블 클릭하고 안내에 따르세요
步骤1：在 Docker 环境中运行：`docker pull ghcr.io/meeb/tubesync:latest`
步骤2：创建配置和下载目录，并启动容器（参考 README 中的 docker run 命令，注意设置 PUID/PGID 和 TZ）
步骤3：打开 http://localhost:4848，进入 Web 界面，添加 YouTube 频道或播放列表 URL
- 步骤1：在 Docker 环境中运行：`docker pull ghcr.io/meeb/tubesync:latest`
- 步骤2：创建配置和下载目录，并启动容器（参考 README 中的 docker run 命令，注意设置 PUID/PGID 和 TZ）
- 步骤3：打开 http://localhost:4848，进入 Web 界面，添加 YouTube 频道或播放列表 URL
체크섬 없음
이 프로젝트는 GitHub Release 페이지에 SHA-256 체크섬을 게시하지 않았습니다
SHA256 체크섬
체크섬 없음
GitHub Releases에서 직접 다운로드하고 파일 무결성을 직접 확인하세요
이 플랫폼의 모든 SHA-256 체크섬은 프로젝트의 공식 GitHub Release 페이지에서 추출되었으며, 어떠한 변경도 없습니다. GitHub Releases 페이지에서 직접 검증할 수 있습니다.
오픈소스 투명성
GitHub 소스 보기제거 정보
停止并删除容器：`docker stop tubesync && docker rm tubesync`，然后删除挂载的 config 和 downloads 目录即可。
추가 의존성 없음
다운로드 후 바로 사용 가능. 추가 런타임이 필요하지 않습니다.
문제 발생? 아래 FAQ 확인
3 FAQs