How to Set Up a Self-Hosted Photo Gallery Using Raspberry Pi

클라우드 저장소는 사진을 저장하는 편리한 방법을 제공하지만, 종종 공간과 개인 정보에 대한 제한이 있습니다. 만약 당신이 사진을 완전히 제어할 수 있는 아름답고 안전한 공간을 만들 수 있다면 어떻게 될까요? 믿을 수 있는 라즈베리파이를 보세요! 이 기사에서는 강력하고 사용자 친화적인 사진 갤러리 앱인 PhotoPrism을 사용하여 자가 호스팅 사진 갤러리를 설정하는 방법을 안내합니다.

목차

• PhotoPrism이란?
• 필요한 것
• 라즈베리파이에 PhotoPrism 설치하는 방법
• 라즈베리파이에서 PhotoPrism 사용하기

PhotoPrism이란?

PhotoPrism은 AI 기술을 사용하여 사진을 태그하고 정리하는 오픈 소스 사진 관리 소프트웨어입니다. 이는 사용자가 자신의 사진 및 비디오를 완전히 제어할 수 있게 해주는 자가 호스팅 솔루션입니다.

여기 몇 가지 기능이 있습니다:

• PhotoPrism은 RAW 사진, 비디오 및 JPEG, PNG와 같은 일반 이미지 형식을 처리합니다.
• 강력한 검색 필터를 사용하여 최근 휴가 사진이나 특정 가족 구성원 사진 등 정확히 찾고 있는 것을 추적할 수 있습니다.
• 고해상도 세계 지도에서 사진의 위치를 자동으로 pinpoint합니다.
• 얼굴 인식 및 자동 이미지 분류를 통해 사진을 콘텐츠에 따라 분류합니다.
• 사진은 로컬 저장 장치에 저장되며, 사용자가 그렇게 선택하지 않는 한 클라우드 서비스에 업로드되지 않습니다.

게다가, 라즈베리파이에 PhotoPrism을 설치하는 것은 놀라울 정도로 간단합니다.

필요한 것

PhotoPrism으로 자가 호스팅 사진 갤러리를 설정하기 전에 적절한 장비와 소프트웨어가 필요합니다. 당신은 최소 4GB RAM이 장착된 라즈베리파이 4 또는 5가 필요합니다. PhotoPrism의 요구 사항을 효과적으로 처리하기 위해서는 라즈베리파이가 64비트 운영 체제를 실행하는 것이 중요합니다.

아직 라즈베리파이에 운영 체제를 설치하지 않은 경우, 라즈베리파이 OS 설정에 대한 우리의 자세한 가이드를 확인하는 것을 추천합니다. 이 가이드는 설치 과정을 안내하고 장치를 사용 준비 상태로 만듭니다.

라즈베리파이 자체 외에도 사진 컬렉션을 위한 신뢰할 수 있는 저장 솔루션이 필요합니다. 이 설정에서 나는 외장 3.5인치 하드 드라이브를 사용할 것이며, 이는 대용량 사진 라이브러리를 저장하는 데 충분한 공간과 안정적인 성능을 제공합니다. 그러나 이 옵션에 제한되지는 않습니다; 큰 USB 플래시 드라이브나 로컬 NAS(네트워크 연결 저장소)도 선택과 가용성에 따라 효과적인 저장 솔루션이 될 수 있습니다.

참고: PhotoPrism 개발자가 라즈베리파이를 위해 특별히 설계된 microSD 카드 이미지를 제공하지만, 이 이미지가 현재 구식이라는 점에 유의해야 합니다. 따라서 이 설정에는 사용을 권장하지 않습니다.

라즈베리파이에 PhotoPrism 설치하는 방법

PhotoPrism을 라즈베리파이에서 실행하려면 Docker Compose를 설치하는 것이 첫 번째 단계입니다. 이는 다중 컨테이너 Docker 애플리케이션을 정의하고 실행하기 위해 설계된 도구입니다.

먼저, 라즈베리파이의 소프트웨어 소스에 Docker의 공식 GPG 키와 리포지토리를 추가해야 합니다:

# 패키지 목록 업데이트  
sudo apt-get update  

# HTTPS를 통해 리포지토리를 사용할 수 있도록 하는 패키지 설치  
sudo apt-get install ca-certificates curl  

# Docker의 키링을 위한 디렉토리 생성  
sudo install -m 0755 -d /etc/apt/keyrings  

# Docker의 공식 GPG 키 다운로드  
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc  

# Docker 리포지토리 추가  
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  

# Docker 리포지토리를 추가한 후 다시 패키지 목록을 업데이트  
sudo apt-get update

Docker 리포지토리를 추가한 후, Docker와 다른 필수 구성 요소를 설치할 수 있습니다:

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

