Immich 문제 해결: 사진 복구 및 서버 설정에 대한 완벽 가이드

최종 업데이트: 2026년 06월 22일

  • Docker에서 올바른 볼륨 매핑과 시스템 관리에서의 경로 설정을 통해 외부 라이브러리를 구현합니다.
  • 머신러닝 및 동시성 매개변수 조정을 통한 얼굴 인식 및 메타데이터 처리 최적화.
  • 리눅스에서 파일 권한을 관리하여 외장 하드 드라이브 또는 NAS 장치의 읽기/쓰기 오류를 방지하는 방법입니다.
  • Tailscale과 같은 VPN 네트워크를 사용하고 백그라운드 백업을 설정하여 모바일 장치를 효율적으로 동기화할 수 있습니다.
이미치 문제 해결

클라우드 저장 공간에 대한 월 사용료를 지불하고 대기업이 내 소중한 추억을 엿보는 것에 지쳤다면, 나만의 클라우드 스토리지 인스턴스를 구축해 보세요. 로컬 서버의 Immich 간단히 말해서, 이것은 당신이 내릴 수 있는 최고의 결정입니다. 구글 포토의 기능을 거의 완벽하게 모방하는 강력한 오픈 소스 대안이지만, 근본적인 차이점은 다음과 같습니다. 당신은 완벽한 통제권을 가지고 있습니다. 파일이 어디에 있는지, 누가 파일에 접근할 수 있는지 알 수 있습니다. 실제로 많은 사용자가 이 기능을 활용하여 특정 작업을 수행합니다. Google 포토에서 Immich로 마이그레이션하는 완벽 가이드 그리고 사생활을 되찾습니다.

이 애플리케이션은 안정 버전으로 상당한 완성도를 갖추었지만, 처음에는 한두 가지 문제가 발생하는 것은 정상입니다. 기술적 문제 또는 예상치 못한 오류예를 들어 시스템에서 새 이미지를 감지하지 못하거나 썸네일 로딩 시 오류가 발생하는 경우입니다. 걱정하지 마세요. 이러한 문제는 대부분 사소한 문제입니다. 권한 오류 또는 경로 설정 오류 Docker 환경에서 발생하는 이 문제는 몇 가지 적절한 조정을 통해 해결할 수 있습니다.

로컬 컴퓨터에서 PhotoPrism을 개인 AI 기반 갤러리로 사용하는 방법
관련 기사:
로컬 컴퓨터에서 PhotoPrism을 개인 AI 기반 갤러리로 사용하는 방법

사진이 나타나지 않는 문제를 해결하는 방법

Immich에서 사진이 나타나지 않는 문제를 해결하는 방법

수동으로 폴더를 정리하는 데 익숙한 사용자들이 흔히 저지르는 실수는 사진을 Immich 디렉토리에 직접 복사하고 자동으로 나타날 거라고 기대하는 것입니다. Immich는 파일 이름 충돌을 방지하기 위해 업로드 폴더 내에서 임의의 구조로 파일을 관리합니다. 자신만의 폴더 구조를 유지하고 싶다면 파일을 업로드 경로로 이동하는 대신 특정 폴더 구조를 설정해야 합니다. 외부 라이브러리 관리자 패널에서.

독점 콘텐츠 - 여기를 클릭하세요  도쿠사우루스: 전문적인 기술 문서를 작성하는 방법

서버에서 이미지를 "인식"하지 못할 경우 가장 먼저 확인해야 할 사항은 다음과 같습니다. docker-compose.yml 파일의 볼륨 매핑외장 하드 드라이브나 NAS에 폴더를 마운트한 경우 호스트 경로와 컨테이너 경로가 일치하거나 올바르게 연결되어 있는지 확인해야 합니다. 파일은 있지만 Immich에서 표시되지 않는다면 다음 단계를 따라야 할 수 있습니다. 관리 > 외부 라이브러리새 라이브러리를 생성하고 수동 스캔을 실행하여 시스템이 콘텐츠를 색인화하도록 하십시오.

또 다른 답답한 상황은 다음과 같은 오류입니다. "이미지를 불러오는 데 실패했습니다." 또는 썸네일이 표시되지 않는 경우도 있습니다. 이는 일반적으로 PostgreSQL 데이터베이스 메타데이터가 파일의 물리적 위치와 일치하지 않는 재설치 또는 마이그레이션 후에 발생합니다. 이 문제를 해결하려면 다음이 필수적입니다. 마이그레이션 및 스캔 작업을 다시 실행합니다. 작업 메뉴에서 서버가 작업 대기열을 처리하는 데 필요한 리소스를 확보했는지 확인하십시오.

구글 포토와는 달리, 이미히는 이미지의 물리적 저장 방식과 이미지를 정리하는 데 사용하는 정보를 분리합니다.사진은 파일 시스템에 저장되고, 앨범, 식별된 인물, 태그, 썸네일 및 메타데이터는 PostgreSQL에 저장됩니다. 이러한 아키텍처 덕분에 원본 파일과 데이터베이스가 보존되는 한, 시스템은 마이그레이션이나 하드웨어 변경 후에도 라이브러리의 대부분을 재구축할 수 있습니다.

파일 권한: 도커의 아킬레스건

모든 설정이 올바르게 되어 있는 것 같은데도 사진이 보이지 않는다면, 아마도 다음과 같은 문제가 있을 가능성이 높습니다. 읽기/쓰기 권한 문제Docker는 일반적으로 특정 사용자 계정으로 컨테이너를 실행하는데, 이 사용자는 외장 하드 드라이브나 UGreen 또는 Synology NAS의 폴더에 접근 권한이 없을 수 있습니다. 이로 인해 경로가 올바르더라도 Immich가 파일을 읽을 수 없게 됩니다.

