simulot/immich-go

어떤 프로젝트인가요?

핵심 기능

• 01로컬 폴더, Google Photos Takeout, iCloud 내보내기 파일, Picasa 폴더, ZIP 아카이브에서 업로드
• 02필터링 기능을 사용해 Immich 서버 간 에셋 복사
• 03소스 메타데이터의 앨범, 태그, 설명, 위치 정보 보존
• 04중복 감지 및 RAW+JPEG 쌍과 연속 촬영 사진 스택 처리
• 05Node.js나 Docker에 의존하지 않는 단일 바이너리로 제공

활용 사례

• Google Photos 라이브러리를 셀프 호스팅 Immich 서버로 마이그레이션
• iCloud Photos 내보내기 파일을 Immich로 가져오기
• 한 Immich 인스턴스에서 다른 인스턴스로 에셋 이동
• NAS나 디스크에 보관된 대용량 사진 아카이브 일괄 업로드

빠른 시작

1. 1

   GitHub 릴리스 페이지에서 시스템에 맞는 사전 빌드 바이너리 다운로드

2. 2

   로컬 폴더에서 사진 업로드

   immich-go upload from-folder --server=http://your-ip:2283 --api-key=your-api-key /path/to/your/photos
3. 3

   Google Photos Takeout 업로드

   immich-go upload from-google-photos --server=http://your-ip:2283 --api-key=your-api-key /path/to/takeout-*.zip

사용 전 알아둘 점

• !작성자에 따르면 아직 충분한 테스트가 이루어지지 않은 초기 버전입니다.
• !실행 중인 Immich 서버와 적절한 권한이 있는 API 키가 필요합니다.
• !네트워크 사용 의무가 포함된 카피레프트 라이선스인 AGPL-3.0에 따라 라이선스가 부여됩니다.

토픽

자주 묻는 질문

immich-go은(는) 무엇인가요?

Google Photos Takeout 아카이브를 포함한 사진 컬렉션을 Node.js 없이 셀프 호스팅 Immich 서버에 업로드하는 Go CLI 도구입니다. Immich-go는 대용량 사진 라이브러리를 셀프 호스팅 Immich 서버로 옮기는 CLI 도구입니다. 공식 immich-cli의 대안으로 사용할 수 있으며, 단일 바이너리로 배포되어 Node.js나 Docker 없이 실행됩니다.

immich-go은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

immich-go은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

immich-go은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. immich-go의 마지막 커밋은 2026년 10월 18일입니다.

immich-go은(는) 어디에 사용할 수 있나요?

Google Photos 라이브러리를 셀프 호스팅 Immich 서버로 마이그레이션 iCloud Photos 내보내기 파일을 Immich로 가져오기 한 Immich 인스턴스에서 다른 인스턴스로 에셋 이동 NAS나 디스크에 보관된 대용량 사진 아카이브 일괄 업로드

immich-go는 어떻게 설치하나요?

GitHub 릴리스 페이지에서 시스템에 맞는 사전 빌드 바이너리 다운로드 로컬 폴더에서 사진 업로드: immich-go upload from-folder --server=http://your-ip:2283 --api-key=your-api-key /path/to/your/photos Google Photos Takeout 업로드: immich-go upload from-google-photos --server=http://your-ip:2283 --api-key=your-api-key /path/to/takeout-*.zip

immich-go은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/simulot/immich-go