Cách cài đặt và sử dụng PhotoPrism trên Raspberry Pi

Trong thế giới của các trình quản lý ảnh tự host có thể chạy trên Raspberry Pi, PhotoPrism là một trong những công cụ mạnh mẽ nhất. Nó tự hào có chức năng tìm kiếm ấn tượng, khả năng nhận dạng khuôn mặt và thậm chí là cung cấp bản đồ thế giới hiển thị các vị trí mà ảnh của bạn được chụp! PhotoPrism cũng dễ dàng cài đặt trên Raspberry Pi.

Cách cài đặt PhotoPrism trên Raspberry Pi

Bước đầu tiên để thiết lập và chạy PhotoPrism trên Raspberry Pi là cài đặt Docker Compose, một công cụ được thiết kế để xác định và chạy các ứng dụng Docker đa container.

Để bắt đầu, cần thêm key và kho lưu trữ GPG chính thức của Docker vào nguồn phần mềm Raspberry Pi:

# Update your package lists
sudo apt-get update
 
# Install packages to allow apt to use a repository over HTTPS
sudo apt-get install ca-certificates curl
 
# Create a directory for Docker's keyring
sudo install -m 0755 -d /etc/apt/keyrings
 
# Download Docker's official GPG key
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
 
# Add the Docker repository
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
 
# Update your package lists again after adding the Docker repository
sudo apt-get update

Sau khi kho Docker được thêm vào, có thể tiến hành cài đặt Docker cùng với các thành phần thiết yếu khác, bao gồm Docker Compose:

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Sau khi cài đặt Docker, bạn nên thêm người dùng của mình vào nhóm Docker để có thể thực thi các lệnh Docker mà không cần sử dụng sudo:

sudo usermod -aG docker $USER

Cuối cùng, hãy xác minh rằng Docker đã được cài đặt chính xác. Sau đó, bạn có thể chạy các container với tư cách là người dùng thông thường:

docker run hello-world

Bây giờ, Docker Compose đã được cài đặt, đã đến lúc cài đặt PhotoPrism. Quá trình này rất đơn giản và bao gồm việc tải xuống file docker-compose.yml, thực hiện một số thay đổi đối với file và chạy lệnh để khởi động ứng dụng và service cơ sở dữ liệu.

Tải file docker-compose.yml xuống bất kỳ thư mục nào bạn muốn bằng lệnh sau:

wget https://dl.photoprism.app/docker/docker-compose.yml

Mở file trong trình soạn thảo văn bản ưa thích (có thể sử dụng nano nếu đang truy cập Raspberry Pi từ xa thông qua SSH) và thay đổi tất cả mật khẩu giữ chỗ mặc định (“insecure”) thành mật khẩu bảo mật, đặc biệt là PHOTOPRISM_ADMIN_PASSWORD.

Điều chỉnh đường dẫn mount volume để trỏ đến vị trí muốn lưu trữ ảnh và dữ liệu của PhotoPrism. Ví dụ, nếu có một ổ cứng ngoài được mount, chẳng hạn như /media/david/extdrive, bạn có thể cấu hình nó như sau:

services:
  photoprism:
    volumes:
      - "/media/david/extdrive/Photos:/photoprism/originals"  # Where PhotoPrism will store original media files
      - "/media/david/extdrive/PhotoPrismStorage:/photoprism/storage"  # Used for PhotoPrism's cache, database, and sidecar files

  mariadb:
    volumes:
      - "/media//extdrive/PhotoPrismDatabase:/var/lib/mysql"  # Database storage for MariaDB

Với file docker-compose.yml được cấu hình, bạn đã sẵn sàng khởi chạy PhotoPrism. Điều hướng đến thư mục chứa file docker-compose.yml và chạy lệnh sau:

docker compose up -d

Sử dụng PhotoPrism trên Raspberry Pi

Sau khi Docker và PhotoPrism thiết lập và chạy trên Raspberry Pi, bạn có thể bắt đầu quản lý và xem ảnh của mình thông qua giao diện web của PhotoPrism. Mở trình duyệt web ưa thích và điều hướng đến http://<your-raspberry-pi-ip>:2342/ để truy cập giao diện người dùng PhotoPrism. Thay thế <your-raspberry-pi-ip> bằng địa chỉ IP thực của Raspberry Pi hoặc nếu đang làm việc trực tiếp từ chính Pi, có thể sử dụng http://localhost:2342/.

Ở màn hình đăng nhập, nhập tên người dùng admin và mật khẩu bạn đặt cho PHOTOPRISM_ADMIN_PASSWORD trong quá trình thiết lập. Sau khi đăng nhập, bạn sẽ được chào đón bởi bảng điều khiển PhotoPrism.

Để bắt đầu thêm ảnh vào thư viện, hãy nhấp vào nút upload nằm ở góc trên bên phải của giao diện. Điều này cho phép chọn ảnh từ máy tính và upload chúng trực tiếp lên thư viện PhotoPrism của Raspberry Pi.

Vì có thể có rất nhiều ảnh cần upload, bạn nên thiết lập thư mục nhập trên Raspberry Pi. Để làm điều đó, cần dừng các container PhotoPrism đang chạy để sửa đổi file docker-compose.yml:

docker compose stop

Bây giờ, hãy chỉnh sửa file docker-compose.yml để bao gồm volume mount cho thư mục nhập:

services:
  photoprism:
    volumes:
      - "/media/david/extdrive/Import:/photoprism/import"

Thư mục này sẽ hoạt động như một khu vực lưu trữ ảnh trước khi bạn nhập chúng vào thư viện chính của mình. Sau khi thực hiện những thay đổi này, hãy lưu file và khởi động lại PhotoPrism:

docker compose up -d

Bây giờ, bạn có thể di chuyển ảnh vào thư mục nhập, điều hướng đến Library -> Import trong giao diện người dùng web PhotoPrism và bắt đầu quá trình nhập.

Để bảo vệ những bức ảnh quý giá, điều cần thiết là phải thường xuyên sao lưu thiết bị lưu trữ PhotoPrism. Bằng cách đó, bạn có thể dễ dàng khôi phục trong trường hợp có bất kỳ sự cố không mong muốn hoặc lỗi phần cứng nào.