Chuyển đến nội dung

paperless-ngx / paperless-ngx

Paperless-ngx

Hệ thống quản lý tài liệu tự cài: scan giấy tờ, tự OCR, gắn thẻ và tìm lại trong vài giây

Paperless-ngx biến đống giấy tờ, hoá đơn, hợp đồng của bạn thành một kho lưu trữ số tìm kiếm được, chạy trên máy hoặc máy chủ của chính bạn. Dự án do cộng đồng duy trì, là bản kế nhiệm chính thức của Paperless và Paperless-ng, cài dễ nhất bằng Docker Compose.

  • 48.151 sao
  • 3.388 fork
  • Python
  • Cập nhật hôm nay
  • GPL 3.0 (sửa đổi phải công bố mã)
Độ khó
Vừa Cần gõ vài lệnh hoặc dùng Docker
Dạng
Web tự cài (self-host)
Chạy trên
Docker, Linux, Web
Chi phí
Miễn phí hoàn toàn

Trải nghiệm khi dùng Paperless-ngx

Bạn cài Paperless-ngx bằng Docker, mở nó trong trình duyệt và có một trang quản lý tài liệu. Việc đưa tài liệu vào khá đơn giản: tải file lên trên web hoặc thả file scan vào một thư mục được theo dõi. Hệ thống tự đọc chữ trong file (OCR), lưu bản gốc và bắt đầu lập chỉ mục để sau này bạn tìm theo nội dung.

Thay vì nhớ file nằm ở thư mục nào, bạn gõ từ khoá như tên công ty hay số hợp đồng và ra ngay kết quả. Bạn gắn thẻ, chọn người gửi, loại tài liệu, và hệ thống có thể học dần cách phân loại các tài liệu mới. Đó là cảm giác 'ít giấy hơn' mà cái tên Paperless hướng tới.

Điều cần lưu ý là bạn tự làm chủ cả hệ thống: tự cài, tự cập nhật, tự sao lưu. Chính README cũng cảnh báo giấy tờ scan thường rất nhạy cảm nên cách an toàn nhất là chạy trên máy chủ cục bộ ở nhà với bản sao lưu đầy đủ.

Tính năng nổi bật

OCR và lưu trữ tài liệu scan

Biến ảnh scan, PDF giấy tờ thành tài liệu có thể tìm theo nội dung, giữ nguyên bản gốc.

Tìm kiếm toàn văn

Gõ từ trong nội dung để tìm hoá đơn, hợp đồng, thư từ cũ mà không phải nhớ tên file.

Thẻ, người gửi, loại tài liệu

Sắp xếp tài liệu thành nhóm gọn gàng; hệ thống hỗ trợ gợi ý phân loại cho tài liệu mới.

Cài bằng Docker Compose

Có sẵn tệp cấu hình và một script cài đặt giúp dựng hệ thống nhanh trên máy chủ.

Nhiều ngôn ngữ giao diện

Giao diện được cộng đồng dịch sang nhiều thứ tiếng qua Crowdin.

Cộng đồng đông, tài liệu rõ

Có trang demo, tài liệu đầy đủ tại docs.paperless-ngx.com và hướng dẫn nâng cấp từ Paperless-ng.

Tận dụng Paperless-ngx vào việc gì?

Gia đình, người hay mất giấy tờ

Số hoá giấy tờ gia đình

Scan hoá đơn điện nước, bảo hành, sổ khám bệnh, giấy tờ nhà đất và tìm lại bằng từ khoá khi cần.

Chủ shop nhỏ, kế toán

Lưu hoá đơn, chứng từ cho kế toán

Thả hoá đơn scan vào kho, gắn thẻ theo tháng hoặc nhà cung cấp để cuối kỳ tìm và đối chiếu nhanh.

Văn phòng, doanh nghiệp nhỏ

Kho hồ sơ văn phòng nhỏ

Lưu hợp đồng, biên bản, hồ sơ nhân sự trên máy chủ nội bộ thay vì để rải rác trên nhiều ổ đĩa.

Sinh viên, giảng viên

Lưu trữ tài liệu học tập, nghiên cứu

Gom sách, bài báo, ghi chú scan vào một nơi và tìm theo nội dung.

Cần chuẩn bị gì?

  • Một máy chủ hoặc máy tính chạy được Docker và Docker Compose (Linux là phổ biến nhất; Windows và macOS dùng Docker Desktop).
  • Biết mở Terminal và chạy vài lệnh; sẵn sàng đọc tài liệu cài đặt để chọn cấu hình.
  • Ổ cứng đủ chỗ cho tài liệu gốc và chỉ mục, cùng một nơi sao lưu riêng.
  • Nên đặt trong mạng nội bộ tin cậy, không phơi trực tiếp ra Internet nếu chưa hiểu về bảo mật.

