OpenSource-Hub
C

ChronoFrame

1.8k stars·파일 관리·SHA-256 체크섬 확인됨

다중 스토리지 백엔드와 스마트 EXIF 파싱을 지원하는 셀프 호스팅 개인 사진 앨범 애플리케이션으로, 사진작가가 사진 데이터를 완전히 제어할 수 있습니다.

스마트 다운로드

프로젝트 홈페이지 방문

아직 설치 프로그램이 없습니다 — 소스 저장소로 이동하세요

셀프 호스팅 사진 앨범으로, Google Photos를 대체하며 지도 탐색 및 EXIF 자동 추출을 지원합니다.

주요 기능

  • 스마트 EXIF 추출: 촬영 시간, 위치, 카메라 매개변수 자동 인식
  • 역지오코딩: 위도와 경도를 기반으로 촬영 장소 이름 자동 검색
  • 인터랙티브 지도: 지도에서 모든 사진의 지리적 위치 탐색
  • 다중 스토리지 백엔드: 로컬 스토리지, S3 호환 스토리지 및 CDN 가속 지원
  • 효율적인 썸네일: ThumbHash 기술을 사용하여 미리보기 빠르게 생성

할 수 없는 것

  • •기본 관리자 비밀번호가 취약합니다(CF1234@!). 반드시 .env에서 변경하세요. 로컬 스토리지를 사용하는 경우 디스크 공간에 주의하세요. 지도 기능에는 MapTiler 또는 Mapbox Token이 필요합니다(무료 할당량으로 충분합니다). 역지오코딩은 Mapbox Token에 의존하므로, 설정하지 않으면 장소 이름이 표시되지 않습니다.

사용 사례

  • 사진작가 개인 작품 전시 웹사이트: 자신의 도메인으로 포트폴리오 선보이기
  • 가족 사진 보관: 자체 가족 앨범을 구축하여 클라우드 서비스 의존 방지
  • 여행 사진 정리: 촬영 장소를 자동으로 추출하여 지도에서 여정 되돌아보기

상세 설명

ChronoFrame는 사진작가와 애호가를 위해 만들어진 모던 셀프 호스팅 사진 앨범 애플리케이션입니다. Nuxt 4 + TypeScript + TailwindCSS + Drizzle ORM 기반으로 구축되었으며, 사진 업로드, 탐색 및 관리를 위한 매끄러운 웹 인터페이스를 제공합니다. 핵심 기능으로는 스마트 EXIF 메타데이터 추출(촬영 시간, 장소, 카메라 파라미터 자동 인식), 역지오코딩(촬영 위치 자동 태깅), 인터랙티브 지도 탐색, 멀티 스토리지 백엔드 지원(로컬 파일 시스템 또는 S3 호환 스토리지)이 있습니다. ThumbHash를 사용하여 썸네일을 효율적으로 생성하고, WebGL을 활용해 고품질 이미지 렌더링을 구현합니다. Docker 원클릭 배포(사전 빌드된 이미지는 GHCR 및 Docker Hub에서 제공)를 지원하며, 관리자 백엔드에서는 일괄 업로드, 드래그 앤 드롭 업로드, 자동 썸네일 생성을 지원합니다. CDN을 통한 이미지 배포 가속화도 지원합니다. Google Photos나 Flickr 같은 클라우드 서비스와 비교할 때, ChronoFrame은 사진 데이터를 완전히 제어할 수 있게 해주며, 개인정보 유출 위험이 없고 구독 비용도 필요하지 않습니다.

문제 해결 & FAQ (1)

문제 해결
ChronoFrame 설정 마법사의 Site Info 단계에 레이블이 없는 "[object Object]" 입력 필드가 표시되는 이유는 무엇인가요?

이는 ChronoFrame 1.0.2의 알려진 UI 버그입니다. 해당 필드는 기본값이 { links: [] }인 JSON 타입 설정인 socialLinks 앱 설정입니다. 설정 마법사는 탭이 아닌 모든 설정을 일반 텍스트 입력으로 렌더링하므로, 객체가 문자열 [object Object]로 강제 변환됩니다. 임시 해결 방법: 해당 필드를 그냥 무시하세요 — 입력하는 내용은 저장되지 않으며(마법사 제출 페이로드에 socialLinks가 포함되지 않음), 데이터 손상 위험이 없습니다. 소셜 링크를 구성하려면 설정을 완료한 후 대시보드 설정 페이지에 있는 전용 소셜 링크 편집기를 대신 사용하세요(대시보드는 일반 필드에서 socialLinks를 올바르게 제외합니다). 직접 패치하는 개발자의 경우: apps/self-hosted/server/api/wizard/schema.get.ts에서 마법사의 app 스키마에서 socialLinks(또는 모든 객체/JSON 값 설정)를 필터링하여 제외하고, 선택적으로 마법사 렌더러(apps/self-hosted/app/pages/onboarding/site.vue)에 가드를 추가하여 객체 값이 텍스트 입력에 전달되지 않도록 하세요.

원본 Issue #466

태그

photo-galleryself-hostedexifmapnuxtdockerphotography

시작하기

1

설치 프로그램 다운로드

위 버튼을 클릭하여 시스템에 맞는 설치 프로그램을 다운로드

2

소프트웨어 설치

다운로드한 설치 프로그램을 더블 클릭하고 안내에 따르세요

3

1단계: 서버에 Docker 및 Docker Compose 설치

4

2단계: .env 파일을 생성하여 관리자 이메일, 비밀번호 및 스토리지 방식(로컬 또는 S3) 구성

5

3단계: docker compose up -d를 실행하여 서비스 시작

설치 가이드
  1. 1단계: 서버에 Docker 및 Docker Compose 설치
  2. 2단계: .env 파일을 생성하여 관리자 이메일, 비밀번호 및 스토리지 방식(로컬 또는 S3) 구성
  3. 3단계: docker compose up -d를 실행하여 서비스 시작
파일 무결성

체크섬 없음

이 프로젝트는 GitHub Release 페이지에 SHA-256 체크섬을 게시하지 않았습니다

SHA256 체크섬

체크섬 없음

GitHub Releases에서 직접 다운로드하고 파일 무결성을 직접 확인하세요

이 플랫폼의 모든 SHA-256 체크섬은 프로젝트의 공식 GitHub Release 페이지에서 추출되었으며, 어떠한 변경도 없습니다. GitHub Releases 페이지에서 직접 검증할 수 있습니다.

오픈소스 투명성

GitHub 소스 보기
환경 가이드

제거 정보

컨테이너 중지: docker compose down; 데이터 삭제: rm -rf ./data 및 docker rmi ghcr.io/hoshinosuzumi/chronoframe

추가 의존성 없음

다운로드 후 바로 사용 가능. 추가 런타임이 필요하지 않습니다.

프로젝트 정보
라이선스MIT
마지막 업데이트2026-10-26 22:27:23
GitHub 저장소공식 웹사이트

문제 발생? 아래 FAQ 확인

1 FAQ

유사한 프로젝트