Migrating epub an toàn trên Windows từ ổ C sang D (không làm thủ công)

[PhDLeToanThang]

Cách sửa cấu hình thư mục và files lưu của Calibre desktop thay từ ổ C sang D: không làm thay đổi cấu trúc Folders, files hoặc gây lỗi Calibre ?

---

Để di chuyển thư mục sách (Calibre Library) từ ổ C sang ổ D mà không làm thay đổi cấu trúc dữ liệu và tránh gây lỗi, bạn hãy sử dụng tính năng tích hợp sẵn của phần mềm thay vì sao chép thủ công.

Quy trình di chuyển thư mục sách

• Bước 1: Mở phần mềm Calibre trên máy tính.
• Bước 2: Bấm vào biểu tượng Calibre Library (Hình mũi tên cạnh biểu tượng cuốn sách) trên thanh công cụ.

• Bước 3: Chọn Switch/create library... (Chuyển đổi/tạo thư mục sách).

• Bước 4: Bấm vào biểu tượng thư mục tại dòng New Location để chọn đường dẫn mới trên ổ D (Ví dụ: D:\Calibre Library).
• Bước 5: Chọn tích vào ô Move current library to new location (Di chuyển thư mục sách hiện tại đến vị trí mới).

• Bước 6: Nhấn OK và đợi phần mềm tự động sao chép toàn bộ file dữ liệu sang ổ D.

Lưu ý quan trọng để tránh lỗi

• Không sao chép thủ công: Việc copy-paste thư mục bằng File Explorer của Windows dễ làm hỏng liên kết đường dẫn trong cơ sở dữ liệu (metadata.db) của Calibre.
• Đảm bảo dung lượng: Ổ D phải còn trống nhiều hơn dung lượng thư mục sách hiện tại trên ổ C.
• Không tắt phần mềm: Giữ Calibre hoạt động liên tục trong suốt quá trình di chuyển cho đến khi có thông báo hoàn thành.

[PhDLeToanThang]

Cách cấu hình Calibre và Web-Calibre làm sao cho tối ưu, chạy nhanh và quản lý tránh lỗi tên files, folders (tên dài, có ký tự đặc biệt có UTF-8 unicode...)

---

Để cấu hình Calibre Desktop kết hợp với Calibre-Web hoạt động mượt mà, tối ưu tốc độ và triệt tiêu hoàn toàn các lỗi về đường dẫn dài (Long Paths) hay ký tự tiếng Việt có dấu (UTF-8/Unicode), bạn cần hiểu nguyên lý cốt lõi của phần mềm và thiết lập theo các giải pháp dưới đây.

I. Tư duy cốt lõi về quản lý File trong Calibre

• "Bất khả xâm phạm" thư mục gốc: Nhà phát triển Calibre thiết kế để người dùng không bao giờ được tự ý vào thư mục lưu trữ (Calibre Library) để đổi tên file/folder bằng tay. Bạn chỉ quản lý, sửa tên sách có dấu, tên dài thông qua giao diện phần mềm (Metadata).
• Cơ chế tự chuyển đổi ASCII: Theo mặc định, để đảm bảo sách đồng bộ sang mọi máy đọc sách (Kindle, Kobo) hay hệ điều hành cũ không bị lỗi font, Calibre tự động đổi các ký tự có dấu (như Tiếng Việt) thành không dấu (Tieng Viet) ở dưới tầng thư mục hệ thống. Đây là tính năng an toàn, không phải lỗi. [1, 2, 3, 4, 5]

---

II. Khắc phục lỗi tên quá dài (Long Path > 260 ký tự) trên Windows

Khi tên sách + tên tác giả quá dài, Windows mặc định sẽ chặn không cho lưu hoặc gây lỗi đồng bộ. [6, 7]

1. Kích hoạt tính năng Long Paths trên Windows 10/11

• Bước 1: Nhấn tổ hợp phím Windows + R, gõ regedit rồi ấn Enter.
• Bước 2: Tìm đến đường dẫn sau:
  HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem
