자유와 보안의 조화: Docker를 이용한 Ubuntu에서 LibrePhotos 사진 관리 플랫폼 구축

서론

이 문서는 로컬 Linux 시스템에서 Docker를 사용하여 LibrePhotos를 배포하는 방법을 설명하며, cpolar 내망 터널링 도구와 결합하여 언제 어디서나 브라우저 페이지를 확인하고 온라인 사진 관리 및 공유 플랫폼을 구축하는 방법을 안내합니다. 공인 IP나 도메인, 클라우드 서버 없이도 가능합니다.

1. LibrePhotos 소개

LibrePhotos는 자체 호스팅 오픈소스 사진 관리 및 공유 플랫폼으로, Google Photos와 유사한 기능을 제공하면서 사용자의 개인정보 보호에 더욱 중점을 두고 데이터에 대한 완전한 통제권을 사용자에게 부여합니다.

주요 기능 특징:

  • 오픈소스 자유: LibrePhotos는 오픈소스 모델을 기반으로 무료 서비스를 제공합니다. 이는 사용자가 자신의 요구에 맞게 소프트웨어를 유연하게 조정하고 최적화할 수 있음을 의미합니다.
  • 자체 배포: 사용자는 자신의 서버에 LibrePhotos를 설치할 수 있으며, 사진과 비디오의 안전한 저장을 보장하고 개인정보 유출 가능성을 차단합니다.
  • 강력한 기능: ImageMagick, FFmpeg, ExifTool 등 다양한 첨단 기술 도구를 통합하여 LibrePhotos는 고품질 사진 및 비디오 처리를 지원하고 효율적인 데이터 분석 능력을 갖추고 있습니다. 또한, 편리한 업로드 방식, 스마트 정리 분류 및 직관적인 사용자 인터페이스를 제공하여 사용자 경험을 크게 향상시킵니다.
  • 지능형 관리: face_recognition 라이브러리를 사용한 정확한 얼굴 인식과 scikit-learn 및 hdbscan 알고리즘을 결합하여 사진 자동 분류를 구현합니다. im2txt 및 places365 기술을 통해 이미지 콘텐츠 및 촬영 장소를 지능적으로 분석하여 검색 기능을 최적화합니다.
  • 안전성: 데이터의 로컬 저장을 구현하여 민감한 정보 유출을 방지합니다. 동시에 강력한 사용자 인증 메커니즘을 포함한 엄격한 보안 조치를 갖추고 있어 합법적인 사용자만 해당 리소스 라이브러리에 접근할 수 있도록 합니다.
  • 유연한 공유: 사용자는 가족, 친구 또는 팀원과 사진 컬렉션을 쉽게 공유하고 다양한 액세스 권한 설정을 사용자 정의할 수 있습니다.

적용 대상

  • 개인 사용자: 개인정보를 소중히 여기고 자신의 디지털 자산을 직접 관리하고 싶은 개인에게 이상적인 솔루션입니다.
  • 가정 사용자: 가족 구성원은 공동으로 사진 보관소를 유지하여 삶의 순간을 기록하고 공유할 수 있습니다.
  • 전문 팀: 사진작가, 디자이너 및 소규모 기업 등 전문가 또는 조직도 이 플랫폼을 사용하여 작품을 효율적으로 관리하고 전시할 수 있습니다.

2. 로컬 환경에 LibrePhotos 배포

이 예제에서는 Docker를 사용하여 배포합니다. Docker가 설치되어 있지 않은 경우, 설치 방법은 다음 튜토리얼을 참조하세요: 《Docker 설치 가이드——Linux, Windows, MacOS》

먼저 배포 파일을 다운로드합니다:

git clone https://github.com/LibrePhotos/librephotos-docker.git

다운로드한 디렉토리로 이동합니다:

cd librephotos-docker

환경 파일을 복사합니다:

cp librephotos.env .env

구성 파일을 수정합니다:

nano .env

파일 내용을 수정합니다. 필요한 경우 다음과 같은 설정을 추가합니다:

timeZone=Asia/Seoul // 시간대, 필요시 추가
adminUser=admin // 관리자 사용자명
adminPass=securePass123 // 관리자 비밀번호
adminEmail=admin@example.com // 관리자 이메일
secretKey=yourSecretKey123 // 비밀 키
httpPort=3000 // 노출 서비스 포트
databaseName=photos_db // 데이터베이스 이름
databaseUser=db_user // 데이터베이스 사용자
databasePass=db_password123 // 데이터베이스 비밀번호
workerCount=4 // 워커 수, 각 워커는 약 800MB RAM 소모
processingThreads=4 // 멀티스레드 스캔, 각 워커는 약 800MB RAM 소모

Ctrl+x를 눌러 저장하고 나온 후 다음 명령으로 컨테이너를 실행합니다:

sudo docker compose -f docker-compose.yml up -d

서비스가 시작되면 브라우저에서 localhost:3000에 접속하여 확인할 수 있습니다.

3. LibrePhotos 기본 사용법

로그인 후 Data 경로를 클릭합니다.

오른쪽 상단에서 세 번째 아이콘을 클릭하여 프로필 사진과 이름을 수정할 수 있습니다.

언어를 선택할 수 있습니다.

관리 패널에서 업로드를 허용하도록 설정합니다.

이제 사진을 업로드할 수 있습니다.

4. 내망 터널링 도구 설치

