시스템 설정
관리자 사용자는 여기서 Immich 인스턴스에 대한 설정을 관리할 수 있습니다.
기본 설정으로 돌아가려면 언제든지 기본값으로 재설정 버튼을 클릭할 수 있습니다.
인증 설정
비밀번호, OAuth 및 기타 인증 설정 관리
OAuth 인증
Immich는 OAuth 인증을 지원합니다. 이 기능 및 구성에 대한 자세한 내용을 여기에서 참조하세요.
비밀번호 인증
관리자는 인스턴스 전체에서 사용자 이름과 비밀번호로 로그인하는 기능을 비활성화할 수 있습니다. 이 설정을 활성화하면 시스템 관리자 포함 누구도 이 방법을 사용해 로그인할 수 없게 됩니다. OAuth 인증도 비활성화되어 있다면, 사용자들은 어떠한 방법으로도 로그인할 수 없게 됩니다. 이 설정 변경은 기존 세션에는 영향을 미치지 않으며, 새로운 로그인 시도에만 영향을 줍니다.
서버 CLI를 사용하여 언제든지 비밀번호 로그인을 다시 활성화할 수 있습니다.
이미지 설정 (썸네일과 미리보기)
- 썸네일 - 메인 타임라인에서 사용됩니다.
- 미리보기 - 자산 뷰어에서 사용됩니다.
기본적으로 Immich는 각 자산에 대해 3개의 썸네일을 생성합니다. 블러 처리된 썸네일 (thumbhash), 작은 썸네일 (webp), 및 큰 미리보기 (jpeg/webp). 이 설정을 사용하여 생성된 썸네일 및 미리보기 파일의 품질을 변경할 수 있습니다.
썸네일 형식
썸네일 이미지를 원하는 형식으로 선택할 수 있습니다. Webp는 JPEG보다 파일 크기가 작지만, 인코딩 속도가 느립니다.
Webp를 사용하는 장점과 단점에 대한 자세한 내용은 Adobe 웹사이트를 참조하세요.
썸네일 해상도
사진 그룹을 볼 때 사용 (메인 타임라인, 앨범 뷰 등). 더 높은 해상도는 더 많은 디테일을 유지할 수 있지만, 인코딩 시간이 길어지고, 파일 크기가 커지며, 앱 응답성이 감소할 수 있습니다.
미리보기 형식
미리보기 이미지를 원하는 형식으로 선택할 수 있습니다. Webp는 JPEG보다 파일 크기가 작지만, 인코딩 속도가 느립니다.
미리보기 해상도
단일 사진을 볼 때 및 머신 러닝에 사용됩니다. 더 높은 해상도는 더 많은 디테일을 유지할 수 있지만, 인코딩 시간이 길어지고, 파일 크기가 커지며, 앱 응답성이 감소할 수 있습니다.
품질
1-100의 이미지 품질. 높은 값은 더 나은 품질을 제공하지만 더 큰 파일을 생성하며, 이 옵션은 미리보기 및 썸네일 이미지에 영향을 미칩니다.
넓은 색영역 선호
썸네일에 Display P3 사용. 이는 넓은 색 공간을 가진 이미지의 생동감을 더 잘 유지하지만, 오래된 브라우저 버전의 구형 장치에서는 이미지가 다르게 보일 수 있습니다. sRGB 이미지는 색상 변화를 피하기 위해 sRGB로 유지됩니다.
내장된 미리보기 선호
RAW 사진에서 내장된 미리보기를 사용할 수 있는 경우 이미지 처리의 입력으로 사용합니다. 이는 일부 이미지에서 더 정확한 색상을 생성할 수 있지만, 미리보기 품질은 카메라에 따라 달라질 수 있으며 이미지에 더 많은 압축 아티팩트가 생길 수 있습니다.
큰 썸네일의 기본 해상도를 1440p (기본값)에서 1080p 또는 720p로 낮추어 저장 공간을 절약할 수 있습니다.
작업 설정
이 설정을 사용 하여 마이크로서비스의 각 작업에서 동시에 실행될 작업량을 관리할 수 있습니다. 강력한 하드웨어와 우수한 I/O 성능을 갖춘 저장 장치와의 컴퓨터에서는 더 높은 값을 설정할 수 있습니다.
높은 동시성에서 호스트는 더 많은 자산을 병렬로 작업하며, 이 조언은 대기 시간이 아닌 처리량을 개선하며, 예를 들어 스마트 검색 작업을 더 빠르게 처리하지만 검색 속도를 높이진 않습니다.
스마트 검색, 얼굴 감지, 얼굴 인식, 그리고 비디오 트랜스코드와 같은 작업은 많은 처리 능력이 필요하므로 작업량 과다 설정은 서버를 심하게 과부하시킬 수 있습니다.
기본 설정에서 동시성을 증가한다면, 특히 썸네일 생성에 대해, CPU 코어 수를 초과하여 증가하지 않도록 확실히 해야 합니다. 동시에 이는 API 응답성에 영향을 미칠 수 있으며 썸네일 생성 속도 면에서 아무런 이득이 없습니다.
얼굴 인식 동시성 값은 변경할 수 없습니다. 왜냐하면 DBSCAN이 전통적으로 순차적이지만 병렬 구현도 있습니다. 우리의 구현은 병렬이 아닙니다.
외부 라이브러리
라이브러리 감시 (실험적)
외부 라이브러리는 변경된 파일을 전체 새로 스캔 없이 자동으로 가져올 수 있습니다. 운영체제가 파일 변경을 보고할 때 파일을 가져옵니다. 사진이 네트워크를 통해 마운트된 경우 이는 작동하지 않습니다.
주기적 스캔
관리 -> 설정 -> 라이브러리에서 사용자 정의 간격을 정의하여 외부 라이브러리 새로 스캔을 트리거할 수 있습니다.
스캐닝 간격을 프리셋 또는 크론 형식으로 설정할 수 있습니다. 자세한 내용은 크론탭 구루를 참조하세요.
로깅
기본 Immich 로그 레벨은 Log (Info로 알려져 있음)입니다. Immich 관리자는 개인 선호도에 따라 또는 Immich 지원 팀의 요청에 따라 더 높거나 낮은 로그 레벨을 선택할 수 있습니다.
머신 러닝 설정
이 설정을 통해 Immich 내 모든 머신 러닝 관련 설정을 관리할 수 있습니다. 원격 머신 러닝 설정부터 모델과 그 매개변수까지 예를 들어 스마트 검색 또는 얼굴 인식 등 특정 유형의 머신 러닝을 비활성화할 수 있습니다.
URL
기본적으로 내장된 (http://immich-machine-learning:3003) 머신 러닝 서버가 구성됩니다. 그러나 이를 변경하거나 추가 서버를 추가할 수 있습니다.
immich-machine-learning 컨테이너를 더 강력한 GPU를 가진 머신에서 호스팅하면 대량 사진 처리 (예: 배치 수입 시)나 더 빠른 검색 속도를 위한 도움이 될 수 있습니다.
URL이 여러 개 제공된 경우 각 서버는 순서대로 하나씩 시도되며 첫 번째로 성공적으로 응답한 서버를 사용합니다. 응답하지 않는 서버는 온라인으로 돌아올 때까지 임시로 무시됩니다.
스마트 검색
스마트 검색 설정을 사용하여 CLIP 모델을 변경할 수 있습니다. 더 큰 모델은 일반적으로 더 정확한 검색 결과를 제공하지만 더 많은 처리력과 RAM을 소모합니다. CLIP 모델 변경을 수행한 경우 모든 이미지에서 스마트 검색 작업을 다시 실행하여 변경을 완전히 적용해야 합니다.
모델 변경은 모델 다운로드를 위해 인터넷 연결이 필요합니다. 다운로드 후에는 Immich가 네트워크에 연결할 필요가 없습니다. 버전 검사가 설정에서 활성화되지 않은 경우.
중복 감지
CLIP 임베딩을 사용하여 가능성 높은 중복을 찾습니다. 최대 감지 거리를 설정하여 정확성 수준을 개선하거나 줄일 수 있습니다.
- 최대 감지 거리 - 두 이미지 간 최대 거리로 중복으로 간주, 0.001-0.1 범위. 더 높은 값은 더 많은 중복을 감지하지만 오탐지가 발생할 수 있습니다.
얼굴 인식
이 설정에서 얼굴 인식 설정을 변경할 수 있습니다. 편집 가능한 설정:
- 얼굴 인식 모델
- 최소 감지 점수
- 최대 인식 거리
- 최소 인식된 얼굴
이 옵션에 대한 자세한 내용은 얼굴 인식 페이지에서 참조하세요.
최소 감지 점수, 최대 인식 거리 및 최소 인식된 얼굴 값 변경 시. FACE RECOGNITION - ALL 작업만 재시작해야 합니다.
얼굴 인식 모델을 교체한 경우 FACE DETECTION - ALL 작업을 실행해야 합니다.
쌍둥이가 있다면 최대 인식 거리 값을 낮추는 것을 고려해볼 수 있습니다. 약간 줄이면 쌍둥이를 구별할 수 있습니다.
지도 & GPS 설정
지도 설정
이 설정에서 개인 선호도와 지원되는 옵션에 따라 낮과 밤 모드에서 지도의 외관을 변경할 수 있습니다. 예를 들어 지도는 OpenMapTiles를 통해 조정 가능합니다.
역지오코딩 설정
Immich는 GeoNames 지리 데이터베이스의 데이터를 사용하여 역지오코딩을 지원합니다.
알림 설정
SMTP 서버 설정, 사용자 생성 알림, 새로운 앨범 등을 위해. 자세한 내용은 여기에서 참조하세요.
알림 템플릿
알림 텍스트를 템플릿으로 재정의합니다. 자세한 내용은 여기에서 참조하세요.
서버 설정
외부 도메인
공유 링크와 이메일 알림에서 도메인 이름을 재정의합니다. URL은 끝에 슬래시를 포함하지 않습니다.
환영 메시지
관리자는 로그인 화면에 사용자 정의 메시지를 설정할 수 있습니다 (모든 사용자에게 표시됨).
저장 템플릿
Immich는 사용자 정의 저장 템플릿을 지원합니다. 이 기능 및 구성에 대한 자세한 내용은 여기를 참조하세요.
테마 설정
웹 애플리케이션에서 모든 사용자에게 로드될 사용자 정의 CSS를 작성할 수 있습니다. 이를 통해 관리자는 글꼴, 색상, 기타 스타일을 변경할 수 있습니다.
예:
p {
color: green;
}
휴지통 설정
시스템 관리 옵션에서 삭제된 파일을 위해 휴지통을 설정할 수 있으며, 이 파일은 삭제 날짜까지 30일 (기본값) 또는 시스템 관리자가 정의한 기간 동안 휴지통에 남아 있 습니다.
휴지통은 비활성화할 수 있지만, 이는 권장되지 않습니다. 비활성화할 경우 향후 삭제된 파일은 영구적으로 삭제됩니다.
자산을 선택하고 타임라인에서 Ctrl + Del을 눌러 휴지통 옵션 없이 빠르게 영구 삭제할 수 있습니다.
사용자 설정
삭제 지연
시스템 관리자는 관리 패널을 통해 사용자를 삭제할 수 있으며, 즉시 삭제하거나 사용자를 위해 삭제를 지연(기본적으로 7일)시킬 수 있습니다. 이 작업을 통해 사용자의 계정과 자산이 영구적으로 삭제됩니다. 사용자 계정 삭제 작업은 자정에 실행되어 삭제 준비가 완료된 사용자를 확인합니다. 이 설정 변경 사항은 다음 실행 시 평가됩니다.
버전 확인
이 옵션을 활성화하면 immich-server가 GitHub에 주기적으로 요청을 보내 새 릴리스를 확인합니다.
비디오 트랜스코딩 설정
시스템 관리자는 어떤 비디오 파일을 다른 형식으로 변환할지 구성할 수 있습니다. 설정은 심층적으로 변경할 수 있으며, 여기에서 사용된 용어에 대해 더 알고 싶다면 FFmpeg의 H.264 코덱, HEVC 코덱 및 VP9 코덱에 대한 문서를 참조하십시오.
비디오 파일의 어떤 스트림이 트랜스코딩될지는 트랜스코딩 정책에 따라 결정됩니다. 트랜스코딩된 스트림은 아래 설정을 따르며(구성 파일 이름이 괄호 안에 제공됨), 트랜스코딩되지 않은 스트림은 원래 설정을 유지합니다.
허용된 컨테이너 (ffmpeg.acceptedContainers)
비디오 자산의 컨테이너 형식이 이 목록에 없 으면, 스트림을 트랜스코딩할 필요가 없더라도 MP4로 리머클될 수 있습니다.
기본 허용 컨테이너 형식은 mov, ogg, webm입니다.
프리셋 (ffmpeg.preset)
트랜스코딩에 투입할 "계산 노력"의 양. 이 값은 h264의 프리셋 이름을 사용하며, 다른 방식으로 노력 설정을 구성하는 인코더에 맞게 적절한 값으로 변환됩니다.
기본값은 ultrafast입니다.
오디오 코덱 (ffmpeg.targetAudioCodec)
오디오 스트림이 트랜스코딩될 때 사용할 코덱. mp3, aac, libopus 중 하나를 선택할 수 있습니다.
기본값은 aac입니다.
비디오 코덱 (ffmpeg.targetVideoCodec)
비디오 스트림이 트랜스코딩될 때 사용할 코덱. h264, hevc, vp9, av1 중 하나를 선택할 수 있습니다.
기본값은 h264입니다.
목표 해상도 (ffmpeg.targetResolution)
비디오 스트림을 트랜스코딩할 때, 가로세로 비율을 유지하면서 가장 큰 치수를 이 값으로 축소합니다. 비디오는 절대 확대되지 않습니다.
기본값은 720입니다.
트랜스코딩 정책 (ffmpeg.transcode)
트랜스코딩 정책은 비디오 자산의 어떤 스트림이 트랜스코딩될지를 구성합니다. 비디오 스트림과 오디오 스트림의 트랜스코딩 결정은 독립적으로 이루어집니다. 예를 들어 비디오 스트림은 트랜스코딩이 필요하지만, 오디오 스트림은 그렇지 않다면 비디오 스트림은 트랜스코딩되고 오디오 스트림은 복사됩니다. 트랜스코딩 정책이 어떤 스트림도 트랜스코딩하지 않거나 비디오를 리머클할 필요가 없는 경우 별도 비디오 파일이 생성되지 않습니다.
기본 정책은 required입니다.
모든 비디오 (all)
비디오는 항상 트랜스코딩됩니다. 이는 비디오 재생 중 일관성을 보장합니다.
비디오를 전혀 트랜스코딩하지 않음 (disabled)
비디오는 절대 트랜스코딩되지 않습니다. 이는 서버의 공간과 리소스를 절약할 수 있으나, 원본 형식을 지원하지 않는(특히 웹 브라우저) 장치에서 재생이 불가능할 수 있으며, 고비트레이트 파일을 재생할 때 높은 대역폭 사용량을 초래할 수 있습니다.
허용 형식이 아닌 비디오만 (required)
다음 조건 중 하나라도 충족되는 경우 비디오 스트림이 트랜스코딩됩니다:
- 비디오가 HDR인 경우.
- 비디오가 yuv420p 픽셀 형식이 아닌 경우.
- 비디오 코덱이
acceptedVideoCodecs에 없는 경우.
오디오 코덱이 acceptedAudioCodecs에 없을 경우 오디오가 트랜스코딩됩니다.
최대 비트레이트를 초과하거나 허용 형식이 아닌 비디오 (bitrate)
추가적으로, required의 조건 외에도 비디오 스트림의 비트레이트가 maxBitrate를 초과하면 트랜스코딩됩니다.
목표 해상도를 초과하거나 허용 형식이 아닌 비디오 (optimal)
required의 조건 외에도, 비디오 스트림의 가로 및 세로 차원이 모두 targetResolution을 초과하면 트랜스코딩됩니다.