Cách Cài Đặt Immich Trên VPS Để Tự Host Kho Ảnh Thay Thế Google Photos

Tìm hiểu cách cài đặt Immich trên VPS là giải pháp tối ưu cho những ai muốn sở hữu kho lưu trữ ảnh cá nhân độc lập khi dung lượng miễn phí của Google Photos chạm trần hoặc chi phí lưu trữ đám mây ngày càng đắt đỏ. Bằng việc dựng Immich trên một máy chủ riêng từ ThueVPSGiaRe.vn, bạn nắm toàn quyền kiểm soát dữ liệu media mà không phải lo lắng về việc bị quét dữ liệu riêng tư hay trả phí thuê bao định kỳ.

Immich là gì và tại sao nên tự host trên VPS?

Immich là giải pháp lưu trữ hình ảnh và video mã nguồn mở dạng self-hosted hiệu năng cao, được phát triển nhằm thay thế trực tiếp cho Google Photos. Nền tảng này sở hữu giao diện trực quan, hỗ trợ đồng bộ hóa từ thiết bị di động, tự động phân loại hình ảnh theo dòng thời gian (timeline), nhận diện khuôn mặt và lập chỉ mục tìm kiếm thông minh thông qua các mô hình máy học hiện đại.

Khác với các ứng dụng lưu trữ tập tin tổng hợp, Immich tập trung xử lý media chuyên sâu. Việc đưa Immich lên hạ tầng ảo hóa mang lại nhiều giá trị thiết thực:

• Bảo vệ quyền riêng tư tuyệt đối: Hình ảnh gia đình, giấy tờ hay nội dung nhạy cảm được lưu cục bộ trên ổ cứng máy chủ của riêng bạn, không bị các công cụ AI của bên thứ ba phân tích nhằm mục đích thương mại.
• Không bị giới hạn dung lượng: Bạn thoải mái mở rộng không gian lưu trữ theo nhu cầu của ổ cứng thay vì phải trả phí duy trì hàng tháng theo gói dung lượng cố định.
• Linh hoạt nhờ ảo hóa: Triển khai trên nền tảng máy chủ ảo KVM độc lập giúp tài nguyên RAM và CPU được cô lập hoàn toàn, đảm bảo hiệu năng xử lý media không bị ảnh hưởng bởi người dùng khác.
• Quản lý thuận tiện qua công nghệ container: Nhờ tận dụng kỹ thuật đóng gói ứng dụng qua container, việc cài đặt toàn bộ hệ sinh thái Immich gồm cơ sở dữ liệu, bộ nhớ đệm và công cụ xử lý nền diễn ra chỉ với vài thao tác lệnh.

Tiêu chuẩn cấu hình VPS chạy Immich mượt mà

Để chạy Immich mượt mà, máy chủ cần tối thiểu 2 CPU cores, 4GB RAM cho nhu cầu lưu trữ cơ bản khi tắt Machine Learning, và từ 6GB đến 8GB RAM nếu bật tính năng nhận diện khuôn mặt và gắn thẻ ảnh tự động. Ổ cứng SSD NVMe tốc độ cao là bắt buộc để hệ thống tạo thumbnail và quét metadata ảnh nhanh chóng.

Bảng dưới đây tổng hợp các mức tài nguyên chi tiết tương ứng với nhu cầu thực tế:

Thành phần	Mức tối thiểu (Tắt ML)	Khuyến nghị cơ bản	Tối ưu (Đầy đủ AI/ML)
CPU	2 Cores	2 – 4 Cores	4 Cores trở lên
Dung lượng RAM	4GB (Kèm Swap)	6GB	8GB – 16GB
Loại ổ cứng	SSD chuẩn	SSD NVMe U.2	SSD NVMe U.2
Dung lượng đĩa OS	30GB	50GB	80GB – 150GB+
Băng thông (Bandwidth)	100 Mbps	Không giới hạn	Không giới hạn

