Technical Anshu 홈 › 튜토리얼 › Immich Docker 설치
🐳 Docker 자체 호스팅 사진

Docker를 사용한 Immich 설치 - 가장 빠른 방법

Immich는 타임라인, 앨범, 얼굴 검색, 자동 전화 백업 기능을 갖춘 나만의 비공개 Google 포토입니다. 집에 있는 컴퓨터에서 실행됩니다. 공식 Docker Compose 설치는 짧기로 유명합니다. 다운로드할 파일 2개, 편집할 파일 1개, 실행할 명령 1개입니다.

✍️ Technical Anshu🐳 Docker / Linux Server🎧 Multi-Language Audio
Docker를 사용한 Immich 설치 - 가장 빠른 방법
🎧 다국어 오디오: 동영상 플레이어에서 [설정] (⚙️) ➔ [오디오 트랙]을 클릭하여 언어를 선택하세요.

📑챕터

  1. Immich를 선택해야 하는 이유 — 자체 하드웨어에서 비공개 Google 포토를 대신할 수 있는 대안
  2. 시작하기 전에 필요한 것 — 머신, Docker 및 스토리지
  3. 두 개의 공식 파일을 다운로드하세요
  4. .env 파일 편집 - UPLOAD_LOCATION 및 DB_PASSWORD
  5. 하나의 명령으로 스택 시작
  6. 포트 2283에서 Immich를 열고 관리자 계정을 생성하세요
  7. 첫 날부터 따라야 할 4개의 컨테이너와 규칙

📋 개요 및 단계별 가이드

1

먼저 필요한 것을 확인하세요

Immich는 무료 오픈 소스인 자체 호스팅 사진 및 비디오 백업 플랫폼이며 이를 실행하는 공식적인 방법은 Linux 서버, 오래된 PC, 미니 PC 또는 Docker를 지원하는 NAS에서 Docker Compose를 사용하는 것입니다. 기계는 계속 켜져 있어야 합니다. 매일 저녁 잠을 자는 노트북은 나쁜 사진 서버입니다. 처음에는 저장용량이 부족해지므로 전체 사진 라이브러리를 위한 공간과 미리보기 이미지 및 트랜스코딩된 동영상을 위한 추가 공간을 약 10~20% 추가로 계획하세요.

실용 바닥면에는 약 4GB의 RAM이 있습니다. 기계 학습 컨테이너는 배고픈 부분이므로 6~8GB가 눈에 띄게 더 행복합니다. Docker 및 Docker Compose가 설치되어 작동하는지 확인하세요.

터미널
docker compose version
2

폴더 생성 및 두 개의 공식 파일 다운로드

블로그나 포럼 게시물에서 임의의 docker-compose 파일을 복사하지 마세요. 버전이 다르고 낯선 사람의 파일로 인해 오래된 빌드에 고정될 수 있습니다. 공식 파일은 항상 프로젝트의 GitHub 릴리스 페이지에 있습니다. 폴더를 만들고 해당 폴더로 이동하세요.

터미널
mkdir ./immich-app
cd ./immich-app

작성 파일 및 환경 템플릿을 다운로드하세요.

터미널
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
》 두 번째 명령의 이름 변경에 유의하세요. 템플릿 이름은 example.env이지만 Docker는 파일 이름이 정확히 .env인 경우에만 템플릿을 읽습니다.
3

.env 파일 편집 — 중요한 유일한 구성

.env 파일에는 Immich가 추측할 수 없는 몇 가지 값이 포함되어 있습니다. 열어보세요:

터미널
nano .env

UPLOAD_LOCATION=./library를 설정하세요 — 원본 사진과 동영상이 저장될 위치입니다. 가장 크고 가장 안정적인 디스크를 가리킵니다. 데이터베이스에 대해 DB_DATA_LOCATION=./postgres을 설정하고 DB_PASSWORD을 긴 임의의 암호로 변경합니다. TZ의 주석 처리를 제거하고 시간대(예: 아시아/콜카타)를 설정하여 사진 촬영 날짜와 예약된 작업이 일치하도록 하세요. 처음 설치하는 경우 IMICH_VERSION과 표시된 줄 아래의 모든 내용을 그대로 두세요.

⚠️ 라이브러리를 보호하는 두 가지 규칙: DB_PASSWORD에는 문자와 숫자(A-Z, a-z, 0-9)만 사용하십시오. 특수 문자는 Docker의 파일 구문 분석을 중단시킬 수 있습니다. 그리고 데이터베이스를 로컬 디스크, 이상적으로는 SSD에 보관하십시오. Immich의 문서는 데이터베이스에 대해 네트워크 공유가 지원되지 않으며 이를 실행하면 손상될 수 있다는 점을 직설적으로 설명합니다.
4

스택 시작