Hướng dẫn cài đặt chi tiết

Cài trên Docker (script, dễ nhất)

  1. Cài Docker và Docker Compose trước (macOS cần thêm GNU sed và wget). Sau đó chạy script cài đặt của dự án trong Terminal; script hỏi vài câu cấu hình, tạo các file cần thiết, kéo image, khởi động container và tạo luôn tài khoản superuser (quản trị) cho bạn. Nên đọc script trước khi chạy vì đây là tải về và chạy thẳng.

    Terminal
    bash -c "$(curl --location --silent --show-error https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/install-paperless-ngx.sh)"
  2. Trả lời các câu hỏi hiện ra, gồm thông tin tài khoản quản trị và nơi lưu dữ liệu. Hãy nhớ tên và mật khẩu bạn đặt.

  3. Xong, mở trình duyệt vào địa chỉ dưới (hoặc địa chỉ tương tự theo cấu hình) và đăng nhập bằng tài khoản vừa tạo. Superuser có toàn quyền với mọi tài liệu, nên về sau bạn có thể tạo thêm tài khoản thường để dùng hằng ngày.

    Văn bản
    http://127.0.0.1:8000

Cài trên Docker Compose (thủ công)

  1. Vào thư mục docker/compose của repo trên GitHub, tải một file docker-compose.*.yml theo cơ sở dữ liệu bạn muốn rồi lưu thành docker-compose.yml trong một thư mục trống; tải thêm docker-compose.env và .env vào cùng thư mục. Docs khuyên cài mới nên dùng PostgreSQL; muốn hỗ trợ file Office thì chọn file có chữ tika trong tên.

    Văn bản
    https://github.com/paperless-ngx/paperless-ngx/tree/main/docker/compose
  2. Sửa docker-compose.yml nếu cần. Ví dụ đổi thư mục consume (nơi bạn thả file để Paperless tự nhập) bằng cách thay phần trước dấu hai chấm; đổi cổng web mặc định 8000 bằng dòng ports.

    YAML
    - /DUONG/DAN/THU/MUC/NHAP:/usr/src/paperless/consume
    
    ports:
      - 8010:8000
  3. Sửa docker-compose.env theo nhu cầu. Nếu UID và GID người dùng trên máy bạn không phải 1000, đặt USERMAP_UID và USERMAP_GID bằng kết quả của hai lệnh dưới để cả container lẫn bạn đều ghi được vào thư mục consume.

    Terminal
    id -u
    id -g
  4. Kéo image (mặc định từ GitHub Container Registry) rồi khởi động.

    Terminal
    docker compose pull
    docker compose up -d
  5. Mở địa chỉ dưới. Lần đầu truy cập, trang sẽ yêu cầu bạn tạo tài khoản superuser.

    Văn bản
    http://127.0.0.1:8000
  6. Cập nhật: theo docs, đổi tag image rồi chạy lại docker compose pull và docker compose up -d để kéo image mới và tạo lại container. Các tuỳ chọn khác (cài trực tiếp không Docker, chạy trên máy yếu) xem tài liệu cài đặt chính thức.

    Văn bản
    https://docs.paperless-ngx.com/setup/

Dùng thử lần đầu

  1. Mở Paperless-ngx trong trình duyệt và đăng nhập. Nếu muốn xem trước giao diện, dự án có trang demo ở demo.paperless-ngx.com (tài khoản demo, nhưng đừng tải tài liệu bí mật lên đó vì nội dung bị reset thường xuyên).

  2. Tải lên một vài file scan hoặc PDF thử, hoặc chép chúng vào thư mục được theo dõi nếu bạn đã cấu hình. Chờ hệ thống xử lý xong.

  3. Mở một tài liệu, kiểm tra chữ nhận dạng được, rồi gắn thẻ, người gửi và loại tài liệu.

  4. Thử tìm kiếm theo một từ nằm trong nội dung tài liệu để thấy lợi ích của OCR.

  5. Thiết lập sao lưu định kỳ cho dữ liệu trước khi đưa tài liệu thật vào.

Mẹo dùng hay

  • Lên kế hoạch sao lưu ngay từ đầu: bản gốc tài liệu, cơ sở dữ liệu và tệp cấu hình đều cần được sao lưu.
  • Dùng chung bộ máy scan: máy scan có chức năng gửi vào thư mục mạng sẽ giúp bạn thả file thẳng vào kho mà không phải tải thủ công.
  • Khi dùng tiếng Việt, hãy kiểm tra cài đặt ngôn ngữ OCR trong tài liệu để dấu được nhận dạng tốt hơn.

