Immich 3.0 릴리즈 노트 / 새로운 기능

Immich v3.0.0은 강력한 자동화 도구, 모바일용 전문가 수준 사진 편집, 비디오 처리 및 백그라운드 동기화를 위한 핵심 인프라 개선을 도입하는 대규모 업데이트입니다. 이번 릴리즈에는 파괴적인 변경 사항이 포함되어 있지만, 팀은 대부분이 일반 사용자 경험보다는 타사 API 통합에 영향을 미친다고 밝혔습니다.

자동화 및 워크플로우

Immich v3.0.0은 워크플로우 미리보기를 도입합니다. 이는 사용자가 트리거, 필터 및 액션을 체인으로 연결하여 라이브러리 작업을 자동화할 수 있는 드래그‑앤‑드롭 빌더입니다.

사용자는 웹 인터페이스에서 Utilities > Workflows 로 이 기능에 접근할 수 있습니다. 시스템은 빌드를 위한 시각 편집기와 구성을 공유하기 위한 JSON 편집기를 모두 지원합니다. 각 워크플로우는 트리거(진입점)와 그 뒤를 잇는 일련의 단계로 구성되며, 여기에는 조건 필터와 특정 액션이 포함될 수 있습니다. 커뮤니티 협업을 촉진하기 위해 워크플로우는 일반 텍스트 또는 JSON 파일 형태로 공유될 수 있습니다.

모바일 경험 향상

비파괴 편집

모바일 사용자는 이제 v2.5.0에서 웹 버전으로 출시된 비파괴 편집 스위트를 이용할 수 있습니다. 이 시스템은 원본 파일을 수정하지 않고도 이미지 자르기, 회전 및 조정이 가능하도록 합니다. 편집 내용은 메타데이터로 저장되어 언제든지 다시 확인하거나 되돌릴 수 있으며, 모바일과 웹 플랫폼 간에 동기화됩니다.

이전 모바일 편집 기능 중 일부(예: 사진 색상 재조정, 라이브 사진 편집, 로컬 자산 편집)는 제거되었으며 향후 릴리즈에서 복귀될 예정입니다.

백그라운드 백업 안정성

백업 안정성이 주요 모바일 플랫폼 모두에서 크게 향상되었습니다:

• Android: 이전에 새로 촬영한 사진에만 적용되던 시스템을 대체하는 새로운 주기적 작업 스케줄러가 도입되었습니다. 이제 앱은 백그라운드에서 전체 라이브러리를 업로드할 수 있으며 Android의 백그라운드 실행 제한을 더 잘 준수하고 배터리 최적화 설정에 대한 경고를 제공합니다.
• iOS: 백그라운드 새로 고침 작업이 이제 동기화와 업로드 작업을 병렬로 실행하여 iOS가 제공하는 제한된 시간 창 내에서 업로드가 시작되도록 보장합니다.

Android 갤러리 통합

Immich는 이제 Android에서 시스템 갤러리/이미지 뷰어로 작동할 수 있습니다. 다른 애플리케이션에서 사진이나 비디오를 열 때, 사용자는 Immich를 선택해 자산을 Immich 뷰어에서 직접 볼 수 있으며, 파일을 라이브러리에 업로드하거나 공유하는 옵션도 제공합니다.

비디오 및 성능 인프라

실시간 비디오 트랜스코딩 (미리보기)

Immich는 이제 HLS(HTTP Live Streaming)와 실시간 비디오 트랜스코딩을 지원하여 서버가 비디오를 즉시 트랜스코딩할 수 있습니다. 이를 통해 모든 파일에 대한 오프라인 트랜스코드를 생성할 필요가 없어 저장소 부담이 감소합니다. 주요 이점은 다음과 같습니다:

• 자동 및 수동 품질 전환.
• 클라이언트 디바이스가 지원하는 최적 코덱으로 트랜스코딩.

이 기능은 실험 단계이며 현재 웹 앱에만 제한됩니다. 강력한 서버가 필요하며 하드웨어 가속을 강력히 권장합니다.

웹 비디오 플레이어

웹 앱용으로 새로운 커스텀 비디오 플레이어가 구현되어 모든 디바이스에서 일관된 컨트롤과 레이아웃을 제공합니다. 이는 특히 iOS에서 네이티브 OS 컨트롤이 Immich 네비게이션 바에 가려지는 문제를 해결합니다.

라이브러리 관리 및 유지보수

무결성 검사

데이터 안전성을 보장하기 위해 유지보수 페이지에 무결성 보고서가 포함되었습니다. Immich는 파일 시스템을 스캔하고 데이터베이스와 비교하여 다음을 식별합니다:

• 추적되지 않은 파일: 디스크에 존재하지만 데이터베이스에 없는 파일.
• 누락된 파일: 데이터베이스에 기록되어 있으나 디스크에 존재하지 않는 파일.
• 체크섬 불일치: 손상되었거나 잘못 이름이 변경된 파일.

최근 추가 페이지

웹(Explore 탭)과 모바일(Search 탭)에서 새로운 "최근 추가" 뷰를 사용할 수 있습니다. 이는 사진 촬영 날짜가 아니라 시스템에 추가된 날짜를 기준으로 자산을 정렬하여 대량 임포트 관리가 간편해집니다.

기술 마이그레이션 및 파괴적 변경 사항

v3로 업데이트하려면 docker compose pull && docker compose up -d 를 실행하기 전에 .env 파일의 IMMICH_VERSION 을 v3 로 변경해야 합니다.

파괴적 변경 사항은 주로 API와 내부 리팩터링을 대상으로 하며, 포함 내용은 다음과 같습니다:

• class-validator 에서 zod 로 마이그레이션.
• 사용 중단된 환경 변수와 여러 API 엔드포인트 제거(예: /api/server/theme 및 getRandom).
• pgvecto.rs 지원 중단.
• 머신러닝 컴포넌트를 위한 numpy 2.4 필요.

커뮤니티 인사이트

사용자들 사이의 논의는 Immich가 Tailscale 같은 네트워킹 도구와 결합될 때 Google 및 Apple Photos에 대한 강력한 자체 호스팅 대안으로 자리매김하고 있음을 강조합니다. 그러나 일부 사용자는 종단 간 암호화(E2EE)의 부재에 대해 우려를 표했습니다.

"Immich를 고려했지만 암호화 때문에 Ente를 선택했어요... 앨범을 공유하고 계정 없이도 누구나 기여할 수 있는 점이 마음에 들어요."

반대로 다른 사용자들은 홈 호스팅 데이터에 E2EE가 필요 없으며, 데이터 복구를 복잡하게 만든다고 주장합니다:

"E2EE가 없으니... 키를 잃어버려도 할머니의 추억을 담은 .jpg 파일들을 새 기기로 복사하면 됩니다."