Docker를 설치한 후, Docker 명령어를 sudo 없이 실행할 수 있도록 사용자를 Docker 그룹에 추가해야 합니다:

sudo usermod -aG docker $USER

마지막으로, Docker가 올바르게 설치되었고 일반 사용자로서 컨테이너를 실행할 수 있는지 확인하세요:

docker run hello-world

이제 Docker Compose를 설치했으므로 PhotoPrism 자체를 설치할 차례입니다. 이 과정은 간단하며, docker-compose.yml 파일을 다운로드하고 약간의 수정을 한 후 애플리케이션과 데이터베이스 서비스를 시작하는 명령을 실행하는 것입니다.

다음 명령을 사용하여 원하는 폴더에 docker-compose.yml 파일을 다운로드하세요:

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

선호하는 텍스트 편집기에서 파일을 열고(SSH를 통해 라즈베리파이에 원격 접근하는 경우 nano를 사용할 수 있습니다) 모든 기본 자리 표시자 비밀번호(“insecure”)를 안전한 비밀번호로 변경하세요. 특히 PHOTOPRISM_ADMIN_PASSWORD는 꼭 수정해야 합니다.

볼륨 장착 경로를 조정하여 사진과 PhotoPrism의 데이터를 저장할 위치를 가리키도록 하세요. 예를 들어, 외장 드라이브가 /media/david/extdrive에 마운트 되어 있다면 다음과 같이 구성할 수 있습니다:

services:  
  photoprism:  
    volumes:  
      - "/media/david/extdrive/Photos:/photoprism/originals"# PhotoPrism가 원본 미디어 파일을 저장할 위치  
      - "/media/david/extdrive/PhotoPrismStorage:/photoprism/storage"# PhotoPrism의 캐시, 데이터베이스 및 사이드카 파일에 사용  
  
  mariadb:  
    volumes:  
      - "/media/extdrive/PhotoPrismDatabase:/var/lib/mysql"# MariaDB의 데이터베이스 저장소

docker-compose.yml 파일 설정이 완료되면 PhotoPrism을 시작할 준비가 되었습니다. docker-compose.yml 파일이 위치한 디렉토리로 이동하여 다음 명령을 실행하세요:

docker compose up -d

라즈베리파이에서 PhotoPrism 사용하기

Docker와 PhotoPrism이 라즈베리파이에 설치되고 실행 중이 되면, PhotoPrism의 웹 인터페이스를 통해 사진을 관리하고 볼 수 있게 됩니다. 선호하는 웹 브라우저를 열고 http://:2342/로 이동하여 PhotoPrism UI에 접근하세요. : 실제 라즈베리파이의 IP 주소로 교체하거나, 라즈베리파이에서 직접 작업하는 경우 http://localhost:2342/를 사용할 수 있습니다.

로그인 화면에서 ‘admin’이라는 사용자 이름과 설정 과정 중에 설정한 ‘PHOTOPRISM_ADMIN_PASSWORD’를 입력하세요. 로그인 후에는 PhotoPrism 대시보드에서 환영받게 됩니다.

갤러리에 사진을 추가하려면 인터페이스의 오른쪽 상단 모서리에 있는 업로드 버튼을 클릭하세요. 이를 통해 컴퓨터에서 사진을 선택하고 라즈베리파이의 PhotoPrism 라이브러리로 직접 업로드할 수 있습니다.

아마도 많은 사진을 업로드 해야 할 것이므로, 라즈베리파이에 가져오기 폴더를 설정해야 합니다. 이를 위해 실행 중인 PhotoPrism 컨테이너를 중지하여 docker-compose.yml 파일을 수정해야 합니다:

docker compose stop

이제 docker-compose.yml 파일을 편집하여 가져오기 폴더에 대한 볼륨 장착을 포함하세요:

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

이 폴더는 주요 갤러리에 가져오기 전에 사진을 보관하는 임시 공간 역할을 합니다. 이러한 변경을 한 후 파일을 저장하고 PhotoPrism을 재시작하세요:

docker compose up -d

이제 사진을 가져오기 디렉토리로 이동한 후, PhotoPrism 웹 UI의 라이브러리 -> 가져오기로 이동하여 가져오기 프로세스를 시작할 수 있습니다.

소중한 사진을 보호하기 위해, PhotoPrism 저장 장치를 정기적으로 백업하는 것이 필수적입니다. 이렇게 하면 예기치 않은 문제나 하드웨어 고장 시 쉽게 복구할 수 있습니다. 새로운 사진 갤러리를 탐색하고 사용자 맞춤 설정을 즐기세요!

스크린샷 제공: David Morelo. 커버 이미지: DALL-E.