Lưu ý và hạn chế

  • README cảnh báo rõ: không chạy Paperless-ngx trên máy chủ không đáng tin cậy, vì thông tin được lưu dạng chữ thường, không mã hoá, và dự án không đảm bảo an toàn tuyệt đối.
  • Cần tự bảo trì: cập nhật phiên bản, sao lưu và kiểm tra dung lượng ổ đĩa là việc của bạn.
  • Giấy phép GPL-3.0; nếu bạn định chỉnh sửa và phân phối lại thì cần đọc kỹ điều khoản.

Câu hỏi thường gặp

Paperless-ngx có đọc được tiếng Việt không?

Dự án dùng OCR để đọc chữ trong tài liệu scan; để đọc tiếng Việt cần bật đúng ngôn ngữ OCR theo tài liệu hướng dẫn, và chất lượng phụ thuộc vào độ rõ của bản scan.

Có miễn phí và có cần đăng ký tài khoản ngoài không?

Hoàn toàn miễn phí, mã nguồn mở. Bạn tự cài trên máy của mình và không cần tài khoản dịch vụ nào bên ngoài.

Máy yếu hoặc Raspberry Pi có chạy được không?

Có thể chạy trên cấu hình khiêm tốn, nhưng OCR là việc tốn CPU nên tài liệu nhiều trang sẽ xử lý chậm. Xem yêu cầu và gợi ý cấu hình trong tài liệu chính thức.

Tải mã nguồn về máy

Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.

Terminal
git clone https://github.com/paperless-ngx/paperless-ngx.git

Repo tương tự nên xem

Tài liệu, OCR & hỏi đáp tri thức35,3K

OCRmyPDF

ocrmypdf / OCRmyPDF

Biến PDF scan thành PDF có lớp chữ, tìm kiếm và sao chép được, chỉ với một lệnh

VừaWindowsmacOSLinuxDocker+1
Video, nhạc & tải xuống119K

Immich

immich-app / immich

Kho ảnh và video riêng của gia đình bạn: tự động sao lưu từ điện thoại, tìm theo khuôn mặt và nội dung

VừaDockerWebAndroidiOS+1
Tài liệu, OCR & hỏi đáp tri thức77,5K

Tesseract OCR

tesseract-ocr / tesseract

Bộ máy nhận dạng chữ (OCR) mã nguồn mở đọc chữ từ ảnh scan, hỗ trợ hơn 100 ngôn ngữ

VừaWindowsmacOSLinux

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: Tài liệu, OCR & hỏi đáp tri thức

Tài liệu, OCR & hỏi đáp tri thức196K

MarkItDown

microsoft / markitdown

Công cụ của Microsoft đổi PDF, Word, Excel, PowerPoint và nhiều file khác thành Markdown cho AI đọc.

VừaWindowsmacOSLinuxPython
Tài liệu, OCR & hỏi đáp tri thức96,8K

Stirling PDF

Stirling-Tools / Stirling-PDF

Bộ hơn 50 công cụ PDF: gộp, tách, ký, che thông tin, nén, OCR, chạy trên máy hoặc tự cài.

DễWindowsmacOSLinuxDocker+1
Tài liệu, OCR & hỏi đáp tri thức94,2K

RAGFlow

infiniflow / ragflow

Nền tảng tự cài giúp AI trả lời dựa trên tài liệu của bạn, có trích dẫn nguồn.

VừaDockerLinuxWeb
Tài liệu, OCR & hỏi đáp tri thức92,7K

PaddleOCR

PaddlePaddle / PaddleOCR

Bộ công cụ OCR của Baidu: đọc chữ trong ảnh, PDF và đổi tài liệu thành Markdown hoặc JSON.

KhóWindowsmacOSLinuxPython
Tài liệu, OCR & hỏi đáp tri thức83,7K

MinerU

opendatalab / MinerU

Đọc PDF, ảnh scan và file Office rồi xuất Markdown, giữ bảng, công thức và bố cục phức tạp.

VừaWindowsmacOSLinuxDocker+1
Tài liệu, OCR & hỏi đáp tri thức70,6K

Docling

docling-project / docling

Chuyển PDF, Word, PowerPoint, Excel, HTML thành Markdown hoặc JSON gọn gàng để đưa cho AI đọc

VừaWindowsmacOSLinuxPython

Xem cả 22 repo Tài liệu, OCR & hỏi đáp tri thức Về Kho Repo