Lý do RAM đóng vai trò quyết định là vì Immich tích hợp sẵn mô hình học máy (immich-machine-learning) để quét khuôn mặt và gắn tag tìm kiếm tự nhiên. Khi bạn đồng bộ hàng nghìn tấm ảnh cùng lúc, tiến trình này sẽ tiêu tốn bộ nhớ rất lớn. Bên cạnh đó, tốc độ đọc ghi dữ liệu từ ổ cứng SSD NVMe sẽ giữ cho việc cuộn danh mục ảnh trên app điện thoại mượt mà, không bị khựng khi hiển thị hàng loạt thumbnail. Nếu bạn là người mới bắt đầu làm quen với môi trường máy chủ, hãy tham khảo cẩm nang hướng dẫn vận hành VPS căn bản để làm chủ hệ thống dễ dàng hơn.

Chuẩn bị môi trường máy chủ trước khi triển khai

Trước khi bắt tay vào triển khai ứng dụng, bạn cần chuẩn bị một máy chủ chạy hệ điều hành Ubuntu 22.04 hoặc 24.04 LTS với quyền quản trị cao nhất (root). Để đăng nhập vào hệ thống từ xa, bạn có thể tham khảo phương pháp kết nối SSH vào máy chủ Linux bằng phần mềm PuTTY hoặc Terminal sẵn có trên máy tính cá nhân.

Khi đã ở trong giao diện dòng lệnh của máy chủ, hãy cập nhật danh sách gói phần mềm của hệ điều hành lên phiên bản mới nhất:

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl wget git jq apt-transport-https ca-certificates gnupg

Immich hoạt động dựa trên Docker, do đó bạn cần cài đặt Docker Engine và Docker Compose plugin. Nếu chưa cài đặt trước đó, bạn có thể thực hiện theo quy trình chuẩn hóa từ bài viết hướng dẫn cài Docker trên máy chủ Linux hoặc chạy nhanh script chính thức từ Docker:

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

Để tra cứu thêm phương thức cài đặt chuyên sâu, bạn có thể tham khảo trực tiếp tại tài liệu cài đặt chính thức của Docker. Sau khi hoàn tất, hãy xác nhận Docker và Compose đã hoạt động:

docker --version
docker compose version

Hướng dẫn cách cài đặt Immich trên VPS bằng Docker Compose

Quá trình triển khai Immich tuân thủ theo tiêu chuẩn phát hành chính thức từ kho lưu trữ dự án. Dưới đây là 4 bước chi tiết giúp bạn dựng hoàn chỉnh hệ thống lưu trữ chỉ trong vài phút.

Bước 1: Tạo thư mục lưu trữ và tải cấu hình gốc

Tạo một thư mục riêng biệt đặt tên là immich-app nhằm chứa toàn bộ file điều hướng cấu hình và dữ liệu cục bộ:

mkdir ./immich-app && cd ./immich-app

Tiếp theo, tải về hai tệp tin quan trọng nhất từ bản phân phối mới nhất trên GitHub của Immich gồm docker-compose.yml và example.env:

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

Bước 2: Thiết lập biến môi trường trong file .env

Tệp .env đóng vai trò điều khiển đường dẫn lưu trữ, mật khẩu cơ sở dữ liệu PostgreSQL và phiên bản triển khai. Mở file bằng trình chỉnh sửa dòng lệnh nano:

nano .env

Bạn cần kiểm tra và chỉnh sửa lại các thông số kỹ thuật cốt lõi:

• UPLOAD_LOCATION: Đường dẫn tuyệt đối nơi chứa toàn bộ ảnh và video gốc được tải lên máy chủ (ví dụ: ./library hoặc /mnt/storage/immich).
• DB_DATA_LOCATION: Nơi lưu trữ tập tin dữ liệu cấu trúc của PostgreSQL (mặc định: ./postgres).
• DB_PASSWORD: Mật khẩu tài khoản cơ sở dữ liệu PostgreSQL. Tuyệt đối không để mật khẩu mặc định (chỉ sử dụng các ký tự chữ và số A-Za-z0-9 để tránh lỗi parse chuỗi kết nối).
• TZ: Múi giờ hệ thống, chuyển sang Asia/Ho_Chi_Minh để mốc thời gian hiển thị chính xác theo giờ Việt Nam.
• IMMICH_VERSION: Phiên bản image, mặc định để release.