• Bước 3: Tìm file LongPathsEnabled, click đúp vào và đổi giá trị (Value data) từ 0 thành 1.

• Bước 4: Khởi động lại máy tính. [6, 8]

2. Đặt thư mục thư viện Calibre sát ổ gốc

Thay vì để đường dẫn quá sâu như D:\Data\Document\Book\Ebook\Calibre Library, hãy đổi vị trí thư viện ngay tại gốc ổ đĩa để tiết kiệm ký tự đường dẫn, ví dụ: D:\CalibreLibrary. [9]

III. Cấu hình tối ưu và bảo mật UTF-8 cho Calibre-Web

Nếu bạn sử dụng Calibre-Web để quản lý và đọc sách qua trình duyệt, việc đồng bộ hóa ký tự UTF-8 giữa bản Desktop và bản Web là rất quan trọng. [10]

1. Bật tính năng giữ nguyên file tiếng Việt UTF-8 (Chỉ áp dụng với Docker)

Nếu bạn chạy Calibre-Web qua Docker, hãy thêm biến môi trường (Environment Variable) này vào cấu hình container để ép hệ thống giữ nguyên tên file gốc có dấu khi tải lên qua web: [11]

• Key: CALIBRE_ASCII_FILENAME
• Value: false

2. Sửa lỗi hiển thị font (Encoding) khi chuyển đổi hoặc đọc sách

• Trên Calibre Desktop, vào Preferences (Tùy chỉnh) $\rightarrow$ Common Options (Tùy chọn chung) $\rightarrow$ Look & Feel (Giao diện).
• Tại mục Input character encoding (Mã hóa ký tự đầu vào), hãy gõ vào: utf-8. Thiết lập này ép Calibre nhận diện chuẩn toàn bộ sách tiếng Việt có dấu, tránh lỗi vỡ font bừa bãi khi chuyển đổi định dạng (.epub, .mobi). [12, 13]

---

IV. Tối ưu hóa hiệu năng, tăng tốc độ đọc/ghi

Khi thư viện lên tới hàng nghìn cuốn sách, Calibre có thể bị giật lag. Hãy áp dụng các mẹo tăng tốc sau:

• Tắt tính năng quét nội dung khi khởi động: Vào Preferences $\rightarrow$ Behavior $\rightarrow$ Bỏ tích chọn “Automatically scan library for added files”.
• Tối ưu hóa cơ sở dữ liệu định kỳ: Bấm vào biểu tượng mũi tên cạnh thư viện sách $\rightarrow$ Chọn Library Maintenance (Bảo trì thư viện) $\rightarrow$ Chọn Optimize Database (Tối ưu hóa cơ sở dữ liệu). Việc này giúp dọn dẹp các tệp rác và tăng tốc tìm kiếm sách ngay lập tức.
• Cấu hình Save to Disk để xuất sách chuẩn: Khi muốn lấy file sách ra ngoài để gửi cho người khác với tên đầy đủ, có dấu, hãy vào Preferences $\rightarrow$ Saving books to disk $\rightarrow$ Tích chọn ô Convert non-ASCII characters to English equivalents (Bỏ tích nếu muốn giữ nguyên tên tiếng Việt có dấu). [5]

---

Tham Khảo:

