Chuyển đến nội dung

photoprism / photoprism

PhotoPrism

Thư viện ảnh và video riêng tự cài trên máy của bạn, có AI gắn nhãn, nhận diện mặt và bản đồ

PhotoPrism là ứng dụng web để duyệt, sắp xếp và chia sẻ ảnh, video do bạn tự cài (self-host) bằng Docker. Nó dùng AI để gắn nhãn nội dung, nhận diện khuôn mặt, đặt ảnh lên bản đồ, giúp bạn tìm lại ảnh cũ nhanh và không phải đưa ảnh gia đình lên dịch vụ của bên thứ ba.

  • 40.456 sao
  • 2.339 fork
  • Go
  • Cập nhật hôm qua
  • Giấy phép riêng, xem trên GitHub
Độ 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, macOS, Windows, Web
Chi phí
Miễn phí, có bản trả phí

Trải nghiệm khi dùng PhotoPrism

Bạn cài PhotoPrism qua Docker trên một máy tính, NAS hoặc Raspberry Pi, rồi mở nó trong trình duyệt. Sau khi trỏ vào thư mục chứa ảnh, ứng dụng quét, đọc thông tin chụp và dựng thành một thư viện đẹp mắt có thể duyệt theo dòng thời gian, địa điểm, nhãn hay màu sắc.

Điều thú vị là khả năng tìm kiếm. Bạn gõ bộ lọc hoặc từ khoá và PhotoPrism trả về ảnh theo nội dung, nơi chụp, độ phân giải, màu. Ứng dụng cũng tự gắn nhãn dựa trên nội dung ảnh và nhận diện khuôn mặt người thân, ảnh Live Photo tự chạy khi bạn rê chuột qua.

Giao diện là ứng dụng web có thể cài lên màn hình chính điện thoại như một app (PWA). Để sao lưu ảnh từ điện thoại, README gợi ý dùng các ứng dụng tương thích như PhotoSync, hoặc kết nối qua WebDAV từ máy tính.

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

Duyệt ảnh RAW và nhiều định dạng video

Xem ảnh RAW và video mà không phải lo định dạng, ứng dụng xử lý để hiển thị trơn tru.

Tìm kiếm bằng bộ lọc mạnh

Kết hợp nhiều bộ lọc như nhãn, vị trí, độ phân giải, màu sắc và chất lượng để tìm chính xác ảnh cần.

Tự gắn nhãn và nhận diện mặt

Gắn nhãn ảnh theo nội dung và địa điểm, nhận ra gương mặt người thân, bạn bè trong thư viện.

Bản đồ và địa điểm

Đặt ảnh lên bản đồ để xem lại các chuyến đi, dịch vụ định vị theo hướng bảo vệ riêng tư.

Ứng dụng web cài như app

Dùng được trên điện thoại, máy tính bảng và máy tính, có thể thêm vào màn hình chính như PWA.

Kết nối WebDAV

Máy tính có thể kết nối thư viện qua WebDAV, mở, sửa, xoá file như thư mục cục bộ.

Tận dụng PhotoPrism vào việc gì?

Gia đình có nhiều ảnh, video cũ

Kho ảnh gia đình riêng tư

Gom ảnh từ điện thoại, máy ảnh và ổ cứng cũ vào một nơi, tìm lại ảnh cưới, ảnh thôi nôi theo người và địa điểm.

Chủ shop, nhiếp ảnh gia

Lưu trữ ảnh sản phẩm, ảnh chụp công việc

Sắp xếp ảnh sản phẩm, ảnh chụp sự kiện theo nhãn và thời gian, tìm nhanh khi cần làm catalogue.

Người quan tâm quyền riêng tư

Chuyển từ dịch vụ ảnh đám mây

README nói có thể gộp metadata từ nhiều nguồn như Google Photos, giúp bạn tự kiểm soát bộ ảnh của mình.

Người hay đi du lịch

Xem lại hành trình du lịch

Mở bản đồ để xem ảnh theo từng nơi bạn đã đi qua, rất hợp để làm album chuyến đi.