Mẫu file .env tiêu chuẩn sau khi cấu hình:

# Thu muc chua anh va video goc
UPLOAD_LOCATION=./library

# Thu muc co so du lieu PostgreSQL
DB_DATA_LOCATION=./postgres

# Phien ban phan phoi
IMMICH_VERSION=release

# Mat khau co so du lieu PostgreSQL (thay doi chuoi ben duoi)
DB_PASSWORD=FastByteImmichPass2026Safe

# Thong tin ket noi noi bo
DB_USERNAME=postgres
DB_DATABASE_NAME=immich

# Mui gio he thong
TZ=Asia/Ho_Chi_Minh

Nhấn tổ hợp phím Ctrl + O rồi Enter để lưu file, sau đó nhấn Ctrl + X để thoát nano.

Bước 3: Khởi chạy các container ngầm định

Tại thư mục immich-app, thực hiện lệnh tải toàn bộ image cần thiết và kéo container chạy ngầm:

docker compose up -d

Hệ thống sẽ tải về các thành phần gồm immich_server, immich_machine_learning, immich_redis và immich_postgres. Quá trình kéo image có thể mất 3-5 phút tùy theo tốc độ đường truyền. Sau khi hoàn tất, kiểm tra trạng thái khởi chạy bằng lệnh:

docker compose ps

Đảm bảo cột STATUS của các service đều hiển thị trạng thái Up (hoặc healthy). Nếu cổng kết nối chưa được định tuyến, bạn cần tham khảo cách cấu hình mở port tường lửa trên VPS để cho phép lưu lượng truy cập đi qua cổng 2283.

Bước 4: Truy cập trang quản trị và tạo tài khoản Admin

Mở trình duyệt trên máy tính và truy cập theo đường dẫn IP của máy chủ kèm cổng kết nối mặc định:

http://<DIA_CHI_IP_VPS>:2283

Màn hình khởi động xuất hiện thông báo chào mừng. Bạn nhấp chọn Getting Started, tiến hành điền các trường thông tin bao gồm: Địa chỉ Email quản trị viên, Mật khẩu quản trị và Tên hiển thị. Tài khoản đầu tiên này sẽ được cấp quyền Quản trị tối cao (Admin) trên toàn hệ thống. Hãy thử tải lên một tấm ảnh đầu tiên từ máy tính để kiểm tra xem hệ thống đã ghi dữ liệu vào thư mục upload thành công hay chưa.

Kết nối ứng dụng Immich trên điện thoại iOS và Android

Sau khi máy chủ đã vận hành, bạn có thể biến chiếc điện thoại của mình thành máy chụp hình tự động đẩy ảnh về máy chủ cá nhân mà không cần cáp nối. Ứng dụng Immich hiện đã có mặt trên cả App Store (cho người dùng iPhone, iPad) và Google Play Store (dành cho thiết bị Android).

1. Tải ứng dụng: Tìm kiếm từ khóa Immich trên App Store hoặc CH Play và cài đặt ứng dụng chính thức do Immich Authors phát triển.
2. Khai báo Server Endpoint: Mở ứng dụng, tại màn hình thiết lập kết nối, nhập đầy đủ địa chỉ máy chủ: http://<DIA_CHI_IP_VPS>:2283/api (hoặc sử dụng tên miền có SSL như hướng dẫn ở phần tiếp theo).
3. Đăng nhập tài khoản: Sử dụng email và mật khẩu tài khoản quản trị vừa khởi tạo (hoặc tài khoản thành viên do bạn phân quyền).
4. Kích hoạt tính năng Backup: Nhấn vào biểu tượng đám mây ở góc trên màn hình, cấp quyền truy cập toàn bộ thư viện ảnh, chọn các album cần đồng bộ và nhấn nút Start Backup.

