Quay lại danh sách
DevOps & Hệ thống

Hướng dẫn tự xây dựng trạm lưu trữ và xem truyện tranh manga cá nhân bằng Komga hoặc Kavita trên VPS

Hướng dẫn chi tiết cấu hình Komga hoặc Kavita trên VPS với Docker, Nginx/Caddy, ACME SSL, và xử lý lỗi 502 Bad Gateway, thời gian chờ, và kiểm soát bộ nhớ Redis/PgBouncer. Hướng dẫn...

DPTCloud Engineering4 phút đọc
Hướng dẫn tự xây dựng trạm lưu trữ và xem truyện tranh manga cá nhân bằng Komga hoặc Kavita trên VPS

Giới thiệu

Trong thời đại số hóa, việc tự xây dựng một trạm lưu trữ và xem truyện tranh manga cá nhân trên VPS đã trở thành lựa chọn phổ biến cho những người yêu thích nội dung số. Các ứng dụng như Komga và Kavita cung cấp giao diện hiện đại, hỗ trợ nhiều định dạng tệp (PDF, CBZ, CBR) và khả năng quản lý thư viện truyện chuyên nghiệp. Bài viết này hướng dẫn chi tiết cách triển khai hai nền tảng này trên VPS bằng Docker, với các giải pháp thực tiễn cho các vấn đề thường gặp như lỗi 502 Bad Gateway, thời gian chờ, gia hạn chứng chỉ SSL ACME, và kiểm soát bộ nhớ Redis/PgBouncer.

Yêu cầu và chuẩn bị

Trước khi bắt đầu, đảm bảo bạn có:

  • Một máy chủ VPS với hệ điều hành Linux (Ubuntu 22.04/24.04 hoặc Debian 11/12)
  • Đường dẫn DNS đã được thiết lập (ví dụ: manga.yourdomain.com)
  • Access SSH đến VPS
  • Docker và Docker Compose đã được cài đặt
  • Một trình duyệt hỗ trợ HTTPS

Chúng ta sẽ sử dụng Docker để triển khai các ứng dụng một cách tách biệt và dễ quản lý. Cấu hình này cũng hỗ trợ việc triển khai rootless container để tăng tính bảo mật.

Triển khai Komga hoặc Kavita với Docker

1. Tạo thư mục cấu hình

Tạo thư mục để lưu trữ dữ liệu và cấu hình:

mkdir -p /opt/manga/{komga,kavita}/config
mkdir -p /opt/manga/{komga,kavita}/data

2. Tạo file docker-compose.yml

Chọn một trong hai ứng dụng sau, hoặc tạo hai file riêng biệt.

Đối với Komga:

version: '3.8'

services:
  komga:
    image: ghcr.io/gotson/komga:latest
    container_name: komga
    restart: unless-stopped
    volumes:
      - /opt/manga/komga/config:/config
      - /opt/manga/komga/data:/data
    ports:
      - "8080:8080"
    environment:
      - KOMGA_DATABASE_URL=jdbc:sqlite:/config/komga.db
      - KOMGA_LOG_LEVEL=INFO
    networks:
      - manga-net

networks:
  manga-net:
    driver: bridge

Đối với Kavita:

version: '3.8'

services:
  kavita:
    image: kavita/kavita:latest
    container_name: kavita
    restart: unless-stopped
    volumes:
      - /opt/manga/kavita/config:/config
      - /opt/manga/kavita/data:/data
    ports:
      - "5000:5000"
    environment:
      - KAVITA_DATABASE_URL=sqlite:///config/kavita.db
      - KAVITA_LOG_LEVEL=INFO
    networks:
      - manga-net

networks:
  manga-net:
    driver: bridge

3. Khởi chạy ứng dụng

Chạy Docker Compose để triển khai:

cd /opt/manga/komga
sudo docker-compose up -d

Phối hợp với Nginx/Caddy để xử lý 502 Bad Gateway và thời gian chờ

1. Cấu hình Nginx

Để tránh lỗi 502 Bad Gateway do thời gian chờ quá lâu, cấu hình Nginx với các tham số phù hợp:

server {
    listen 80;
    server_name manga.yourdomain.com;

    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # Tăng thời gian chờ
        proxy_connect_timeout 300s;
        proxy_send_timeout 300s;
        proxy_read_timeout 300s;

        # Giới hạn kích thước file
        client_max_body_size 100M;
    }
}