Cần chuẩn bị gì?

  • Một máy chạy Docker (Windows, macOS hoặc Linux), NAS hỗ trợ Docker hoặc Raspberry Pi. Image hỗ trợ CPU 64-bit AMD, Intel và ARM.
  • Một trình duyệt web để quản lý, hiểu cơ bản về Docker và thư mục trên máy chủ.
  • Dung lượng ổ cứng đủ chứa thư viện ảnh. Yêu cầu RAM và CPU cụ thể xem trong tài liệu Getting Started chính thức.
  • Một số tính năng bổ sung dành cho thành viên trả phí; bản cộng đồng miễn phí.

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

Cài trên Docker Compose (Linux)

  1. Cài Docker (có Docker Compose) lên máy chủ, rồi tạo một thư mục riêng cho PhotoPrism và đứng trong đó. Tải file compose.yaml mẫu chính thức.

    Terminal
    mkdir photoprism && cd photoprism
    wget https://dl.photoprism.app/docker/compose.yaml
  2. Mở compose.yaml bằng trình soạn thảo và sửa các dòng sau. PHOTOPRISM_ADMIN_PASSWORD là mật khẩu quản trị bạn tự đặt (tối thiểu 8 ký tự); MARIADB_PASSWORD là mật khẩu cơ sở dữ liệu (không đổi được sau lần khởi động đầu). Dòng volume đầu trỏ thư mục ảnh của bạn vào /photoprism/originals (mặc định là ~/Pictures). Thư mục ./storage lưu cấu hình, cache, bản sao lưu và ảnh thu nhỏ nên phải giữ lâu dài.

    YAML
    PHOTOPRISM_ADMIN_PASSWORD: "MAT_KHAU_CUA_BAN"
    MARIADB_PASSWORD: "MAT_KHAU_DATABASE"
    # phần volumes:
    - "/DUONG/DAN/THU/MUC/ANH:/photoprism/originals"
    - "./storage:/photoprism/storage"
  3. Khởi động dịch vụ chạy nền.

    Terminal
    docker compose up -d
  4. Mở trình duyệt vào địa chỉ sau. Đăng nhập bằng tên admin và mật khẩu bạn đặt ở PHOTOPRISM_ADMIN_PASSWORD (biến này chỉ có tác dụng ở lần chạy đầu tiên).

    Văn bản
    http://localhost:2342
  5. Đổi mật khẩu quản trị về sau bằng lệnh đầu tiên dưới đây. Cập nhật: kéo image mới rồi khởi động lại. Dừng dịch vụ bằng docker compose stop.

    Terminal
    docker compose exec photoprism photoprism passwd admin
    
    docker compose pull
    docker compose stop
    docker compose up -d
  6. Docs còn có file compose riêng cho Windows, macOS, Podman và ARM; xem các tuỳ chọn nâng cao ở trang chính thức.

    Văn bản
    https://docs.photoprism.app/getting-started/docker-compose/

Cài trên Raspberry Pi và các cách khác

  1. Raspberry Pi và máy ARM làm theo cùng các bước Docker Compose nhưng dùng file compose dành cho ARM64 (hoặc ARMv7 với Pi đời cũ), liệt kê ở trang hướng dẫn riêng.

    Văn bản
    https://docs.photoprism.app/getting-started/raspberry-pi/
  2. Nếu bị thiếu RAM khi lập chỉ mục, docs gợi ý giảm biến PHOTOPRISM_WORKERS trong compose.yaml. Muốn cài không dùng Docker, xem mục FAQ của Getting Started.

    Văn bản
    https://docs.photoprism.app/getting-started/

Dùng thử lần đầu

  1. Mở thử bản demo công khai của PhotoPrism để xem giao diện trước khi cài (đừng tải ảnh riêng tư lên bản demo).

  2. Đăng nhập vào máy chủ của bạn ở http://localhost:2342 bằng tài khoản admin và mật khẩu đã đặt trong compose.yaml.

  3. Chép ảnh vào thư mục bạn đã gắn vào /photoprism/originals, rồi vào mục Library, tab Index và bấm Start để PhotoPrism quét ảnh.

  4. Duyệt theo dòng thời gian, thử tìm ảnh bằng bộ lọc nhãn hoặc địa điểm.

  5. Mở ứng dụng web trên điện thoại và thêm vào màn hình chính nếu muốn dùng như một app.