Cấu hình Reverse Proxy Nginx với chứng chỉ SSL HTTPS

Việc truy cập Immich trực tiếp qua IP máy chủ kèm cổng 2283 tiềm ẩn nguy cơ bảo mật vì dữ liệu tải lên chưa được mã hóa. Bằng cách thiết lập hệ thống chuyển tiếp Reverse Proxy kết hợp phần mềm web server phổ biến Nginx, bạn có thể gắn tên miền riêng và trang bị chứng chỉ SSL Let’s Encrypt hoàn toàn miễn phí.

Cài đặt Nginx và công cụ cấp chứng chỉ Certbot:

sudo apt install -y nginx certbot python3-certbot-nginx

Tạo một file cấu hình Virtual Host mới cho tên miền của bạn (ví dụ: photos.yourdomain.com):

sudo nano /etc/nginx/sites-available/immich.conf

Dán nội dung cấu hình chuẩn hóa dành riêng cho Immich (đặc biệt lưu ý tham số upload size không giới hạn):

server {
    server_name photos.yourdomain.com;

    # Cho phep upload video va tap tin RAW kich thuoc lon
    client_max_body_size 0;

    location / {
        proxy_pass http://127.0.0.1:2283;
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # Ho tro ket noi Websocket cho timeline thoi gian thuc
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";

        proxy_read_timeout 600s;
        proxy_send_timeout 600s;
    }
}

Kích hoạt cấu hình và khởi động lại Nginx:

sudo ln -s /etc/nginx/sites-available/immich.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

Cuối cùng, chạy Certbot để tự động cài đặt chứng chỉ SSL:

sudo certbot --nginx -d photos.yourdomain.com

Sau khi certbot báo thành công, bạn đã có thể đăng nhập Immich qua đường dẫn an toàn https://photos.yourdomain.com trên cả trình duyệt máy tính lẫn app di động.

Tối ưu VPS RAM thấp: Giải pháp vô hiệu hóa Machine Learning

Nếu đang vận hành Immich trên gói VPS có cấu hình 4GB RAM, tiến trình máy học (immich-machine-learning) có thể chiếm dụng cạn kiệt bộ nhớ và dẫn đến hiện tượng máy chủ tự kích hoạt cơ chế Out of Memory (OOM killer) làm tắt ngang container. Bạn hoàn toàn có thể khắc phục triệt để bằng hai phương án dưới đây.

Cách 1: Khởi tạo phân vùng Swap bộ nhớ ảo

Kích hoạt 4GB swap trên ổ cứng SSD để giảm áp lực tràn bộ nhớ khi ứng dụng xử lý tác vụ nặng:

sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

Cách 2: Tắt hoàn toàn container Machine Learning

Nếu không có nhu cầu nhận diện khuôn mặt người quen hoặc tìm kiếm ảnh theo ngữ cảnh (ví dụ: gõ chữ “con mèo”, “bãi biển”), bạn có thể tắt hẳn tiến trình machine learning để tiết kiệm từ 1.5GB đến 2GB RAM cho máy chủ.