2. Cấu hình Caddy

Đối với Caddy, cấu hình đơn giản hơn nhờ tính năng tự động hóa:

manga.yourdomain.com {
    reverse_proxy http://localhost:8080 {
        header_up Host {host}
        header_up X-Real-IP {remote}
        header_up X-Forwarded-For {remote}
        header_up X-Forwarded-Proto {scheme}
        timeout_connect 300s
        timeout_send 300s
        timeout_read 300s
    }
}

Thực hiện gia hạn chứng chỉ SSL ACME tự động

1. Cài đặt Certbot hoặc Caddy ACME

Đối với Nginx, sử dụng Certbot:

sudo apt install certbot
sudo certbot certonly --nginx -d manga.yourdomain.com

2. Tự động hóa gia hạn

Chạy lệnh để kiểm tra và gia hạn chứng chỉ:

sudo certbot renew --dry-run

Đảm bảo có cron job chạy hàng ngày:

0 0 * * * /usr/bin/certbot renew --quiet

Kiểm soát bộ nhớ Redis và PgBouncer

1. Redis

Redis có thể tiêu tốn nhiều bộ nhớ nếu không được quản lý. Tối ưu bằng cách thiết lập các chính sách:

  • maxmemory: Giới hạn bộ nhớ tối đa
  • maxmemory-policy: Chọn chiến lược xóa (ex: allkeys-lru)

Chỉnh sửa file redis.conf:

maxmemory 512mb
maxmemory-policy allkeys-lru

2. PgBouncer

Đối với Kavita, nếu sử dụng PostgreSQL, PgBouncer giúp quản lý kết nối. Tối ưu hóa bằng cách:

  • Giới hạn số kết nối tối đa
  • Thiết lập thời gian chờ kết nối

Chỉnh sửa file pgbouncer.ini:

[pgbouncer]
max_client_conn = 100
default_pool_size = 20
server_idle_timeout = 60

Khắc phục sự cố

1. Lỗi 502 Bad Gateway

  • Kiểm tra container có đang chạy không: docker ps
  • Kiểm tra log: docker logs komga
  • Đảm bảo Nginx/Caddy đã cấu hình đúng port và proxy
  • Giảm tải ứng dụng bằng cách tăng thời gian chờ

2. Thời gian chờ quá lâu

  • Tăng proxy_read_timeout trong Nginx
  • Giảm số lượng tác phẩm tải lên cùng lúc
  • Chạy ứng dụng trên VPS có CPU/RAM tốt hơn

3. Gia hạn SSL thất bại

  • Kiểm tra DNS đã trỏ đúng chưa
  • Chạy certbot renew --dry-run để kiểm tra
  • Đảm bảo port 80 và 443 không bị chặn

Tài liệu tham khảo

Để tìm hiểu thêm về các giải pháp VPS hiệu năng cao, bạn có thể tham khảo bài viết Tối ưu hóa hạ tầng mạng: Hướng dẫn cấu hình Multipath TCP (MPTCP) trên Linux để ghép băng thông VPS.

Tham khảo hạ tầng & bài viết liên quan: Cloud VPS NVMe cho Docker, Nginx & Database

Hạ tầng DPTCloud Tier III

Cấu hình Cloud VPS NVMe khuyến nghị để triển khai

SSD NVMe Enterprise RAID 10, đường truyền CMC & FPT Quận 9 chống DDoS Anycast, Uptime SLA 99.99%.

Xem 22 gói Cloud VPS
ECO · vn-02

VPS-2E

94.600 ₫ / tháng

Đã gồm VAT 10%

  • CPU: 2 vCPU
  • RAM: 2 GB
  • SSD: 30 GB NVMe
ECO · vn-02Khuyên dùng

VPS-3E

170.500 ₫ / tháng

Đã gồm VAT 10%

  • CPU: 2 vCPU
  • RAM: 4 GB
  • SSD: 50 GB NVMe
BASIC · vn-01Khuyên dùng

VPS-05

457.600 ₫ / tháng

Đã gồm VAT 10%

  • CPU: 4 vCPU
  • RAM: 8 GB
  • SSD: 50 GB NVMe

Bài viết liên quan

Xem tất cả
ZaloChat Zalo 24/7Discord0384 753 478