Skip to main content
Ctrl+K

Harang Immich 문서 (한국어)

목차

  • 사전 요구사항
  • 설치
  • 사용법
  • 아키텍처
  • 문제 해결 & FAQ

Harang Immich

Harang Immich#

Harang Immich는 노트에 삽입한 이미지를 옵시디언 볼트 안에 저장하는 대신, 직접 운영하는 Immich 서버에서 불러오고 저장할 수 있게 해주는 옵시디언 플러그인입니다.

목차

  • 사전 요구사항
  • 설치
    • 방법 1 — 앱 내에서 설치
    • 방법 2 — Git 저장소 복제
    • 다음 단계
  • 사용법
    • 프로필
    • 핵심 기능 4가지
    • 링크 문법
    • 이미지를 삭제할 때 Immich와 동기화 유지하기
  • 아키텍처
    • 개요
    • 여러 프로필과 ImmichClient 인스턴스
    • ImmichClient와 모바일 호환성
    • 전용 링크 문법 렌더링
    • 에셋 수명 주기 추적
    • 설정, 프로필, 비밀정보
    • 국제화(i18n)
  • 문제 해결 & FAQ
    • “Immich 서버 주소와 API 키를 먼저 설정에서 입력해주세요.”
    • “에셋 목록 조회 실패”, “썸네일 조회 실패”, “원본 이미지 조회 실패” (HTTP 상태 코드 포함)
    • “업로드 실패” / “업로드 응답에 asset id가 없습니다”
    • 노트에서 이미지가 깨진/오류 표시로 나타나는 경우
    • 이미지에서 “프로필을 찾을 수 없음” 오류가 표시되는 경우
    • 이미지가 아예 이미지로 렌더링되지 않는 경우
    • 캐시가 계속 늘어나요 / 공간을 확보하고 싶어요
    • 모바일에서만 이미지 로드가 실패하는 경우
    • 노트를 삭제해도 이미지 처리 여부를 묻지 않는 경우

다음

사전 요구사항

작성자: search5

© Copyright 2026, search5.