독점 콘텐츠 - 여기를 클릭하세요  NPM을 사용하여 Windows에 Flowise를 설치하는 방법

이 문제를 영구적으로 해결하려면 Linux 서버의 터미널에 접속하여 소유권과 권한을 변경해야 합니다. 다음 명령어를 사용하세요. sudo chown -R your_username:your_username /path/to/your/photos 그리고 나중에 sudo chmod -R 775 /path/to/your/photos컨테이너에서 파일 시스템에 접근할 수 있도록 해야 합니다. 이는 많은 사람들이 간과하는 매우 중요한 단계이며, 파일 가시성 오류의 90%를 차지하는 원인입니다.

서버 설치 및 최적화

Immich 서버 설치 및 최적화

Immich를 원활하게 실행하려면 Intel N100 기반의 미니 PC나 Docker가 설치된 NAS에 설치하는 것이 이상적입니다. 이 아키텍처는 최소 2코어 이상의 서버를 필요로 하며, 4GB RAM으로도 작동하지만 대용량 라이브러리를 사용할 경우 더 많은 RAM을 사용하는 것이 좋습니다. 8GB 또는 16GB로 업그레이드하세요PostgreSQL 및 Redis 데이터베이스는 반드시 동일한 위치에 있어야 합니다. SSD 또는 NVMe 드라이브 병목 현상을 방지하기 위해 HDD는 이미지의 대용량 저장 용도로만 사용합니다.

.env 파일에서 해당 변수에 특히 주의하세요. 업로드 위치이 경로는 모바일 앱에서 직접 업로드된 파일이 저장될 위치를 가리켜야 합니다. 중요한 점은 이 폴더를 외장 라이브러리 내부에 두지 않는 것입니다. 이렇게 하면 문제가 발생할 수 있습니다. 무한 스캔 루프 이는 "새 사진"을 찾는 동안 서버 프로세서에 과부하를 일으킬 수 있습니다.

인공지능 및 얼굴 인식 기술 향상

AI 및 얼굴 인식 기능 향상

Immich에서 인재를 식별하고 관리하는 방법
관련 기사:
Immich에서 인재를 식별하고 관리하는 방법

Immich의 강점 중 하나는 AI를 사용하여 얼굴을 그룹화하고 사물을 검색하는 기능입니다. 사진이 수천 장인 경우 첫 번째 스캔에 며칠이 걸릴 수 있습니다. 이 프로세스 속도를 높이려면 설정을 조정할 수 있습니다. 작업 설정에서의 동시성CPU 성능이 허용하는 경우 서버가 더 많은 작업을 동시에 처리할 수 있도록 합니다. 또한 NVIDIA 그래픽 카드를 사용하는 경우 설정을 통해 성능을 향상시킬 수 있습니다. CUDA 가속 처리 시간을 획기적으로 단축할 것입니다.

독점 콘텐츠 - 여기를 클릭하세요  HP BIOS에서 AHCI 모드를 활성화하는 방법(단계별)

얼굴 인식 정확도가 떨어지는 것을 발견하면 설정을 변경해 볼 수 있습니다. 최대 인식 거리 머신 러닝 설정에서 0.4라는 값이 일반적으로 적절한 균형을 이룹니다. 100.000만 개 이상의 파일로 구성된 대규모 라이브러리의 경우, 이 값을 높이는 것이 좋습니다. 최소한으로 인식된 얼굴 시스템이 오류를 포함한 수천 개의 작은 그룹을 생성하는 것을 방지하고, 검색을 더욱 정밀하게 하기 위해 값을 점진적으로 낮추는 것입니다.

모바일 동기화 및 원격 액세스

Immich 앱은 훌륭하지만, 특히 안드로이드에서 진정한 자동 백업을 위해서는 앱의 배터리 설정으로 이동하여 해당 기능을 활성화해야 합니다. "제한 없음"그렇지 않으면 운영체제가 백그라운드 프로세스를 종료시켜 사용자가 직접 앱을 열기 전까지 사진이 업로드되지 않습니다. iOS에서도 비슷한 상황이 발생하지만, iOS는 백그라운드 프로세스에 대해 더 엄격한 제한을 두고 있습니다.

서버를 인터넷의 위험에 노출시키지 않고 집 밖에서 사진에 접근하는 가장 간단하고 안전한 방법은 다음과 같습니다. 꼬리 비늘이 도구는 기기 간에 개인 VPN 네트워크를 생성하여 복잡한 리버스 프록시나 SSL 인증서를 설정할 필요 없이 고정 IP 주소를 사용하여 서버에 액세스할 수 있도록 합니다. 더 자세한 내용은 다음을 참조하세요. Tailscale을 사용하여 친구와 NAS를 공유하는 방법 접근성을 확대하기 위해서입니다. 전 세계 어디에서든 나만의 "구글 포토"를 이용할 수 있는 가장 빠른 방법입니다.

Immich를 최신 상태로 유지하는 것은 다음 명령어를 실행하는 것만큼 간단합니다. Docker Compose 풀 그리고 컨테이너를 재시작하세요. 사진뿐만 아니라 특히 중요한 파일들을 정기적으로 백업하는 것을 잊지 마세요. 포스트그레스SQL 데이터베이스라이브러리의 모든 구성, 태그 및 경로 정보가 그곳에 저장되기 때문입니다. 3-2-1 백업(세 개의 복사본, 두 개의 저장 매체, 하나의 외장 드라이브)만이 데이터 손실을 방지하는 유일한 확실한 방법입니다.