StarFrame Family 0.2.1 (미리보기)
공개일: 2026-11-12

0.2.0 의 관리자 화면을 쉬운 말로 정리하고, 앱 업데이트·첫 접속 때의
새로고침 문제를 고친 버전입니다. 화면(웹)만 바뀌었고 데이터베이스 구조와
API 는 0.2.0 과 같아서, 문제가 있으면 0.2.0 으로 그대로 되돌릴 수 있습니다.

정식 1.0.0 이전의 미리보기 버전입니다. 파일럿 가족 사용을 아직 거치지
않았습니다. 업데이트 전에 백업을 받아 두세요.

이미지 (Docker Hub, linux/amd64 + linux/arm64)
  starframe/family:0.2.1
    sha256:ca433d0f257028f7655b638abc78a2a61c21b4112f9fe2c30804460f1f4139e2
  starframe/media-runtime:0.1.1  (FFmpeg 9.0.1, LGPLv2.1 구성, 바뀌지 않음)
    sha256:8a8571571c9b3d9c5f9699f2bd70b6ef2ce546b7011178b5f40c32f94facbe0c

이 폴더의 docker-compose.yml 은 위 두 이미지를 다이제스트로 고정합니다.

바뀐 것
  - 가족 설정: 기능은 켜기/끄기 스위치로, 메뉴는 한 줄에 이름·순서·표시를
    고칩니다. 설정 파일 다시 읽기는 "고급" 안으로 옮겼습니다.
    내부 설정 이름은 더 이상 보이지 않습니다.
  - 백업: 시간을 "오전 3시"처럼 목록에서 고르고, 설명을 쉬운 말로 바꿨습니다.
  - 기록: 표 대신 휴대폰에서 읽기 쉬운 목록으로 보여 주고,
    "엄마 · 앨범을 만들었어요"처럼 문장으로 적습니다.
  - 시스템: 기술 정보와 작업 상태는 "자세히" 안으로 옮기고,
    HTTPS·알림·백업 안내를 쉬운 말로 바꿨습니다.
  - 내 알림: 알림 종류를 스위치로 켜고 끕니다.
  - 날짜를 "11월 12일 오전 10:05" 형식으로 통일했습니다.

고친 것
  - 처음 접속할 때 페이지가 한 번 저절로 새로고침되어 입력 중인
    로그인·설정 내용이 지워지던 문제
  - 강력 새로고침(Shift+새로고침)한 탭에서는 앱 업데이트 안내가
    나오지 않던 문제
  - 휴대폰 화면에서 한국어 단어가 중간에 끊겨 줄바꿈되던 문제
  - 기록에서 로그인하지 않은 사용자의 로그인 실패를 "시스템"으로
    표시하던 문제 (이제 "알 수 없는 사용자")

0.2.0 / 0.1.1 에서 업데이트
  1. 관리자 › 백업에서 백업을 먼저 받습니다.
  2. 처음 설치한 폴더(프로젝트)의 docker-compose.yml 에서 starframe 의
     image: 줄을 이 폴더의 파일과 같게 바꿉니다. media-runtime 은 그대로입니다.
     0.1.0 에서 올라오면 media-runtime 줄도 함께 바꿉니다.
  3. docker compose pull && docker compose up -d
     (시놀로지: 프로젝트 › 중지 › YAML 편집 › 빌드)
  데이터는 data 볼륨에 그대로 남습니다. 되돌리려면 image: 줄을 0.2.0 으로
  돌려놓고 같은 명령을 실행하면 됩니다.

알려진 제한
  - HTTPS 없이 접속하면 홈 화면 설치·알림·오프라인이 꺼진 제한 모드로 동작합니다.
  - 공인 IP가 없는 회선(CGNAT)에서의 외부 접속은 지원하지 않습니다.

FFmpeg 대응 소스
  media-runtime 이 0.1.1 그대로이므로 0.1.1 과 같은 소스입니다.
  https://starframe.kr/releases/v0.1.1/ffmpeg/
  StarFrame 은 FFmpeg 를 수정하지 않았습니다.

문의: dev@starframe.kr