Ngừng tích trữ, hãy bắt đầu đọc: Xây dựng thư viện Manga chuyên nghiệp với Kavita và Docker

Table of Contents

Sự hỗn loạn của việc tích trữ kỹ thuật số

Tích trữ dữ liệu thì dễ, nhưng sắp xếp chúng sao cho khoa học mới là điều khiến chúng ta đau đầu.

Nếu bạn từng quăng hàng ngàn tệp PDF và EPUB vào một thư mục duy nhất trên NAS, bạn sẽ hiểu cảm giác này. Việc tìm tập 12 của một bộ manga cụ thể hay cố nhớ xem mình đang đọc dở trang nào trên điện thoại trở thành một cực hình. Trong khi các công cụ như Plex hay Jellyfin là những bậc thầy về video, chúng thường coi sách như một sở thích bị bỏ rơi. Tôi đã dành nhiều tháng thử nghiệm các thiết lập khác nhau trước khi tìm thấy một giải pháp thực sự mang lại cảm giác của một thư viện chuyên nghiệp.

Ba “ông lớn”: Lựa chọn nền tảng phù hợp

Trong thế giới đọc sách tự lưu trữ (self-hosted), ba cái tên sau đây chiếm ưu thế: Calibre-Web, Komga và Kavita. Chọn sai có thể khiến bạn mất hàng giờ để di chuyển dữ liệu sau này.

Calibre-Web: Sự lựa chọn của các thủ thư. Nó vô đối về metadata chuyên sâu và e-book truyền thống. Tuy nhiên, trình đọc truyện tranh của nó mang lại cảm giác như một di vật từ năm 2005, và giao diện trên di động khá chậm chạp.
Komga: Một “con quái vật” chuyên dụng cho các tệp .CBZ và .CBR. Nó cực kỳ mượt mà khi đọc manga, nhưng lại “hụt hơi” khi bạn cố chạy một tệp PDF kỹ thuật nặng 500MB hoặc một tiểu thuyết EPUB phức tạp.
Kavita: Đây chính là điểm giao thoa hoàn hảo. Nó coi manga, truyện tranh và e-book đều quan trọng như nhau. Nó nhẹ, xử lý các bộ sưu tập khổng lồ mà không bị giật lag, và trình đọc web trông sạch đẹp không kém gì các ứng dụng Kindle hay Comixology trả phí.

Kavita: Hiệu năng thực tế

Trước khi bạn tải image về, đây là cách Kavita thực tế xử lý khối lượng công việc hàng ngày. Nó không hoàn hảo, nhưng đã rất gần mức đó.

Những ưu điểm vượt trội

Phản hồi tức thì: Tốc độ không chỉ là một lời quảng cáo. Ngay cả với thư viện vượt quá 10.000 mục, kết quả tìm kiếm vẫn xuất hiện dưới 200ms. Các nhà phát triển đã xây dựng nó để có thể mở rộng quy mô lớn.
Hỗ trợ định dạng: Nó xử lý mượt mà các tệp EPUB, PDF, CBZ, CBR và ZIP mà không cần plugin bên ngoài.
Lợi thế từ OPDS: Đây là tính năng “đỉnh” nhất. Bạn có thể kết nối các ứng dụng như Panels (iOS) hoặc Moon+ Reader (Android) trực tiếp với máy chủ của mình. Tiến trình đọc sẽ tự động đồng bộ giữa máy tính bảng ở nhà và điện thoại của bạn khi đang trên tàu.
Phân quyền truy cập: Bạn có thể lưu trữ một máy chủ nhưng tạo các tài khoản riêng biệt. Giữ thư viện “Tài liệu kỹ thuật” cho riêng mình và chia sẻ thư viện “Truyện tranh” với gia đình.

Những hạn chế cần lưu ý

Kỷ luật đặt tên: Kavita rất nghiêm ngặt. Nếu tệp của bạn được đặt tên là “Untitled_Scan_v2.zip”, nó sẽ không biết phải xử lý thế nào. Bạn cần một cấu trúc thư mục sạch sẽ: Library/Tên bộ truyện/Tập.cbz.
Cần chỉnh sửa Metadata thủ công: Mặc dù nó đọc được tệp ComicInfo.xml, nhưng nó không luôn chủ động quét web để lấy ảnh bìa mạnh mẽ như cách Plex làm với phim. Bạn có thể cần phải trau chuốt thủ công một chút.

Cấu hình HomeLab lý tưởng

Đừng cấp phát quá nhiều tài nguyên không cần thiết. Kavita hoạt động cực kỳ hiệu quả. Tôi đã chạy nó thoải mái trên một chiếc Raspberry Pi 4, mặc dù một máy ảo Linux chuyên dụng sẽ mượt mà hơn.

