starFrameFamily무료로 설치하기
메뉴

무료 설치 안내

미리보기 0.2.1 · 게시일 2026-11-12

우리 집 장비에
첫 앨범을 설치하세요.

상시 켜둘 NAS·PC와 Docker 실행 환경, 저장공간과 별도 백업 위치가 필요합니다. 소프트웨어는 무료이며, 설치·운영은 직접 관리합니다.

정식 출시 전 미리보기입니다. 파일럿 가족의 사용 검증 전이며, 중요한 기록을 옮기기 전에 별도 사본을 보관해 주세요.

0.1.x를 쓰고 있다면 0.2.1로 업데이트해 주세요. 0.2.0도 같은 방법으로 올리면 됩니다. 특히 0.1.0은 사진 영구 삭제 처리에 오류가 있습니다. 백업을 먼저 받은 뒤 처음 설치한 폴더의 설정 파일에서 image: 줄을 새 파일과 같게 바꾸고 docker compose pull 후 docker compose up -d를 실행합니다. 0.2.1은 starframe 이미지만 바뀌고 media-runtime은 0.1.1 그대로입니다. 자세한 내용은 릴리스 노트에 있습니다.

설치 설정 파일 받기단계별 설치 →

linux/amd64 · linux/arm64 / 2 코어 · 2 GB 이상 권장. 모든 NAS에서 검증된 것은 아닙니다.

준비부터 가족 사용까지

  1. 준비 확인

    장비와 저장공간, Docker 또는 시놀로지 Container Manager를 준비합니다. 설치 사전점검에서 권한·포트·백업 위치를 확인하세요.

  2. 설정 파일 받기

    위 버튼의 docker-compose.yml을 새 설치 폴더에 저장합니다. 이 릴리스의 Docker 이미지가 다이제스트로 고정되어 있습니다.

  3. 우리 집 장비에서 실행

    시놀로지: Container Manager › 프로젝트 › 생성 › 직접 작성에 설정 파일 내용을 붙여넣습니다.

    일반 Docker: 서버에서 파일이 있는 폴더를 열고 실행합니다.

    docker compose up -d
docker compose ps -a

    성공하면 starframe이 실행 중이고 healthy로 표시됩니다. media-runtime의 Exited (0)은 도구 설치 완료 상태입니다. 실패하면 문제 해결을 확인하세요.

  4. 서버 자신에서 첫 접속

    서버의 브라우저에서 http://127.0.0.1:8080을 엽니다. 설치 마법사가 보이면 서버 점검과 가족·소유자 설정을 진행합니다.

    기본 바인딩은 서버 로컬 전용입니다. 다른 기기에서 NAS IP로 바로 열리지 않는 것이 정상입니다. 브라우저가 없는 NAS는 다음 단계의 HTTPS 프록시를 먼저 준비하세요.

    첫 설정과 복구 코드 보관 →

  5. HTTPS 연결 후 가족 초대

    리버스 프록시와 신뢰된 인증서를 준비한 뒤 가족에게 접속 주소를 안내합니다. 홈 화면 추가·알림은 HTTPS와 기기별 지원이 필요합니다.

    HTTPS 설정 → 가족 초대·접속 → 백업·업데이트

파일 무결성 및 라이선스 자료

파일·SHA-256·Docker 이미지 다이제스트 펼치기

내려받은 파일은 SHA-256 값으로 확인할 수 있습니다. 한 번 공개한 버전의 파일은 바꾸지 않습니다.

  • docker-compose.yml설치 설정 파일 · 3 KB31500f8851152a21b915b4600ea6f44715b4cc16f370ad0935e6cd2ee3e3dadf
  • RELEASE-NOTES.txt릴리스 노트 · 3 KBc0b6309c1abb48b245e52888316e9a110bb300e5427f5c384e4a419ae5170515
  • ffmpeg-9.0.1.tar.xzFFmpeg 9.0.1 대응 소스 · 12.0 MBcf38e0e28c7e5605942c4a77755349b0145804a397af37eb1fb4c77cb237f635

전체 목록: SHA256SUMS.txt · 릴리스 노트

Docker 이미지

프로그램은 Docker Hub에서 받습니다. linux/amd64와 linux/arm64를 지원합니다.

  • starframe/family:0.2.1sha256:ca433d0f257028f7655b638abc78a2a61c21b4112f9fe2c30804460f1f4139e2
  • starframe/media-runtime:0.1.1sha256:8a8571571c9b3d9c5f9699f2bd70b6ef2ce546b7011178b5f40c32f94facbe0c

설치가 막히면 알려주세요.

사용하는 NAS나 PC의 기종과 막힌 단계를 적어 보내주세요. 먼저 사용해 보는 파일럿 가족의 의견도 받고 있습니다.

설치·파일럿 문의

메일 앱이 열립니다. 문의 주소는 페이지 아래에서도 확인할 수 있어요.

FFmpeg 라이선스 고지

This software uses code of FFmpeg licensed under the LGPLv2.1 and its source can be downloaded here.

영상 처리에 쓰는 FFmpeg 9.0.1은 LGPLv2.1 조건으로 사용합니다. FFmpeg의 저작권은 FFmpeg 프로젝트와 기여자에게 있습니다. StarFrame은 FFmpeg를 수정하지 않았으며, 빌드 구성과 라이선스 전문을 함께 제공합니다.