Chuyển đến nội dung

immich-app / immich

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

Immich là phần mềm tự cài (self-host) để quản lý ảnh và video trên máy chủ của chính bạn, giao diện và cách dùng gần giống Google Photos. Điện thoại tự động tải ảnh lên, rồi bạn xem theo dòng thời gian, tìm theo người, địa điểm hoặc mô tả, và chia sẻ album cho người thân.

  • 119.313 sao
  • 7.617 fork
  • TypeScript
  • Cập nhật hôm qua
  • AGPL 3.0 (chạy dịch vụ cũng 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), Ứng dụng điện thoại
Chạy trên
Docker, Web, Android, iOS, Linux
Chi phí
Miễn phí hoàn toàn

Trải nghiệm khi dùng Immich

Bạn dựng Immich bằng Docker Compose trên một máy chủ nhà (mini PC, NAS hoặc VPS), mở trang web của nó trong trình duyệt và tạo tài khoản quản trị đầu tiên. Sau đó bạn cài ứng dụng Immich trên điện thoại, nhập địa chỉ máy chủ, đăng nhập và chọn album cần sao lưu. Ảnh mới chụp sẽ được tải lên tự động.

Khi ảnh đã vào kho, bạn thấy một dòng thời gian cuộn mượt, bản đồ địa điểm, lọc theo người (nhờ nhận diện khuôn mặt) và ô tìm kiếm hiểu nội dung, ví dụ gõ biển, bánh sinh nhật, Đà Lạt. Mục kỷ niệm sẽ nhắc những bức ảnh của các năm trước vào đúng ngày hôm nay.

Phần khó nhất là chuẩn bị máy chủ: cài Docker, sửa file cấu hình, lo ổ cứng và sao lưu. Immich cũng nhắc rõ trong README: hãy luôn theo quy tắc sao lưu 3-2-1, đừng coi nó là nơi duy nhất giữ ảnh quý giá.

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

Tự sao lưu từ điện thoại

Ứng dụng Android và iOS tự tải ảnh, video lên máy chủ, có chọn album cần sao lưu, chống trùng lặp và sao lưu nền.

Tìm kiếm thông minh

Tìm theo thông tin kèm theo ảnh (EXIF), đối tượng, khuôn mặt và cả mô tả bằng lời nhờ mô hình CLIP.

Nhận diện và gom nhóm khuôn mặt

Tự gom các ảnh của cùng một người để bạn đặt tên và xem lại mọi bức ảnh của họ.

Album, chia sẻ và nhiều người dùng

Mỗi thành viên gia đình có tài khoản riêng, tạo album chung, chia sẻ công khai bằng liên kết hoặc chia sẻ với đối tác.

Xem được nhiều loại tệp

Hỗ trợ file RAW, Live Photo/Motion Photo, bản đồ ảnh toàn cầu, kỷ niệm của các năm trước.

Đăng nhập OAuth và API

README nêu hỗ trợ OAuth và API key, dễ tích hợp với hệ thống đăng nhập nội bộ hoặc công cụ tự động hoá.

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

Gia đình, người chụp ảnh nhiều

Thay thế dịch vụ lưu ảnh trả phí

Lưu ảnh của cả nhà trên ổ cứng riêng thay vì thuê dung lượng đám mây hàng tháng, vẫn xem được trên điện thoại ở mọi nơi nếu cấu hình truy cập từ xa.

Người ghi lại kỷ niệm

Gom ảnh du lịch, đám cưới, sinh nhật

Mọi người trong chuyến đi cùng tải ảnh vào một album chung, ai cũng xem và tải về được.

Người làm YouTube, nhiếp ảnh

Kho ảnh, video thô cho người làm nội dung

Lưu trữ ảnh RAW và video với tìm kiếm theo nội dung, tiện lục lại tư liệu cũ.

Dân IT, người thích tự lưu trữ

Học cách tự dựng dịch vụ riêng

Dự án phù hợp để thực hành Docker Compose, Postgres và quản lý máy chủ tại nhà.

Doanh nghiệp nhỏ, studio

Quản lý ảnh trên mạng nội bộ

Đặt máy chủ trong văn phòng để cả nhóm chia sẻ ảnh sản phẩm, sự kiện mà không đưa lên dịch vụ ngoài.

Cần chuẩn bị gì?

  • Theo tài liệu: Linux 64-bit (Ubuntu, Debian...) được khuyến nghị; Windows và macOS dùng được qua Docker Desktop hoặc WSL 2 nhưng không được khuyến khích.
  • RAM tối thiểu 6GB, khuyến nghị 8GB; CPU tối thiểu 2 nhân, khuyến nghị 4 nhân. Máy 4GB RAM chỉ chạy được khi tắt tính năng máy học.
  • Docker kèm Docker Compose plugin (dùng lệnh docker compose, không phải docker-compose cũ).
  • Ổ cứng đủ chứa kho ảnh (bản thumbnail và video chuyển mã có thể tăng thêm khoảng 10-20%); cơ sở dữ liệu Postgres nên nằm trên SSD gắn trong máy, không đặt trên thư mục mạng.

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