Yêu cầu tối thiểu:

CPU: 2 nhân (Nhiều nhân hơn sẽ giúp ích trong quá trình quét thư viện ban đầu).
RAM: 2GB (Quan trọng nếu bạn đọc các bản scanlation PDF chất lượng 4K nặng).
Hệ điều hành: Bất kỳ bản phân phối Linux nào có Docker. Hãy tránh Docker trên Windows nếu có thể—các lỗi phân quyền tệp sớm muộn gì cũng sẽ làm phiền bạn.

Triển khai: Phương pháp Docker Compose

Hãy quên các câu lệnh terminal dài dằng dặc đi. Docker Compose giúp thiết lập của bạn có thể lặp lại và dễ dàng sao lưu. Tôi luôn sử dụng image từ LinuxServer.io vì họ xử lý phân quyền tốt hơn bất kỳ ai khác.

1. Chuẩn bị không gian làm việc

Tạo các thư mục của bạn. Giữ cấu hình tách biệt với dữ liệu media là quy tắc vàng khi tự lưu trữ (self-hosting).

mkdir -p ~/homelab/kavita/config
mkdir -p ~/homelab/kavita/manga
mkdir -p ~/homelab/kavita/books

2. Cấu hình

Tạo tệp docker-compose.yml trong thư mục ~/homelab/kavita. Chạy lệnh id $USER trong terminal để lấy UID và GID của bạn (thường là 1000).

version: "3.8"
services:
  kavita:
    image: lscr.io/linuxserver/kavita:latest
    container_name: kavita
    environment:
      - PUID=1000 
      - PGID=1000
      - TZ=Asia/Ho_Chi_Minh
    volumes:
      - ./config:/config
      - /home/user/media/manga:/data/manga
      - /home/user/media/books:/data/books
    ports:
      - 5000:5000
    restart: unless-stopped

3. Khởi chạy

Đưa container lên hoạt động:

docker-compose up -d

Nếu bạn muốn xem hệ thống có đang hoạt động trơn tru hay không, hãy kiểm tra log trực tiếp:

docker logs -f kavita

Cài đặt và tối ưu hóa

Truy cập vào địa chỉ http://[IP-Server-Của-Bạn]:5000. Nhiệm vụ đầu tiên của bạn là tạo tài khoản admin. Đừng làm mất thông tin đăng nhập này; việc đặt lại chúng bên trong Docker khá rắc rối.

Thêm thư viện đầu tiên

Đi tới Settings > Libraries. Khi thêm một thư mục, việc chọn **Type** (Loại) rất quan trọng. Nếu bạn gắn nhãn một thư mục manga là “Book”, trình đọc sẽ không cung cấp chế độ lật trang từ phải sang trái (Right-to-Left) như mong đợi. Tôi cũng khuyên bạn nên tích vào ô “Save metadata to file”. Điều này đảm bảo rằng nếu bạn di chuyển thư viện sang máy chủ mới, tất cả ảnh bìa và thẻ tag tùy chỉnh sẽ đi theo nó.

Chế độ xem hoàn hảo

Để có trải nghiệm tốt nhất trên máy tính bảng, hãy vào phần cài đặt người dùng. Đặt **Reading Direction** thành “Right to Left” và sử dụng chế độ “Double Page” (Trang đôi). Trên một chiếc iPad Pro, cảm giác này gần như giống hệt việc cầm một tập truyện đơn (tankobon) vật lý.

Bảo mật: Đọc truyện khi đang di chuyển

Mở cổng 5000 ra internet công cộng là một hành động tiềm ẩn nhiều rủi ro. Đừng làm vậy. Thay vào đó, hãy sử dụng **Tailscale**. Nó tạo ra một mạng VPN mesh riêng tư, được mã hóa. Sau khi cài đặt trên điện thoại và máy chủ, bạn có thể truy cập Kavita bằng IP nội bộ từ bất kỳ đâu trên thế giới. Đây là tiêu chuẩn vàng về bảo mật và chỉ mất khoảng hai phút để thiết lập.

Bảo trì và cập nhật

Các container không nên bị bỏ mặc sau khi cài đặt. Khoảng mỗi tháng một lần, hãy làm mới image của bạn để nhận được các bản vá bảo mật và tính năng mới nhất. Vì chúng ta đã sử dụng Compose, quá trình này chỉ mất vài giây:

docker-compose pull
docker-compose up -d

Kavita đã hoàn toàn thay đổi cách tôi tiêu thụ nội dung số. Nó biến một đống tệp hỗn độn thành một thư viện đẹp mắt, được sắp xếp tỉ mỉ, khiến bạn thực sự muốn dành thời gian để đọc nhiều hơn.