현재는 Docker로 배포한 LibrePhotos에 로컬 로컬 네트워크 내에서만 접근할 수 있습니다. 사진작가로서 자주 외부에서 작업하는 경우, 사진을 안전하고 신뢰성 있게 저장하고 관리할 수 있는 장소가 필요하며, 언제 어디서든 사진을 편집하거나 공유할 수 있기를 원할 수 있습니다. LibrePhotos + Cpolar 조합을 사용하면 내망 터널링 도구를 설치하여 내망 호스트에 배포된 서비스에 원격으로 접근할 수 있습니다. 다음으로 cpolar 내망 터널링 도구 설치 방법을 설명합니다.

cpolar 설치 단계:

Cpolar 공식 웹사이트: https://www.cpolar.com

일괄 스크립트 설치 명령어:

sudo curl https://get.cpolar.sh | sh

설치가 완료되면 다음 명령으로 cpolar 서비스 상태를 확인합니다:(running 상태이면 정상 시작된 것입니다)

sudo systemctl status cpolar

Cpolar 설치 및 서비스 정상 시작 후, 브라우저에서 ubuntu 호스트 IP에 9200 포트를 추가하여:【http://localhost:9200】Cpolar 관리 인터페이스에 접속하고 Cpolar 공식 웹사이트에서 등록한 계정으로 로그인하면 cpolar 웹 구성 인터페이스가 표시됩니다. 다음으로 웹 인터페이스에서 구성을 진행합니다:

5. LibrePhotos 공인 주소 구성

cpolar 웹 UI 관리 인터페이스에 로그인한 후, 왼쪽 대시보드의 터널 관리를 클릭하고 터널을 생성합니다:

  • 터널 이름: 사용자 정의 가능, 예: PhotoManager (기존 터널 이름과 중복되지 않도록 주의)
  • 프로토콜: http
  • 로컬 주소: 3000
  • 도메인 유형: 무작위 도메인
  • 지역: China Top 선택

생성이 완료되면 왼쪽 온라인 터널 목록에서 방금 생성한 터널로부터 두 개의 공인 주소가 생성된 것을 확인할 수 있습니다. 이제 다른 컴퓨터(원격 위치)에서 브라우저에서 이 주소 중 하나를 사용하여 접속할 수 있습니다.

아래 이미지와 같이, 공인 주소를 사용하여 원격으로 로컬에 배포된 LibrePhotos에 성공적으로 접속하는 것을 확인할 수 있습니다.

계정으로 로그인하면 정상적으로 사용할 수 있습니다:

요약

편의를 위해 위의 작업 과정에서 cpolar에서 생성한 HTTP 공인 주소 터널을 사용했습니다. 이 공인 주소는 무작위로 생성되며, 장점은 빠른 생성 속도로 즉시 사용할 수 있다는 점입니다. 그러나 단점은 주소가 무작위로 생성되어 24시간 내에 무작위로 변경될 수 있으므로 임시 사용에 더 적합합니다.

LibrePhotos를 장기간 원격으로 사용하거나 다른 로컬 배포 서비스에 원격으로 접근할 필요가 있지만 매일 공인 주소를 다시 구성하고 싶지 않고, 공인 주소가 보기 좋고 기억하기 쉽고 더 빠른 대역폭 및 추가 기능을 경험하고 싶다면, 고정된 2차 서브도메인 방식을 사용하는 것을 추천합니다.

6. 고정 공인 주소 구성

위에서 cpolar로 생성한 터널은 무작위 공인 주소를 사용하므로 24시간 내에 무작위로 변경될 수 있어 장기 원격 접근에 불편합니다. 따라서 2차 서브도메인을 구성하여 이 주소를 고정할 수 있습니다. 이 주소는 무작위로 변경되지 않습니다.

왼쪽 예약 메뉴에서 2차 서브도메인 예약을 선택하고, 지역을 China TOP로 선택한 후 2차 서브도메인 이름을 설정하고, 비고 정보를 작성한 후 예약을 클릭합니다.

예약이 성공하면 예약된 2차 서브도메인 주소를 복사합니다: PhotoManager

cpolar 웹 UI 관리 인터페이스에 로그인하고, 왼쪽 대시보드의 터널 관리——터널 목록에서 구성할 터널 PhotoManager를 찾아 오른쪽의 '편집'을 클릭합니다.

터널 정보를 수정하여 예약된 2차 서브도메인을 터널에 구성합니다:

  • 도메인 유형: 2차 서브도메인 선택
  • Sub Domain: 예약된 2차 서브도메인 입력
  • 지역: China TOP

'업데이트'를 클릭합니다.

이제 변하지 않는 주소가 설정되었습니다.

복사한 주소를 브라우저에 붙여넣으면, 고정된 공인 주소를 사용하여 LibrePhotos에 접속할 수 있음을 확인할 수 있습니다.

로그인 후 정상적으로 접근할 수 있습니다.

이제 언제 어디서든 LibrePhotos에 공인 주소로 접속할 수 있으며, 주변 사람들과 공인 주소를 공유하고 팀 협업을 용이하게 할 수 있습니다. 이것이 Linux Ubuntu 시스템에서 Docker를 사용하여 LibrePhotos를 로컬에 설치하고 원격으로 접근하는 전체 과정입니다. 감사합니다!

태그: docker ubuntu LibrePhotos 사진 관리 내망 터널링

7월 29일 18:26에 게시됨

인기 태그

©2026 괴물 클럽