Cài trên Docker Compose

  1. Cài Docker kèm Compose plugin. Tạo một thư mục riêng cho Immich rồi vào thư mục đó (lệnh dưới dùng bash trên Linux, macOS hoặc WSL).

    Terminal
    mkdir ./immich-app
    cd ./immich-app
  2. Tải file docker-compose.yml và file mẫu cấu hình về, đổi tên file mẫu thành .env.

    Terminal
    wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
    wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env
  3. Mở file .env bằng trình soạn thảo và chỉnh: UPLOAD_LOCATION là thư mục lưu ảnh (một thư mục mới còn nhiều chỗ trống), DB_PASSWORD nên đổi sang mật khẩu riêng (chỉ nên dùng chữ và số), và bỏ dấu chú thích ở dòng TZ để đặt múi giờ.

  4. Khởi động Immich chạy nền. Lần đầu sẽ tải nhiều image nên cần chờ một lúc.

    Terminal
    docker compose up -d
  5. Mở trình duyệt vào địa chỉ máy chủ ở cổng mặc định 2283 của Immich (http://localhost:2283 nếu mở ngay trên máy chủ, hoặc http://IP-MÁY-CHỦ:2283 từ máy khác trong nhà) và tạo tài khoản quản trị đầu tiên.

Cài trên Windows (qua Docker Desktop)

  1. Tài liệu cho phép dùng Docker Desktop hoặc WSL 2 trên Windows nhưng không khuyến khích. Thư mục dữ liệu Postgres không được nằm trên ổ NTFS hay thư mục gắn /mnt của WSL.

  2. Nếu gặp lỗi đó, tài liệu hướng dẫn đổi DB_DATA_LOCATION trong file .env sang tên một Docker volume và thêm volume đó vào cuối docker-compose.yml.

    Cấu hình
    DB_DATA_LOCATION=pgdata
  3. Các bước còn lại giống tab Docker Compose, chạy trong WSL hoặc terminal tương ứng.

Dùng thử lần đầu

  1. Sau khi chạy docker compose up -d, mở trang web của Immich và đăng ký tài khoản quản trị.

  2. Làm theo các bước hậu cài đặt trong tài liệu: tạo thêm người dùng nếu cần và xem lại mẫu cấu trúc lưu trữ (storage template) trước khi tải ảnh nhiều.

  3. Cài ứng dụng Immich trên Android hoặc iOS, nhập địa chỉ máy chủ (Server Endpoint URL), đăng nhập.

  4. Chọn các album trên điện thoại cần sao lưu và bật sao lưu; chờ ảnh đầu tiên xuất hiện trên trang web.

  5. Chờ các tác vụ nền (nhận diện khuôn mặt, tạo thumbnail, lập chỉ mục tìm kiếm) chạy xong rồi thử tìm kiếm và xem mục Người.

Mẹo dùng hay

  • Làm theo quy tắc sao lưu 3-2-1 như README nhắc: ít nhất ba bản, hai loại lưu trữ khác nhau, một bản ở nơi khác.
  • Muốn thử trước khi cài, vào trang demo trong README (tài khoản demo@immich.app, mật khẩu demo) để xem giao diện.
  • Đọc kỹ hướng dẫn nâng cấp của dự án trước khi cập nhật phiên bản, vì Immich thay đổi nhanh.
  • Đặt cơ sở dữ liệu trên ổ SSD gắn trong máy để duy trì tốc độ.

Lưu ý và hạn chế

  • Tự cài đòi hỏi bạn chịu trách nhiệm sao lưu, cập nhật và bảo mật; mất ổ cứng mà không có bản dự phòng là mất ảnh.
  • Cần máy chủ chạy liên tục và khá nhiều RAM; nhận diện khuôn mặt và tìm kiếm thông minh chạy nền khá nặng khi mới nhập một thư viện lớn.
  • Muốn truy cập từ ngoài nhà cần cấu hình thêm (VPN hoặc proxy có HTTPS), và không nên mở thẳng ra Internet nếu chưa hiểu rõ bảo mật. Cần sự đồng ý của người trong ảnh khi chia sẻ công khai hoặc dùng nhận diện khuôn mặt.

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

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

Có, mã nguồn mở giấy phép AGPL-3.0, không tính phí theo dung lượng. Bạn chỉ tốn chi phí máy chủ và ổ cứng của mình.

Có ứng dụng điện thoại và tiếng Việt không?

Có ứng dụng cho Android và iOS. README có bản tiếng Việt của chính nó và dự án nhận bản dịch qua Weblate; bạn nên kiểm tra giao diện hiện tại có tiếng Việt chưa trong phần cài đặt.

Có thể chạy trên Windows hay Raspberry Pi không?

Windows chỉ dùng qua Docker Desktop hoặc WSL 2 và không được khuyến khích. Với máy nhỏ như Raspberry Pi, hãy đối chiếu với yêu cầu tối thiểu 6GB RAM, 2 nhân CPU và kiến trúc arm64 trong tài liệu trước khi thử.

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/immich-app/immich.git

Repo tương tự nên xem

Video, nhạc & tải xuống40,5K

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 đồ

VừaDockerLinuxmacOSWindows+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
Tự host & máy chủ nhà37,5K

Nextcloud

nextcloud / server

Đám mây riêng cho file, lịch, danh bạ và cộng tác, tự chủ dữ liệu như Google Drive tại nhà

VừaLinuxDockerWebWindows+3

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ố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
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

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