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)
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.
bash -c "$(curl --location --silent --show-error https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/install-paperless-ngx.sh)"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.
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.
http://127.0.0.1:8000
Cài trên Docker Compose (thủ công)
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.
https://github.com/paperless-ngx/paperless-ngx/tree/main/docker/composeSử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.
- /DUONG/DAN/THU/MUC/NHAP:/usr/src/paperless/consume ports: - 8010:8000Sử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.
id -u id -gKéo image (mặc định từ GitHub Container Registry) rồi khởi động.
docker compose pull docker compose up -dMở đị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.
http://127.0.0.1:8000Cậ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.
https://docs.paperless-ngx.com/setup/
Dùng thử lần đầu
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).
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.
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.
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.
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.
git clone https://github.com/paperless-ngx/paperless-ngx.gitRepo tương tự nên xem
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
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
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ữ