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...
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_timeouttrong 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
- Komga Documentation
- Kavita Documentation
- Docker Compose Documentation
- Nginx Proxy Module
- Caddy Documentation
- Certbot Documentation
- Redis Documentation
- PgBouncer Documentation
Để 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
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%.
VPS-3E
Đã gồm VAT 10%
- CPU: 2 vCPU
- RAM: 4 GB
- SSD: 50 GB NVMe