Mở tệp tin docker-compose.yml, tìm đến khối khai báo immich-machine-learning: và bình luận (thêm dấu # vào đầu mỗi dòng) toàn bộ service này cũng như phần phụ thuộc của nó trong mục depends_on của service immich-server. Sau đó áp dụng lại cấu hình:

docker compose up -d --remove-orphans

Khi tắt ML, các tính năng lưu trữ ảnh gốc, tạo thumbnail, phân loại theo ngày tháng (timeline), xem metadata GPS vị trí và chia sẻ album cho người thân vẫn hoạt động mượt mà.

Quy trình sao lưu dữ liệu và nâng cấp Immich an toàn

Để tránh mất mát dữ liệu hình ảnh quan trọng khi gặp sự cố phần cứng hoặc lỗi trong quá trình nâng cấp hệ thống, bạn cần thiết lập kế hoạch sao lưu định kỳ cho cả cơ sở dữ liệu và thư mục hình ảnh gốc theo hướng dẫn của Immich.

1. Quy tắc sao lưu 2 thành phần bắt buộc

• Cơ sở dữ liệu PostgreSQL: Chứa thông tin album, tài khoản, tag, thời gian chụp và liên kết logic giữa các ảnh. Mặc định Immich hỗ trợ tính năng tự động sao lưu database hàng đêm vào thư mục backup. Để xuất dữ liệu thủ công, chạy lệnh:

  docker exec -t immich_postgres pg_dumpall -c -U postgres > ./immich_database_backup.sql

• Thư mục UPLOAD_LOCATION: Chứa toàn bộ các file media gốc chất lượng cao. Bạn có thể sử dụng công cụ rsync để đồng bộ thư mục này sang một máy chủ lưu trữ thứ hai hoặc ổ cứng ngoài:

  rsync -avz --progress ./library/ user@backup-server:/backup/immich-library/

Chi tiết về phương pháp phục hồi dữ liệu khi gặp sự cố, bạn có thể tham khảo thêm tại tài liệu hướng dẫn Backup & Restore của Immich.

2. Nâng cấp Immich lên bản mới

Immich phát triển rất nhanh và liên tục bổ sung bản vá cũng như giao diện mới. Mỗi khi cập nhật phiên bản, bạn chỉ cần thực hiện 3 thao tác đơn giản:

# Buoc 1: Chuyen vao thu muc chua ung dung
cd ./immich-app

# Buoc 2: Keo cac Docker Image moi nhat
docker compose pull

# Buoc 3: Khoi dong lai he thong voi ban cap nhat
docker compose up -d

Tổng hợp sự cố thường gặp và cách xử lý nhanh

Trong quá trình vận hành, người dùng có thể gặp phải một số vấn đề phát sinh từ cấu hình phần cứng hoặc quyền tập tin. Bảng dưới đây liệt kê các lỗi phổ biến cùng giải pháp xử lý:

Triệu chứng lỗi	Nguyên nhân cốt lõi	Phương án khắc phục
Container bị restart liên tục (Exit Code 137)	VPS cạn kiệt RAM, tiến trình Machine Learning bị hệ điều hành tắt ngang (OOM).	Tạo thêm 4GB swap file hoặc tắt service machine-learning trong file docker-compose.yml.
Port 2283 is already in use	Cổng 2283 đang bị chiếm dụng bởi một ứng dụng web khác trên máy chủ.	Đổi cổng map ngoài của Immich trong compose thành 2284:2283 hoặc dừng tiến trình đang chiếm cổng.
Permission Denied khi lưu ảnh	Thư mục UPLOAD_LOCATION không cấp đủ quyền ghi cho Docker container.	Cấp lại quyền ghi thư mục bằng lệnh: sudo chmod -R 775 ./library.
Database connection refused	PostgreSQL chưa kịp sẵn sàng hoặc mật khẩu chứa ký tự đặc biệt gây lỗi chuỗi kết nối.	Đơn giản hóa mật khẩu trong .env thành ký tự chữ số và khởi động lại container postgres.
Lỗi x86-64-v2 unsupported	CPU của VPS quá cũ, thiếu các chỉ lệnh AVX cần thiết để chạy microservice.	Chuyển sang gói máy chủ ảo sử dụng CPU thế hệ mới như Intel Gold đời mới.

Câu hỏi thường gặp về cài đặt Immich trên VPS

Nội dung kỹ thuật trong bài chỉ mang tính tham khảo. Bài viết hướng dẫn trên môi trường Ubuntu 22.04/24.04 LTS – lệnh và cấu hình có thể thay đổi tùy thuộc vào hệ điều hành, phiên bản Docker và bản cập nhật ứng dụng Immich. Bạn nên tham khảo trực tiếp tài liệu chính thức tại Immich Quick Start Documentation trước khi đưa vào vận hành thực tế. Hãy luôn sao lưu dữ liệu quan trọng trước mọi thao tác quản trị.