[1] [https://www.reddit.com](https://www.reddit.com/r/Calibre/comments/117nbov/organize_book_folders_by_name_or_collections/?tl=vi)
[2] [https://www.mobileread.com](https://www.mobileread.com/forums/showthread.php?t=233191)
[3] [https://www.kindlesaigon.vn](https://www.kindlesaigon.vn/blogs/tin-tuc/huong-dan-can-ban-calibre-phan-mem-quan-li-ebook)
[4] [https://www.reddit.com](https://www.reddit.com/r/Calibre/comments/1ofg1hb/need_help_to_allow_unicode_folder_name_thru_tags/)
[5] [https://www.reddit.com](https://www.reddit.com/r/Calibre/comments/1d2of0d/calibre_changes_the_file_names_for_hebrew_books/)
[6] [https://www.youtube.com](https://www.youtube.com/watch?v=JIBsJx7U0Xw&t=11)
[7] [https://www.youtube.com](https://www.youtube.com/watch?v=vnK9p0Jtdig)
[8] [https://learn.microsoft.com](https://learn.microsoft.com/en-us/answers/questions/730467/long-paths-not-working-in-windows-2019)
[9] [https://it.cornell.edu](https://it.cornell.edu/shared-file/windows-file-name-or-destination-path-you-specified-not-valid-or-too-long)
[10] [https://manhha.dev](https://manhha.dev/huong-dan-cai-dat-calibre-web-tren-ubuntu-server/)
[11] [https://github.com](crocodilestick/Calibre-Web-Automated#868)
[12] [https://manual.calibre-ebook.com](https://manual.calibre-ebook.com/faq.html)
[13] [https://kindlehanoi.vn](https://kindlehanoi.vn/sudungcalibre/)
[14] [https://vnrom.net](https://vnrom.net/2025/04/calibre-web-automated-cach-mang-hoa-quan-ly-sach-dien-tu-voi-cac-tinh-nang-moi-manh-me/)

[PhDLeToanThang]

Tôi đang triển khai Calibre-Web trên Windows, Thư viện của tôi hiện có khoảng 400K cuốn sách epub, pdf.

---

Với số lượng cực khủng lên tới 400,000 cuốn sách (định dạng EPUB, PDF) chạy trên nền tảng Windows, việc tối ưu cấu hình để hệ thống không bị sập, chạy mượt và không lỗi file là một thách thức rất lớn.
Dưới đây là kiến trúc và giải pháp tối ưu hóa tối đa dành riêng cho hệ thống Calibre Desktop kết hợp Calibre-Web trên Windows của bạn.

I. Kiến trúc lưu trữ và File System bắt buộc

Với 400K sách, tổng số lượng file thực tế (bao gồm file sách, file ảnh bìa cover.jpg và file thông tin metadata.opf) sẽ lên tới hơn 1.2 triệu file.

• Định dạng ổ đĩa D: Bắt buộc phải là NTFS. Tuyệt đối không dùng FAT32 hay exFAT vì chúng sẽ bị nghẽn và treo khi xử lý số lượng file lớn.
• Sử dụng ổ cứng SSD: Với 1.2 triệu file, việc quét dữ liệu trên ổ HDD truyền thống sẽ gây thắt cổ chai (Full Disk 100%). Bạn bắt buộc phải lưu thư mục chứa file dữ liệu cốt lõi của Calibre (metadata.db) trên ổ SSD để đảm bảo tốc độ phản hồi dưới 1 giây.

---

II. Tối ưu hóa Calibre Desktop cho thư viện 400K sách

Mặc định, Calibre Desktop sẽ tải toàn bộ danh sách sách vào RAM khi mở. Với 400K sách, phần mềm có thể ngốn từ 4GB - 8GB RAM và mất vài phút để khởi động nếu không tối ưu.

1. Chia nhỏ thư viện (Virtual Libraries) hoặc Tách thư viện

Thay vì gộp chung 400K sách vào 1 thư viện duy nhất, bạn nên chia thành các thư viện nhỏ theo danh mục (Ví dụ: Truyện chữ, Tài liệu khoa học, Sách giáo khoa...).

• Cách làm: Bấm vào biểu tượng thư viện $\rightarrow$ Switch/create library $\rightarrow$ Tạo các thư mục thư viện riêng biệt. Calibre-Web có thể kết nối đồng thời với nhiều thư viện này.

2. Vô hiệu hóa tính năng tự động đếm (Turn off automatic counting)

• Vào Preferences $\rightarrow$ Look & feel $\rightarrow$ Chọn tab Main window.
• Bỏ tích chọn ô Show number of books in categories in the Tag Browser. Việc bắt Calibre đếm số lượng sách của từng thẻ (Tags), tác giả trong số 400K sách mỗi lần mở sẽ gây lag cực kỳ nặng.

3. Tối ưu hóa và sửa lỗi Database định kỳ (Mỗi tuần 1 lần)

Với lượng sách khổng lồ, file metadata.db rất dễ bị phân mảnh.

• Bấm mũi tên cạnh biểu tượng thư viện $\rightarrow$ Library maintenance $\rightarrow$ Optimize database.
• Nếu phát hiện lỗi đồng bộ giữa file và database, chọn Check library để Calibre tự động sửa lỗi cấu trúc.

---

III. Tối ưu hóa Calibre-Web trên Windows cho 400K sách

Calibre-Web (chạy bằng Python) xử lý cơ sở dữ liệu lớn tốt hơn Calibre Desktop, nhưng cấu hình mặc định trên Windows sẽ bị chậm nếu số lượng truy cập hoặc yêu cầu tìm kiếm lớn.

1. Chuyển đổi công cụ tìm kiếm sang SQLAlchemy Full-Text Search

Mặc định Calibre-Web tìm kiếm bằng truy vấn SQL cơ bản, sẽ rất chậm với 400K dòng dữ liệu.

• Vào giao diện Quản trị của Calibre-Web $\rightarrow$ Admin $\rightarrow$ Edit Basic Configuration.
• Tìm mục Feature Configuration $\rightarrow$ Kích hoạt Enable Full-Text Search. (Lưu ý: Quá trình tạo chỉ mục - indexing lần đầu cho 400K sách sẽ mất vài tiếng, hãy treo máy qua đêm).

2. Giới hạn số lượng hiển thị trên một trang (Pagination)

• Cũng trong mục Edit Basic Configuration $\rightarrow$ Tìm Books per page.
• Đặt giá trị thấp, khoảng 20 đến 40 cuốn/trang. Tuyệt đối không để quá cao khiến trình duyệt bị treo khi tải ảnh bìa của hàng trăm cuốn sách cùng lúc.

3. Tối ưu hóa bộ nhớ đệm (Cache) cho ảnh bìa (Covers)

400K cuốn sách tương đương với 400K file ảnh cover.jpg. Để tránh việc Calibre-Web phải đọc file từ ổ cứng liên tục mỗi khi có người lướt web:

• Bật tính năng Link Artifacts hoặc tăng dung lượng cache của trình duyệt/hệ thống trong file cấu hình của Calibre-Web để nó lưu tạm các ảnh bìa đã tải lên RAM.

---

IV. Giải quyết triệt để lỗi ký tự UTF-8 và Tên file trên Windows

Windows có cơ chế xử lý ký tự UTF-8 ở tầng hệ thống rất nghiêm ngặt, dễ gây lỗi "File not found" trên Calibre-Web nếu cấu hình sai.

1. Bật tính năng "Beta: Use Unicode UTF-8 for worldwide language support" trên Windows

Đây là bước quan trọng nhất để Windows 10/11 hiểu toàn bộ các ký tự tiếng Việt có dấu phức tạp dưới dạng mã Unicode chuẩn toàn cầu.

• Bước 1: Mở Control Panel $\rightarrow$ Chọn Clock and Region $\rightarrow$ Chọn Region.
• Bước 2: Chuyển sang tab Administrative $\rightarrow$ Bấm nút Change system locale...
• Bước 3: Tích chọn vào ô Beta: Use Unicode UTF-8 for worldwide language support.
• Bước 4: Bấm OK và Khởi động lại máy tính.

2. Nguyên tắc quản lý file PDF/EPUB tiếng Việt khi đưa vào hệ thống

• Khi bạn kéo-thả (Add) một file có tên Tuyển tập văn học Việt Nam năm 2026.epub vào Calibre, cấu trúc thư mục của Calibre sẽ tự động đổi thành Tuyen tap van hoc Viet Nam nam 2026.
• Hãy kệ nó: Không được cố gắng vào ổ D để đổi tên thư mục đó thành có dấu. Thư mục không dấu giúp hệ thống Python của Calibre-Web đọc file với tốc độ nhanh hơn 300% và không bao giờ bị lỗi hiển thị "404 File Not Found" khi người dùng bấm tải sách (Download) từ giao diện Web.

[PhDLeToanThang]

Tôi đang chạy Calibre-Web chạy qua lệnh Python script,

• Hệ thống này phục vụ cho nhiều người khác cùng truy cập qua mạng internet khoảng 40K account và khoảng 10K / ccu.

---

Với quy mô 400K sách, 40K tài khoản và đặc biệt là 10K CCU (người dùng đồng thời), hệ thống của bạn đã thuộc cấp độ Doanh nghiệp (Enterprise). Việc chạy trực tiếp lệnh Python script (python cps.py) trên Windows bằng bộ thư viện mặc định chắc chắn sẽ gây sập, nghẽn mạng (Timeout) hoặc treo CPU 100% ngay khi chạm ngưỡng vài trăm CCU.
Lý do là máy chủ WSGI tích hợp sẵn của Python (như Werkzeug) chỉ là môi trường thử nghiệm đơn luồng, không thể chịu tải mức độ này. Dưới đây là kiến trúc bắt buộc phải triển khai trên Windows để gánh được 10K CCU.

I. Thay đổi kiến trúc chạy Python (Bắt buộc để chịu tải CCU)

Tuyệt đối không dùng lệnh python cps.py trực tiếp cho môi trường Production 10K CCU. Bạn cần chuyển sang mô hình: Reverse Proxy (Nginx) $\rightarrow$ WSGI Server (Waitress) $\rightarrow$ Calibre-Web.

1. Sử dụng Waitress làm Web Server Production cho Python trên Windows

Waitress là một WSGI server thuần Python được thiết kế riêng cho Windows, chạy đa luồng rất mạnh mẽ và ổn định, chịu được lượng kết nối đồng thời cực lớn.

• Bước 1: Cài đặt Waitress qua CMD: pip install waitress
• Bước 2: Thay vì chạy python cps.py, bạn tạo một file tên là run_server.py đặt chung thư mục với Calibre-Web có nội dung:

from waitress import servefrom cps import appif name == 'main':
# Chạy với 50 luồng xử lý đồng thời, cổng 8083
serve(app, host='127.0.0.1', port=8083, threads=50, connection_limit=20000)

• Bước 3: Chạy hệ thống bằng lệnh: python run_server.py

2. Sử dụng Nginx cho Windows làm Reverse Proxy chống nghẽn

Nginx sẽ đứng ở "đầu chiến tuyến" để nhận 10K CCU từ Internet, gánh toàn bộ phần tải tĩnh (hình ảnh, CSS, JS), sau đó mới điều hướng các yêu cầu tìm kiếm về cho Python xử lý.

• Tải Nginx cho Windows, cấu hình file nginx.conf để bật tính năng Gzip nén dữ liệu (giúp tiết kiệm băng thông khi có 10K người truy cập) và chuyển tiếp cổng:

upstream calibre_backend {
server 127.0.0.1:8083;
}
server {
listen 80; # Hoặc 443 nếu dùng SSL
server_name your_domain.com;

# Tối ưu hóa tải ảnh cover (Rất quan trọng với 400K sách)
location /cache {
    root C:/path/to/calibre-web/app; # Đường dẫn lưu cache ảnh của calibre-web
    expires 7d;
}

location / {
    proxy_pass http://calibre_backend;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_read_timeout 600s; # Tránh lỗi Timeout khi 10K người cùng tìm kiếm
}

}

---

II. Tối ưu hóa Database (SQLite) cho 400K sách và 10K CCU

Mặc định Calibre dùng SQLite (file metadata.db). SQLite quản lý việc ĐỌC (Read) của 10K CCU rất tốt, nhưng nó sẽ bị Khóa toàn bộ database (Database Locked) nếu có nhiều người cùng thực hiện hành động GHI (Write) như: đăng ký tài khoản, đánh dấu sách đã đọc, hoặc sửa metadata.

1. Kích hoạt chế độ WAL (Write-Ahead Logging) cho SQLite

Đây là tùy chỉnh sống còn để SQLite vừa cho phép đọc, vừa cho phép ghi đồng thời mà không gây lỗi sập web.

• Cách làm: Tải phần mềm DB Browser for SQLite, mở file metadata.db (và file app.db của Calibre-Web nếu có).
• Vào mục Execute SQL và chạy lệnh:

PRAGMA journal_mode=WAL;
PRAGMA synchronous=NORMAL;

• Bấm Write Changes để lưu lại. Tốc độ ghi dữ liệu sẽ tăng gấp 10 lần.

2. Tách cơ sở dữ liệu người dùng của Calibre-Web ngoài ổ D

Tránh để file app.db (chứa 40K account) ở ổ C. Trong giao diện Admin của Calibre-Web, hãy cấu hình đường dẫn DB Configuration lưu file app.db ngay tại ổ D (SSD) chung với thư viện sách để tối ưu tốc độ đọc/ghi tài khoản.

III. Tối ưu hóa Hệ điều hành Windows Server cho 10K CCU

Windows mặc định giới hạn số lượng kết nối mạng đồng thời (Ephemeral Ports), dẫn đến việc người dùng thứ 5001 trở đi sẽ bị báo lỗi "Không thể kết nối".

1. Mở rộng dải cổng mạng kết nối (MaxUserPort)

• Nhấn Windows + R, gõ regedit. Tìm đến:
  HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters
• Click chuột phải $\rightarrow$ New $\rightarrow$ DWORD (32-bit) Value. Đặt tên là MaxUserPort.
• Click đúp vào, chọn Decimal và nhập giá trị: 65534.

2. Giảm thời gian chờ giải phóng cổng treo (TcpTimedWaitDelay)

• Cũng tại đường dẫn Registry trên, tạo tiếp một DWORD (32-bit) Value tên là TcpTimedWaitDelay.
• Click đúp vào, chọn Decimal và nhập giá trị: 30 (Giảm từ 240 giây xuống 30 giây để Windows giải phóng cổng kết nối cũ nhanh hơn, nhường chỗ cho CCU mới).

---

IV. Chiến lược xử lý tải file EPUB/PDF khi Download

Khi có 10K người dùng, nếu họ bấm Tải (Download) cùng lúc các file PDF dung lượng lớn (50MB - 100MB), băng thông máy chủ và CPU sẽ bị nghẽn hoàn toàn.

• Giải pháp: Sử dụng tính năng X-Accel-Redirect của Nginx. Tính năng này cho phép Calibre-Web chỉ làm nhiệm vụ kiểm tra quyền đăng nhập, sau đó bàn giao toàn bộ việc truyền tải file PDF/EPUB cho Nginx xử lý trực tiếp dưới tầng đĩa cứng.
• Cách kích hoạt: Trong giao diện Admin của Calibre-Web $\rightarrow$ Edit Basic Configuration $\rightarrow$ Tìm mục Server Configuration $\rightarrow$ Tích chọn Enable External Image Cache / X-Accel-Redirect.

---

Để hệ thống hoạt động an toàn nhất trong quá trình chuyển đổi cấu trúc cấu hình lớn này, bạn có muốn tôi hỗ trợ:

• Viết file Script tự động (Batch file) để khởi động toàn bộ hệ thống gồm Nginx, Waitress cùng lúc khi Windows bật lên không?
• Cấu hình Cloudflare đứng trước Nginx để giảm tải 80% băng thông tải ảnh bìa (Cover) cho máy chủ Windows của bạn không?