Mẹo dùng hay

  • Sao lưu cả ảnh gốc và cơ sở dữ liệu của PhotoPrism; AI gắn nhãn không thay cho bản sao lưu ảnh.
  • Đặt mật khẩu quản trị mạnh nếu máy chủ có thể truy cập từ ngoài mạng nhà.
  • Dùng ứng dụng tương thích như PhotoSync để tự đẩy ảnh từ điện thoại lên thư viện.

Lưu ý và hạn chế

  • Đây là phần mềm máy chủ, cần biết Docker và quản lý thư mục. Không đơn giản như cài một app thông thường.
  • Một số tính năng như bản đồ tương tác nằm ở gói thành viên trả phí; bản cộng đồng có giới hạn.
  • Nhận diện khuôn mặt xử lý dữ liệu riêng tư; hãy chỉ dùng cho ảnh của gia đình, bạn bè đã đồng ý và giữ máy chủ an toàn.

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

PhotoPrism có miễn phí không?

Có bản cộng đồng miễn phí tự cài. Dự án cũng có gói thành viên trả phí để mở thêm một số tính năng và duy trì phát triển.

Ảnh của tôi có bị gửi đi đâu không?

Dự án khẳng định không bán dữ liệu và ảnh của bạn không bị chia sẻ cho Google, Amazon, Microsoft hay Apple trừ khi bạn tự tải lên dịch vụ của họ.

So với Immich thì sao?

Cả hai đều là thư viện ảnh tự cài. Hãy đọc mô tả từng dự án và thử cả hai để chọn cái hợp cách bạn sao lưu ảnh từ điện thoại.

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/photoprism/photoprism.git

Repo tương tự nên xem

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
Bảo mật & quyền riêng tư30,2K

Ente

ente / ente

Lưu ảnh, mã 2FA và giấy tờ trên đám mây với mã hoá đầu cuối, mã nguồn mở và có thể tự host

VừaAndroidiOSWindowsmacOS+3
Video, nhạc & tải xuống59,4K

Jellyfin

jellyfin / jellyfin

Tự lập thư viện phim, nhạc, ảnh của riêng bạn để xem trên TV, điện thoại và trình duyệt

VừaWindowsmacOSLinuxDocker

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ủ đề: Video, nhạc & tải xuống

Video, nhạc & tải xuống208K

yt-dlp

yt-dlp / yt-dlp

Công cụ dòng lệnh tải video và âm thanh từ YouTube cùng hàng nghìn trang web khác

VừaWindowsmacOSLinuxPython
Video, nhạc & tải xuống67,4K

FFmpeg

FFmpeg / FFmpeg

Bộ công cụ dòng lệnh để chuyển đổi, cắt, ghép và xử lý video, âm thanh mọi định dạng

VừaWindowsmacOSLinux
Video, nhạc & tải xuống58,4K

Motrix

agalwood / Motrix

Trình quản lý tải file gọn đẹp: link thường, torrent và magnet trong một giao diện

DễWindowsmacOSLinuxDocker
Video, nhạc & tải xuống50,8K

Spotube

team-spotube / spotube

Ứng dụng nghe nhạc mã nguồn mở chạy bằng plugin, có trên máy tính và điện thoại

VừaWindowsmacOSLinuxAndroid
Video, nhạc & tải xuống46,3K

cobalt

imputnet / cobalt

Dán link, nhận file: công cụ tải video và âm thanh không quảng cáo, không theo dõi

VừaWebDockerNode.js
Video, nhạc & tải xuống46,1K

LosslessCut

mifi / lossless-cut

Cắt, ghép video và âm thanh trong tích tắc mà không nén lại, không mất chất lượng

DễWindowsmacOSLinux

Xem cả 20 repo Video, nhạc & tải xuống Về Kho Repo