Tube Archivist là máy chủ YouTube tự lưu trữ mã nguồn mở giúp bạn tải video, lập chỉ mục toàn văn và xem ngoại tuyến ngay trên hạ tầng riêng – giải pháp cho những ai muốn thoát khỏi sự phụ thuộc nền tảng và quản lý kho nội dung khổng lồ một cách thông minh. Xem chi tiết tại repository GitHub chính thức.
Thank you for reading this post, don't forget to subscribe!Những điểm chính
- Máy chủ YouTube tự lưu trữ giúp bạn tải video từ kênh đăng ký, lưu trữ dài hạn mà không lo bị gỡ bỏ.
- Tìm kiếm toàn văn mạnh mẽ nhờ Elasticsearch, truy xuất video theo tiêu đề, mô tả, phụ đề và bình luận.
- Triển khai nhanh với Docker Compose, tích hợp sẵn Jellyfin, Plex và tiện ích mở rộng trình duyệt.
- Quản lý hàng chờ tải thông minh, tự động quét kênh định kỳ và đánh dấu video đã xem.
- Hoàn toàn mã nguồn mở, cộng đồng tích cực và lộ trình phát triển rõ ràng.
Tube Archivist là gì và giải quyết vấn đề gì?
Tube Archivist là một ứng dụng web chạy trên Docker, cho phép bạn tải xuống video từ YouTube thông qua yt-dlp, sau đó lập chỉ mục toàn bộ siêu dữ liệu – tiêu đề, mô tả, phụ đề, bình luận – vào Elasticsearch. Nhờ đó, bạn có thể tìm kiếm bất kỳ video nào trong bộ sưu tập chỉ bằng vài từ khóa, thay vì phải lục tung thư mục tải về. Vấn đề cốt lõi mà dự án giải quyết là tình trạng ‘nghĩa địa video’: khi bạn tải hàng trăm video YouTube về máy, việc tìm lại một nội dung cụ thể gần như bất khả thi nếu không có công cụ chuyên biệt. Tube Archivist biến đống file hỗn độn thành một thư viện media có tổ chức, tìm kiếm được và thưởng thức ngay trên trình duyệt.
Những tính năng nổi bật của Tube Archivist là gì?
Ở lõi, Tube Archivist làm được bốn việc chính: đăng ký kênh yêu thích, tải video tự động hoặc thủ công, đánh chỉ mục để tìm kiếm và phát lại video ngay trên giao diện web. Bạn có thể lọc theo kênh, playlist, trạng thái xem/chưa xem, thậm chí tìm kiếm trong bình luận hoặc phụ đề. Hệ thống hàng chờ tải cho phép thêm link video, ID, playlist hàng loạt, và lập lịch quét kênh định kỳ để tự động tải video mới. Ngoài ra, dự án còn cung cấp tiện ích mở rộng trình duyệt Tube Archivist Companion để gửi video thẳng vào hàng chờ, plugin Jellyfin và Plex để phát trên TV, và hỗ trợ SponsorBlock, tải phụ đề, bình luận. Gần đây nhất, roadmap đã hiện thực hóa việc tìm kiếm trong hàng chờ, cấu hình riêng cho Shorts/streams và playlist do người dùng tạo.
Làm sao để cài đặt và sử dụng Tube Archivist một cách hiệu quả?
Tube Archivist được đóng gói dưới dạng Docker Compose, yêu cầu tối thiểu 2GB RAM cho thiết lập nhỏ và 4GB cho quy mô vừa-lớn, CPU dual‑core 4 luồng trở lên. Trước tiên, bạn cần cài Docker và đảm bảo kernel setting vm.max_map_count được đặt ít nhất 262144 (lệnh sudo sysctl -w vm.max_map_count=262144). Sau đó tạo file docker-compose.yml dựa trên mẫu từ repository và khai báo các biến môi trường bắt buộc: TA_HOST, TA_USERNAME, TA_PASSWORD, ELASTIC_PASSWORD, REDIS_CON, TZ. Chạy docker-compose up -d và truy cập giao diện web qua cổng 8000. Trong lần đầu, hãy vào Settings chọn định dạng tải phù hợp (ví dụ bestvideo[vcodec*=avc1]+bestaudio[acodec*=mp4a]/mp4) để đảm bảo video phát được trên mọi thiết bị. Đăng ký vài kênh yêu thích, nhấn ‘Rescan subscriptions’ để đưa video vào hàng chờ rồi bấm ‘Start download’. Mọi thao tác đều trực quan, nhưng đọc kỹ docs để tránh lỗi port collision (đổi port ánh xạ container) hay lỗi permissions Elasticsearch (chown 1000:0 -R /path/to/data). Cập nhật thường xuyên, khuyến nghị không để cách quá 1–2 phiên bản để tránh breaking changes.
Ai nên dùng Tube Archivist và những hạn chế nào cần lưu ý?
Đối tượng lý tưởng là những người đam mê homelab, data hoarder, nhà nghiên cứu nội dung hay đơn giản là ai muốn xem YouTube ngoại tuyến mà không sợ video bị xóa. Nếu bạn đã có một máy chủ nhỏ chạy Docker và khao khát xây dựng thư viện riêng, Tube Archivist là lựa chọn hàng đầu. Tuy nhiên, cần lưu ý những hạn chế: file video tạo ra phải tương thích với codec mà trình duyệt của bạn hỗ trợ; yt-dlp có những giới hạn riêng (nếu yt-dlp không tải được thì Tube Archivist cũng bó tay); và đặc biệt dự án không cho phép tùy biến cách đặt tên file media – một điểm yếu nếu bạn muốn tổ chức cây thư mục theo ý mình. Ngoài ra, dung lượng ổ cứng phải đủ lớn vì Elasticsearch sẽ chuyển sang chế độ chỉ đọc khi đầy 95%. Vì vậy, người dùng cần chuẩn bị không gian lưu trữ thoải mái và thường xuyên theo dõi disk usage.
Câu hỏi thường gặp
Tube Archivist cần bao nhiêu RAM và CPU?
Thiết lập thử nghiệm chỉ cần 2GB RAM, nhưng để tải vài trăm kênh, bạn nên có 4GB RAM và CPU 4 nhân. Riêng container Elasticsearch ngốn khá nhiều tài nguyên, vì vậy đừng tiết kiệm bộ nhớ nếu không muốn giật lag khi tìm kiếm.
Làm sao tránh xung đột cổng 8000?
Bạn ánh xạ lại port ở phía host trong docker-compose, ví dụ 9000:8000 để dùng cổng 9000. Đây là cách sạch sẽ nhất thay vì sửa cấu hình bên trong container.
Cập nhật Tube Archivist như thế nào để không hỏng dữ liệu?
Luôn kéo image mới bằng tag phiên bản ổn định, kiểm tra release notes để nắm breaking changes. Dự án khuyến nghị cập nhật ít nhất mỗi tháng một lần và không nhảy quá hai phiên bản cùng lúc để đảm bảo tương thích.
Tôi có thể dùng yt-dlp với cookie riêng không?
Có, Tube Archivist hỗ trợ truyền cookie trình duyệt vào yt-dlp để tải video bị giới hạn độ tuổi hoặc cần đăng nhập. Tính năng này đã có từ lâu và bạn chỉ cần cấu hình trong Settings.
Tube Archivist có hỗ trợ sao lưu và phục hồi không?
Có, dự án đã tích hợp tính năng backup/restore từ lâu, và còn có script cộng đồng để di trú dữ liệu giữa các phiên bản lớn. Bạn nên sao lưu định kỳ cả volume Elasticsearch lẫn media.
Kết luận
Tube Archivist là giải pháp tự lưu trữ video YouTube toàn diện nhất hiện nay trong thế giới mã nguồn mở, đặc biệt phù hợp với người dùng muốn kiểm soát dữ liệu và tìm kiếm nội dung một cách chuyên nghiệp. Dù còn một vài hạn chế về đặt tên file và phụ thuộc vào yt-dlp, giá trị mà nó mang lại – từ đăng ký kênh, tải hàng loạt, đến tìm kiếm tức thì – là không thể xem nhẹ. Nếu bạn đã sẵn sàng dành chút thời gian cài đặt Docker và làm quen với biến môi trường, hãy ghé repository GitHub, đọc tài liệu và bắt đầu xây dựng thư viện YouTube bất tử của riêng mình ngay hôm nay.
