Immich를 실행하기 위한 최소 하드웨어 요구 사항은 무엇인가요?

Immich는 최소 4GB RAM, 2개의 CPU 코어 및 사진을 저장할 수 있는 충분한 저장 공간이 필요합니다. 머신러닝 기능을 사용할 경우 8GB RAM과 GPU(선택 사항이지만 권장됨)가 성능을 크게 향상시킵니다. 저장 공간 요구 사항은 사진 라이브러리의 크기에 따라 달라지며, 성장에 대비해 현재 라이브러리 크기의 2~3배를 계획하는 것이 좋습니다.

Immich는 Google Photos와 어떻게 비교되나요?

Immich는 자동 백업, 얼굴 인식, 객체 감지, 스마트 검색과 같은 유사한 기능을 제공합니다. 주요 차이점은 완전한 프라이버시(데이터는 서버에 남아 있음), 하드웨어 범위를 넘는 저장 공간 제한 없음, 월간 요금 없음, 데이터에 대한 완전한 통제가 있습니다. 다만, 기술적인 설정과 유지보수가 필요합니다.

내 가정 네트워크 외부에서 Immich에 접근할 수 있나요?

네, SSL 인증서를 사용하여 Nginx 또는 Caddy와 같은 역전파 프록시를 통해 Immich를 노출시킬 수 있습니다. 적절한 보안(HTTPS, 강력한 비밀번호, 선택적으로 VPN 또는 Tailscale를 사용하여 보안을 추가할 수 있는 도메인 이름을 사용하세요. 적절한 인증 및 암호화 없이 Immich를 직접 노출시키는 것은 절대 하지 마세요.

Immich은 다중 사용자를 지원합니까?

네, Immich은 여러 사용자를 지원하며 각 사용자는 별도의 라이브러리를 가질 수 있습니다. 각 사용자는 자신의 계정을 가질 수 있으며, 사진은 분리되어 저장됩니다. 사용자 간에 공유 앨범을 생성할 수 있으며, 개인 사진의 경우 개인 정보 보호를 유지할 수 있습니다.

Immich에서 이전하려면 내 사진들은 어떻게 되나요?

원본 사진은 업로드 디렉토리에 그대로 원본 형식으로 저장됩니다. 언제든지 간단히 복사하여 사용할 수 있습니다. Immich는 특허 형식에 갇히게 하지 않으며, 사진은 사용자와 날짜에 따라 파일 시스템 상에서 일반 파일로 정리되어 접근 가능합니다.

머신러닝 기능은 어떻게 작동하나요?

Immich는 얼굴 인식, 객체 감지 및 의미 검색을 위해 CLIP을 사용합니다. ML 컨테이너는 서버에서 로컬로 이미지를 처리하므로 외부 서비스로 데이터가 전송되지 않습니다. 원하신다면 ML 기능을 비활성화할 수 있지만, 이는 스마트 검색 기능을 제한하게 됩니다.

도커 없이 Immich를 사용할 수 있나요?

기술적으로는 가능하지만, Docker는 공식적으로 지원되는 배포 방법입니다. Docker는 환경 일관성, 간편한 업데이트, 그리고 적절한 격리를 보장합니다. 수동 설치는 PostgreSQL, Redis, 머신러닝 의존성 및 여러 Node.js 서비스를 관리해야 하기 때문에 훨씬 더 복잡합니다.

Immich는 얼마나 많은 저장 공간을 사용하나요?

Immich는 원본 사진과 생성된 썸네일, 인코딩된 영상을 저장합니다. 썸네일과 메타데이터를 고려할 경우 약 10 15%의 추가 공간이 필요합니다. 100GB 규모의 사진 라이브러리의 경우 총 110 115GB의 공간을 계획해야 합니다. 머신러닝 모델은 약 2~3GB의 추가 공간이 필요합니다.

자체 호스팅 Immich: 개인용 사진 클라우드

자체 호스팅된 AI 기반 백업에 저장된 사진

Page content

Immich는 사진 및 영상 관리에 대한 완전한 제어권을 제공하는 혁신적인 오픈소스, 자체 호스팅 솔루션입니다. 구글 포토와 경쟁할 수 있는 기능을 갖추고 있으며, AI 기반 얼굴 인식, 스마트 검색, 자동 모바일 백업을 포함하여 데이터를 개인 서버에서 안전하게 보호합니다.

개인 지식 관리가 당신의 생각과 정보를 정리하고 보존하는 데 도움을 주는 것처럼, Immich는 시각적 기억을 정리하고 보존하는 데 도움을 줍니다.

immich

Immich란 무엇인가요?

Immich는 구글 포토나 아이클라우드와 같은 특허권 소유 클라우드 사진 서비스의 오픈소스, 자체 호스팅 대안입니다. TypeScript, PostgreSQL, 머신러닝을 포함한 현대 기술로 구축되어, 사진 및 영상 컬렉션을 백업, 정리, 탐색할 수 있는 기능이 풍부한 플랫폼을 제공합니다.

주요 기능

프라이버시 중심 설계: 모든 사진은 인프라스트럭처에 남아 있습니다. 제3자 서버, 데이터 마이닝, 프라이버시 문제는 없습니다. 당신의 기억은 당신에게 속합니다.

자동 모바일 백업: 네이티브 iOS 및 안드로이드 앱은 구글 포토와 유사한 자동 백그라운드 백업을 제공합니다. 사진은 찍은 직후에 보호됩니다.

AI 기반 검색: CLIP 및 얼굴 인식을 포함한 머신러닝 모델을 활용하여 의미 기반 검색을 가능하게 합니다. “해변 일몰”, “개가 놀고 있는”, 또는 특정 인물에 대한 검색이 가능합니다. 수동 태깅 없이도 가능합니다.

얼굴 인식: 사진 내에서 자동으로 얼굴을 감지하고 클러스터링합니다. Immich는 전체 라이브러리에서 사람을 식별하여 특정 개인의 사진을 쉽게 찾을 수 있도록 합니다.

현대 웹 인터페이스: 브라우저를 통해 사진을 탐색, 정리, 공유할 수 있는 아름다운, 반응형 웹 인터페이스를 제공합니다.

다중 사용자 지원: 가족 구성원을 위한 계정을 생성할 수 있으며, 각각은 자신의 개인 라이브러리를 가집니다. 선택된 앨범을 공유하면서 개인 사진의 프라이버시를 유지할 수 있습니다.

라이브 사진 지원: iOS 라이브 사진 및 안드로이드 모션 사진에 대한 완전한 지원을 제공합니다. 정적 이미지와 영상 구성 요소를 모두 보존합니다.

메타데이터 보존: 위치, 카메라 설정, 타임스탬프를 포함한 EXIF 데이터가 보존됩니다. GPS 좌표 기반으로 사진을 지도에 볼 수 있습니다.

외부 라이브러리 지원: 외부 저장소에서 기존 사진 라이브러리를 가져올 수 있으며, 파일 복사 없이 디스크 공간을 절약할 수 있습니다. 텍스트 기반 지식을 관리하고 정리하는 데 도움을 주는 Obsidian와 유사하게, Immich는 시각 미디어에 대한 강력한 조직화를 제공합니다.

왜 사진을 자체 호스팅해야 하나요?

완전한 프라이버시 제어

상업용 클라우드 서비스를 사용할 경우, 사진은 당신이 제어할 수 없는 서버에 저장됩니다. 광고를 위해 분석되거나, 머신러닝 훈련 데이터에 포함되거나, 제3자에 의해 액세스될 수 있습니다. Immich를 사용하면 사진이 당신의 서버를 떠나는 것은 당신이 명시적으로 공유하지 않는 한 없습니다.

저장 공간 제한 없음

클라우드 서비스는 저장 공간 계층에 따라 요금을 부과합니다. 자체 호스팅의 경우, 제한은 하드웨어 용량에만 있습니다. 10TB 하드디스크는 2년 분의 프리미엄 클라우드 저장 공간보다 비용이 적습니다.

비용 효율성

초기 하드웨어 투자 후, 자체 호스팅은 최소한의 지속 비용이 있습니다. 월간 구독료 없이, 저장 공간 제한을 초과할 때의 놀라운 요금 없이도 사용할 수 있습니다.

데이터의 지속성

클라우드 서비스는 조건을 변경하거나 가격을 인상하거나 완전히 종료할 수 있습니다. 자체 호스팅 솔루션은 당신의 통제 하에 무한히 유지됩니다.

학습 기회

Immich를 자체 호스팅하면 Docker, 역방향 프록시, SSL 인증서, 데이터베이스 관리, 서버 관리와 같은 실무 경험을 제공합니다. 이는 개발자나 DevOps 전문가에게 귀중한 기술입니다.

아키텍처 개요

Immich는 여러 구성 요소를 갖춘 마이크로서비스 아키텍처를 따릅니다:

Immich 서버: 인증, 사진 업로드, 데이터베이스 작업을 처리하는 주 API 서버. Node.js 및 TypeScript로 구축되었습니다.

Immich 머신러닝: 얼굴 인식, 객체 감지, CLIP 기반 의미 검색을 위한 TensorFlow 모델을 실행하는 별도의 Python 서비스.

Immich 웹: 사용자 인터페이스를 제공하는 React 기반 웹 인터페이스.

PostgreSQL: 사진, 사람, 앨범 간의 관계를 포함한 메타데이터, 사용자 정보를 저장하는 관계형 데이터베이스.

Redis: 세션 관리 및 작업 큐 조정을 위한 메모리 캐시.

TypeSense (선택 사항): 검색 기능 및 성능 향상을 위한 검색 엔진.

모든 구성 요소는 Docker 컨테이너로 실행되며, Docker Compose를 사용하여 배포 및 관리가 간소화됩니다.

하드웨어 요구 사항

최소 사양

CPU: 2코어 (x86_64 또는 ARM64)
RAM: 4GB (8GB 권장)
저장 공간: 애플리케이션 + 사진 라이브러리 크기 10GB
네트워크: 로컬 액세스용 100 Mbps

권장 사양

CPU: 4코어 이상, 좋은 단일 스레드 성능
RAM: 8-16GB (라이브러리 크기에 따라 더 많을 수 있음)
저장 공간: 데이터베이스 및 애플리케이션용 SSD, 사진 저장용 HDD
GPU: 선택 사항이지만, ML 작업을 5-10배 가속시킵니다 (NVIDIA 및 CUDA 지원)

저장 공간 고려 사항

현재 사진 라이브러리 크기의 약 1.15배를 계획해야 합니다. 이는 썸네일 및 여러 해상도를 고려하기 때문입니다. PostgreSQL 데이터베이스를 위해 SSD 저장을 사용하면 성능이 향상됩니다.

대규모 라이브러리 (10만 장 이상의 사진)의 경우:

RAID를 사용한 NAS로 데이터 중복성 보장
데이터베이스용 별도 SSD
자주 액세스되는 사진을 위한 NVMe 캐시 계층

설치 가이드

사전 조건

Immich를 설치하기 전에 다음을 확인하세요:

리눅스 서버: Ubuntu 22.04 LTS 또는 Debian 12 권장 (자세한 설치 지침은 Ubuntu 24.04 설치 및 유용한 도구를 참조하세요)
Docker: 20.10 이상
Docker Compose: 2.0 이상
도메인 이름: 외부 액세스를 위해 권장됨
역방향 프록시: SSL 종료를 위한 Nginx 또는 Caddy

단계별 설치

1. Docker 및 Docker Compose 설치

# 시스템 패키지 업데이트
sudo apt update && sudo apt upgrade -y

# Docker 설치
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

# 사용자를 docker 그룹에 추가
sudo usermod -aG docker $USER

# Docker Compose 설치
sudo apt install docker-compose-plugin

curl 명령어 및 옵션에 대한 자세한 내용은 curl 쉬트를 참조하세요. Docker에 익숙하지 않다면, Docker 쉬트에서 필수 명령어 및 개념을 확인하세요.

2. Immich 디렉토리 구조 생성

# 애플리케이션 디렉토리 생성
mkdir -p ~/immich/{library,database,machine-learning}
cd ~/immich

# docker-compose.yml 다운로드
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

bash 스크립팅 및 명령줄 작업에 익숙하지 않다면, bash 쉬트에서 일반 명령어 및 디렉토리 작업에 대한 유용한 참고 자료를 확인하세요.

3. 환경 변수 설정

.env 파일을 편집하여 설정을 입력하세요:

# 데이터베이스 설정
DB_PASSWORD=your_secure_password_here
DB_DATABASE_NAME=immich
DB_USERNAME=postgres

# 업로드 위치
UPLOAD_LOCATION=./library

# 머신러닝
MACHINE_LEARNING_ENABLED=true

# 시간대
TZ=America/New_York

# 공개 URL (외부 액세스를 위해)
IMMICH_SERVER_URL=https://photos.yourdomain.com

중요: DB_PASSWORD에 강력한 랜덤 패스워드를 생성하세요:

openssl rand -base64 32

4. Immich 실행

# 모든 서비스 시작
docker compose up -d

# 서비스 상태 확인
docker compose ps

# 로그 확인
docker compose logs -f

이것은 기본 사항일 뿐입니다. Docker Compose 명령어 및 작업에 대한 종합적인 참조는 Docker Compose 쉬트를 참조하세요.

5. 웹 인터페이스 액세스

http://your-server-ip:2283으로 이동하여 관리자 계정을 생성하세요. 이 첫 번째 계정은 시스템 관리자가 됩니다.

외부 액세스 설정

보안 외부 액세스를 위해 역방향 프록시를 설정하세요:

Nginx 설정 예시

server {
    listen 443 ssl http2;
    server_name photos.yourdomain.com;

    ssl_certificate /path/to/fullchain.pem;
    ssl_certificate_key /path/to/privkey.pem;

    client_max_body_size 50000M;

    location / {
        proxy_pass http://localhost:2283;
        proxy_set_header Host $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;
        
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        
        proxy_read_timeout 600s;
        proxy_send_timeout 600s;
    }
}

Caddy 설정 예시 (자동 HTTPS가 더 간단함)

photos.yourdomain.com {
    reverse_proxy localhost:2283
    
    @uploads {
        path /api/upload/*
    }
    request_body @uploads {
        max_size 50GB
    }
}

모바일 앱 설정

iOS

Immich을 App Store에서 다운로드
서버 URL을 입력 (https://photos.yourdomain.com)
자격 증명으로 로그인
설정에서 자동 백업을 활성화
백업할 앨범을 선택 (또는 모든 사진)
백업 설정 구성 (WiFi만, 충전 중만 등)

Android

Immich을 Google Play Store 또는 F-Droid에서 다운로드
서버 URL 및 자격 증명 입력
사진/영상 액세스 권한 부여
자동 백업 설정 구성
신뢰할 수 있는 백그라운드 백업을 위해 포그라운드 서비스 활성화

백업 설정 팁

WiFi만: 모바일 데이터 요금을 피하려면 활성화
충전 중만: 대규모 업로드 시 배터리 소모 방지
동영상 포함: 동영상은 저장 공간 및 대역폭을 많이 사용
백그라운드 앱 새로고침: iOS에서 신뢰할 수 있는 동기화를 위해 활성화
포그라운드 서비스: Android에서 일관된 백업을 위해 활성화

머신러닝 기능

얼굴 인식

Immich의 얼굴 인식은 라이브러리 전체에서 자동으로 얼굴을 감지하고 클러스터링합니다:

초기 처리: 업로드 후 ML 서비스가 각 사진의 얼굴을 분석
얼굴 클러스터링: 유사한 얼굴은 함께 그룹화
수동 할당: 클러스터를 검토하고 사람 이름을 할당
지속적인 학습: 더 많은 사진을 태그할수록 정확도 향상

설정:

# docker-compose.yml에서 ML 서비스 환경
MACHINE_LEARNING_MODEL_CACHE=/cache
MACHINE_LEARNING_WORKERS=1  # 더 많은 CPU 코어일수록 증가

객체 감지 및 CLIP 검색

Immich는 CLIP (대비 언어-이미지 사전 훈련)을 사용하여 의미 기반 검색을 제공합니다:

태그 없이 개념 검색: “산 풍경”, “생일 케이크”, “빨간 차”
자연어 쿼리는 맥락과 관계를 이해
언어별로 작동 (하지만 영어가 일반적으로 가장 좋은 결과를 제공)

GPU 가속

ML 처리를 크게 가속화하려면 GPU 지원을 활성화하세요:

NVIDIA GPU 및 CUDA

# docker-compose.yml에서 ML 서비스
services:
  immich-machine-learning:
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: 1
              capabilities: [gpu]

NVIDIA 컨테이너 툴킷이 설치되어 있는지 확인하세요:

distribution=$(. /etc/os-release;echo $ID$VERSION_ID)
curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add -
curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | \
    sudo tee /etc/apt/sources.list.d/nvidia-docker.list

sudo apt update
sudo apt install -y nvidia-container-toolkit
sudo systemctl restart docker

백업 전략

Immich가 모바일 기기에서 사진을 백업하지만, Immich 자체도 백업해야 합니다:

백업할 항목

사진 라이브러리: 원본 사진을 포함하는 UPLOAD_LOCATION 디렉토리
데이터베이스: 메타데이터 및 관계를 포함하는 PostgreSQL 데이터베이스
설정: .env 파일 및 docker-compose.yml

데이터베이스 백업

자동 일일 백업 스크립트

#!/bin/bash
# ~/immich/backup.sh로 저장

BACKUP_DIR=~/immich-backups
DATE=$(date +%Y%m%d_%H%M%S)

# 백업 디렉토리 생성
mkdir -p $BACKUP_DIR

# PostgreSQL 데이터베이스 백업
docker exec -t immich-postgres pg_dumpall -c -U postgres | \
    gzip > $BACKUP_DIR/immich_db_$DATE.sql.gz

# 30일 이상 된 백업 삭제
find $BACKUP_DIR -name "immich_db_*.sql.gz" -mtime +30 -delete

echo "백업 완료: $BACKUP_DIR/immich_db_$DATE.sql.gz"

실행 가능하게 만들고 cron으로 스케줄링하세요:

chmod +x ~/immich/backup.sh
crontab -e
# 라인 추가: 0 2 * * * ~/immich/backup.sh

bash 스크립팅, 자동화 및 cron 작업에 대한 자세한 정보는 bash 쉬트를 참조하세요.

사진 라이브러리 백업

사진 라이브러리는 별도의 위치로 백업해야 합니다:

옵션 1: NAS로 rsync

rsync -avz --delete ~/immich/library/ nas:/backups/immich-photos/

옵션 2: 암호화된 클라우드 백업

# rclone과 암호화 사용
rclone sync ~/immich/library/ remote:immich-backup-encrypted/ --encrypt

옵션 3: 로컬 외부 드라이브

rsync -avz --delete ~/immich/library/ /mnt/backup-drive/immich/

유지보수 및 업데이트

정기 유지보수 작업

디스크 공간 모니터링

# 디스크 사용량 확인
df -h ~/immich/library
df -h ~/immich/database

# Docker 볼륨 확인
docker system df

성능 모니터링

# 리소스 사용량 확인
docker stats

# 특정 서비스 로그 확인
docker compose logs immich-server --tail=100
docker compose logs immich-machine-learning --tail=100

Immich 업데이트

Immich는 새로운 기능과 버그 수정을 자주 업데이트합니다. 정기적으로 업데이트하세요:

cd ~/immich

# 업데이트 전 데이터베이스 백업
docker exec -t immich-postgres pg_dumpall -c -U postgres > backup_pre_update.sql

# 최신 이미지 끌어오기
docker compose pull

# 오래된 컨테이너 중지 및 제거
docker compose down

# 새로운 이미지로 시작
docker compose up -d

# 문제 확인을 위해 로그 확인
docker compose logs -f

데이터베이스 유지보수

정기적인 데이터베이스 유지보수는 최적의 성능을 보장합니다:

# 데이터베이스 진공 및 분석
docker exec -it immich-postgres psql -U postgres -d immich -c "VACUUM ANALYZE;"

# 데이터베이스 크기 확인
docker exec -it immich-postgres psql -U postgres -d immich -c \
    "SELECT pg_size_pretty(pg_database_size('immich'));"

성능 최적화

저장소 최적화

데이터베이스에 SSD 사용: PostgreSQL은 SSD 저장소에서 크게 이점을 얻습니다. 고려사항:

volumes:
  pgdata:
    driver: local
    driver_opts:
      type: none
      o: bind
      device: /mnt/ssd/immich-db

사진 저장소 분리: 대규모 사진 라이브러리는 HDD에 유지하고 데이터베이스는 SSD에 유지하세요:

UPLOAD_LOCATION=/mnt/hdd/immich-photos

데이터베이스 성능 조정

5만 장 이상의 사진을 가진 라이브러리의 경우 PostgreSQL을 조정하세요:

# docker-compose.yml에서 postgres 서비스 환경
POSTGRES_SHARED_BUFFERS=256MB
POSTGRES_EFFECTIVE_CACHE_SIZE=1GB
POSTGRES_MAINTENANCE_WORK_MEM=64MB
POSTGRES_CHECKPOINT_COMPLETION_TARGET=0.9
POSTGRES_WAL_BUFFERS=16MB
POSTGRES_DEFAULT_STATISTICS_TARGET=100

머신러닝 성능

배치 처리: 여러 사진을 동시에 처리하세요:

MACHINE_LEARNING_WORKERS=4  # CPU 코어 수와 일치

GPU 가속: 앞서 언급했듯이, GPU 가속은 ML 작업에 5-10배의 속도 향상을 제공합니다.

보안 최선 실천

인증 및 접근 제어

강력한 비밀번호: 비밀번호 관리자로 복잡한 비밀번호를 생성하고 저장하세요
2단계 인증: 관리자 계정에 2FA를 활성화하세요 (사용 중인 버전에 지원되는 경우)
정기적인 접근 검토: 주기적으로 사용자 계정을 검토하고 사용하지 않는 계정을 제거하세요

네트워크 보안

SSL과 함께 역방향 프록시 사용: Immich를 인터넷에 직접 노출시키지 마세요:

# Let's Encrypt으로 무료 SSL 인증서 사용
sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d photos.yourdomain.com

방화벽 설정:

# 필요한 포트만 허용
sudo ufw allow 22/tcp    # SSH
sudo ufw allow 80/tcp    # HTTP (HTTPS로 리디렉션)
sudo ufw allow 443/tcp   # HTTPS
sudo ufw enable

VPN 또는 Tailscale 사용: 최대 보안을 위해 VPN을 통해 Immich에 액세스하세요:

서버 및 장치에 Tailscale 설치
Tailscale IP (100.x.x.x)를 통해 액세스
공개 인터넷에 포트 노출 없음

컨테이너 보안

정기 업데이트: 보안 취약점을 패치하기 위해 Docker 이미지를 최신 상태로 유지하세요

루트리스 실행: 추가 격리를 위해 Docker 루트리스 모드를 설정하세요

리소스 제한: DoS 공격을 방지하기 위해 컨테이너 리소스를 제한하세요:

services:
  immich-server:
    deploy:
      resources:
        limits:
          cpus: '2'
          memory: 4G

일반적인 문제 해결

업로드 실패

증상: 모바일 앱에서 사진 업로드 실패

해결책:

서버 디스크 공간 확인: df -h
역방향 프록시 client_max_body_size 설정 확인
서버 로그 확인: docker compose logs immich-server
모바일 앱이 최신 버전인지 확인

머신러닝 처리 실패

증상: 얼굴 인식 또는 검색이 작동하지 않음

해결책:

ML 컨테이너 상태 확인: docker compose ps immich-machine-learning
ML 로그 확인: docker compose logs immich-machine-learning
ML 서비스 재시작: docker compose restart immich-machine-learning
모델 파일이 다운로드되었는지 확인: ls ~/immich/machine-learning/cache/

데이터베이스 연결 오류

증상: 웹 인터페이스에서 데이터베이스 연결 오류 발생

해결책:

PostgreSQL 컨테이너가 실행 중인지 확인: docker compose ps immich-postgres
데이터베이스 로그 확인: docker compose logs immich-postgres
.env 파일에서 올바른 비밀번호 확인
연결 테스트: docker exec -it immich-postgres psql -U postgres

느린 성능

증상: 웹 인터페이스 또는 검색이 느림

해결책:

시스템 리소스 확인: CPU, RAM, 디스크 I/O
데이터베이스 진공 실행: VACUUM ANALYZE;
서비스 재시작: docker compose restart
PostgreSQL 성능 설정 검토
하드웨어 업그레이드 고려 (SSD, 더 많은 RAM)

모바일 앱 동기화 실패

증상: 모바일 기기에서 사진이 백업되지 않음

해결책:

백그라운드 새로고침이 활성화되었는지 확인 (iOS)
포그라운드 서비스 활성화 (Android)
모바일 데이터 사용 시 WiFi만 설정 확인
모바일 네트워크에서 서버 URL이 접근 가능한지 확인
사진 액세스 권한 확인
앱 캐시 삭제 및 재로그인

다른 서비스에서의 이전

구글 포토에서

데이터 내보내기:

Google Takeout (takeout.google.com)으로 이동
Google Photos 선택
내보내기 형식 및 크기 선택
아카이브 다운로드

Immich로 가져오기:

다운로드한 아카이브 추출
Immich CLI 도구 또는 웹 업로드 사용
JSON 사이드카 파일에서 메타데이터 보존

# Immich CLI 사용 (릴리스에서 설치)
immich upload --recursive /path/to/google-photos-export/

iCloud 포토에서

내보내기:

iCloud.com 방문
다운로드할 사진 선택
또는 iCloud for Windows/Photos 앱 내보내기 사용

가져오기: 구글 포토와 유사하게 웹 인터페이스 또는 CLI 도구를 통해 업로드

로컬 저장소에서

외부 라이브러리 기능: 업로드 대신 기존 사진 디렉토리에 Immich를 가리키세요:

관리자 > 외부 라이브러리로 이동
라이브러리 경로 추가 (Docker 컨테이너에서 접근 가능해야 함)
Immich는 파일 복사 없이 스캔 및 인덱싱
디스크 공간 및 시간 절약

# docker-compose.yml에 볼륨 마운트 추가
volumes:
  - /mnt/existing-photos:/mnt/external-library:ro

커뮤니티 및 지원

공식 자료

GitHub: https://github.com/immich-app/immich
문서: https://immich.app/docs
Discord: 실시간 도움을 위한 활발한 커뮤니티
Reddit: r/immich에서 토론 및 팁

기여

Immich는 오픈소스이며 기여를 환영합니다:

버그 보고: GitHub에 상세한 이슈 보고
기능 요청: Discord 또는 GitHub Discussions에서 토론
코드 기여: 기여 지침에 따라 pull request 제출
문서: 사용자 경험 향상을 위한 문서 개선
번역: 당신의 언어로 Immich를 로컬라이즈하는 데 도움

대안 도구

Immich가 요구 사항에 부합하지 않는 경우, 다음을 고려하세요:

PhotoPrism: 더 성숙하고 기능이 풍부하며 다른 아키텍처
Piwigo: 전통적인 갤러리 스타일 인터페이스
Nextcloud Photos: 더 큰 Nextcloud 생태계의 일부
Photoview: 더 간단하고 가벼운 대안
LibrePhotos: AI 기능을 갖춘 Google Photos 대안

결론

Immich를 자체 호스팅하면 상업용 클라우드 사진 서비스의 강력하고 개인적인 대안을 제공합니다. 초기 기술 설정 및 지속적인 유지보수가 필요하지만, 완전한 프라이버시 제어, 저장 공간 제한 없음, 구독료에서 벗어나는 이점은 많은 사용자에게 가치가 있습니다.

자동 모바일 백업, AI 기반 검색, 얼굴 인식, 현대 인터페이스의 조합은 데이터를 당신의 통제 하에 두면서 상업용 제공과 유사한 경험을 제공합니다. 프라이버시 애호가, 대규모 사진 라이브러리가 있는 비용 효율적인 사용자, 또는 인프라 경험을 원하는 기술 전문가에게 Immich는 매력적인 솔루션입니다.

홈 서버 또는 VPS에서 시작하여 사진 라이브러리의 일부분으로 테스트하고, 시스템에 익숙해지면서 점차 이전하세요. 활발한 커뮤니티와 빈번한 업데이트로 인해 Immich는 계속해서 개선되고 기능이 추가될 것입니다.

당신의 기억은 소중합니다 - Immich로 그 통제를 취하십시오.

유용한 링크

공식 웹사이트: https://immich.app
GitHub 저장소: https://github.com/immich-app/immich
문서: https://immich.app/docs/overview/introduction
설치 가이드: https://immich.app/docs/install/docker-compose
디스코드 커뮤니티: https://discord.gg/immich
모바일 앱:
- iOS: https://apps.apple.com/app/immich/id1613945652
- Android: https://play.google.com/store/apps/details?id=app.alextran.immich
Docker Hub: https://hub.docker.com/r/ghcr.io/immich-app
릴리스 노트: https://github.com/immich-app/immich/releases
Awesome Immich: https://github.com/varun-raj/awesome-immich (커뮤니티 자원)
r/immich: https://reddit.com/r/immich