하나의 명령으로 모든 것이 시작됩니다. Docker는 컨테이너 이미지를 다운로드하고 함께 시작합니다. 첫 번째 실행은 인터넷 속도에 따라 몇 분 정도 걸립니다.

터미널
docker compose up -d
docker compose ps

두 번째 명령은 모든 것이 제대로 작동하는지 확인합니다. 서버, 머신러닝, 데이터베이스, Redis 컨테이너가 실행되고 있는지 확인해야 합니다.

5

Immich를 열고 관리자 계정 만들기

동일한 네트워크의 브라우저에서 Immich를 엽니다. 포트 2283에서 응답합니다.

브라우저 주소 표시줄
http://YOUR-SERVER-IP:2283

환영 화면을 클릭하고 등록하세요. 생성된 첫 번째 계정이 관리자가 됩니다. 따라서 네트워크의 다른 사람이 페이지를 찾기 전에 즉시 이 단계를 직접 수행하십시오. 그런 다음 휴대전화에 무료 Immich 앱을 설치하고 동일한 서버 주소로 로그인한 다음 자동 백업을 켜세요.

6

네 가지 컨테이너와 규칙을 알아보세요

작성 파일은 단일 프로그램이 아닌 소규모 팀을 실행합니다. immich-server은 웹 인터페이스, API, 업로드, 앨범 및 검색과 같은 두뇌입니다. immich-machine-learning는 눈입니다. 얼굴 감지, 얼굴 인식 및 스마트 검색입니다. PostgreSQL 데이터베이스는 메모리입니다. 원본은 파일인 반면 모든 사진의 이름, 날짜, 앨범 및 얼굴 데이터는 여기에 저장됩니다. Redis는 서버와 백그라운드 작업자 간에 작업을 전달하는 메신저입니다. 이 분할을 아는 것은 나중에 중요합니다. 검색이 중단되면 기계 학습을 확인합니다. 사진이 타임라인에서 사라졌지만 파일이 아직 디스크에 남아 있다면 데이터베이스를 확인하세요.

✅ 첫날부터 두 가지 규칙을 따르십시오. 모든 업데이트 전에 릴리스 노트를 읽으십시오. — Immich 릴리스는 자주 출시되며 일부 릴리스에는 특정 업그레이드 단계가 필요한 주요 변경 사항이 포함되어 있습니다. 그리고 대체할 수 없는 사진의 또 다른 백업을 다른 곳에 보관하십시오. 서버도 실패할 수 있는 단일 시스템이기 때문에 개발자 스스로 조언합니다.

🏷️Topic Search Variables & Keywords

🔍 Immich 🔍 Docker Compose 🔍 Self Hosted Photos 🔍 Google Photos Alternative 🔍 Photo Backup Server 🔍 UPLOAD_LOCATION 🔍 DB_PASSWORD 🔍 Port 2283 🔍 Face Recognition 🔍 Linux Server 🔍 TechnicalAnshu
🎙️ 전체 내용 — 탭하여 펼치세요

단계별 문제 해결 가이드 및 솔루션 - 지금 바로 IMMH를 설치하세요. GOOGLE PHOTOS ALTERNATE. Technical Anshu의 화면 시연....

Docker Compose를 사용하여 Immich를 단계별로 설치하세요. 공식 파일을 다운로드하고, .env 파일에 UPLOAD_LOCATION 및 DB_PASSWORD를 설정하고, 스택을 시작한 후 포트 2283에서 나만의 비공개 Google 포토 대안을 엽니다.

(기록은 여기 소스 페이지에서 끝납니다)

❓ 자주 묻는 질문(영어)

이 튜토리얼은 100% 무료로 따라할 수 있나요?

그렇습니다! Technical Anshu가 시연하는 모든 가이드와 방법은 무료, 법적, 교육적 리소스를 사용합니다.

초보자도 이 가이드를 따를 수 있나요?

물론이죠! 모든 단계는 자세한 지침과 함께 화면에 표시되므로 누구나 쉽게 따라할 수 있습니다.

문제가 있으면 어디에 질문해야 하나요?

YouTube 동영상에 직접 댓글을 남겨주시면 저희 커뮤니티와 Technical Anshu가 도와드리겠습니다.

🚀 YouTube에서 전체 튜토리얼 보기

🚀 YouTube에서 전체 단계별 비디오 튜토리얼을 시청하세요: https://www.youtube.com/watch?v=b_v7DbyFO14

IT 지원, Windows 문제 해결 및 서버 관리를 위한 Technical Anshu를 구독하세요.

▶️ 전체 동영상 보기
이 튜토리얼은 Technical Anshu의 Immich Docker 설치 비디오를 기반으로 합니다. • 어떤 단계에서 막히나요? 영상 댓글로 문의하시면 도움을 받으실 수 있습니다 🙏