IvyBackup 사용 설명서

 

 

🍀 IvyBackup 앱 권한 상세 설명 및 앱 권한 이용 상세 안내

IvyBackup이 요구하는 주요 민감한 권한의 사용처 및 상세 설명입니다.

1. 모든 파일 액세스 권한(android.permission.MANAGE_EXTERNAL_STORAGE)
 보관 대상으로 지정된 폴더(사진, 문서, 다운로드 및 사용자 정의 경로)의 전체 파일을 탐색, 변경 감지 및 서버 백업 전송하기 위해 필수적입니다.
미허용 시 백업 폴더 파일 탐색 및 백업 핵심 기능을 사용할 수 없습니다.

2.백그라운드 & 포그라운드 서비스 권한(android.permission.FOREGROUND_SERVICE)
앱이 닫혔거나 백그라운드 환경에 있을 때에도 예약 스케줄(예: 15분 주기)에 맞춰 실시간으로 신규 파일을 전송하고 진행 현황을 알림창에 안정적으로 띄우기 위해 동작합니다.
미허용 시 자동 예약 백업 기능이 중단되거나 시스템에 의해 강제 종료됩니다.

3.배터리 최적화 제외 권한(android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS)
백그라운드 백업 전송 중 기기가 도즈(Doze) 모드나 배터리 절약 모드로 진입하더라도 자동 백업이 지연되거나 차단되는 현상을 방지합니다.

4.알림 권한(android.permission.POST_NOTIFICATIONS)
동기화 서비스 진행 중 상태 표시줄 인디케이터와 동기화 완료/오류 상황을 실시간으로 알려주어 사용자가 진행 상태를 실시간 인지할 수 있도록 제공합니다.

---

🍀 IvyBackup Server 다운로드

IvyBackup Server 다운로드

백업할 폴더에 다운로드한 파일을 압축을 해제해서 서버프로그램( IvyBackupServer.exe )을 실행합니다.
  - IvyBackupServer.exe : IvyBackup 서버 프로그램
  - server_config.json : 환경설정 파일
         "port": 8717,  <= 서버포트 설정
         "use_date_structure": true  <= 사진파일 저장방식 설정
                  true: 년\년월\년월일\{사진파일들}의 폴더 형태로 사진파일이 저장됩니다, 
                  false: 휴대폰의 폴더이름과 동일하게 백업됩니다.

---

🍀 IvyBackup 사용설명서

IvyBackup은 스마트폰의 소중한 사진과 파일들을 네트웍을 통해 내 컴퓨터로 자동으로 전송해주는 스마트 백업 솔루션입니다.

1단계: 컴퓨터(서버) 준비하기

1. 프로그램 실행: 다운로드한 IvyBackupServer.exe 파일을 더블 클릭하여 실행합니다.
2. IP 주소 확인: 검은색 화면(콘솔)에 표시된 "스마트폰 앱에 입력할 서버 IP: 192.168.x.x" 숫자를 메모해 두세요.
3. 트레이 아이콘 활용: 윈도우 오른쪽 하단 시계 옆에 있는 로고 아이콘을 우클릭하면 언제든지 IP 주소를 다시 확인하거나 현재 백업된 파일 리포트를 볼 수 있습니다.
4. 파일 저장 위치:
   •    사진: 실행 파일 위치의 PhotoFiles 폴더에 날짜별로 정리됩니다.("use_date_structure": true 인 경우)
   •    기타 파일: OtherFiles 폴더 아래에 내 휴대폰 이름별로 구분되어 저장됩니다.

2단계: 스마트폰(클라이언트) 설정하기

1. 앱 실행: 스마트폰에서 IvyBackup 앱을 엽니다.
2. 서버 IP 입력: 1단계에서 메모한 컴퓨터의 IP 주소를 앱 상단의 입력칸에 넣습니다.
3. 권한 허용: 앱이 파일에 접근할 수 있도록 권한 요청 팝업이 뜨면 모두 '허용' 또는 **'모든 파일 관리 권한'**을 켭니다.
4. 백업 폴더 추가:
   •    기본적으로 카메라 폴더가 지정되어 있습니다.
   •    추가로 백업하고 싶은 폴더(예: Download, KakaoTalk 등)가 있다면 [폴더 추가] 버튼을 눌러 선택하세요.

3단계: 백업 시작 및 동기화

1. 자동 백업 시작: [백업 모니터링 시작] 버튼을 누릅니다. 이제부터는 15분마다 새로운 파일이 있는지 체크하여 자동으로 컴퓨터로 보냅니다.
2. 수동 자료 전송: 지금 당장 모든 파일을 맞추고 싶다면 [자료 동기화 및 전송] 버튼을 누르세요. 서버에 없는 파일들만 골라내어 즉시 전송을 시작합니다.
3. 상태 확인: 화면 중앙의 '현재 상태' 메시지를 통해 전송 중인 파일명과 진행률을 실시간으로 볼 수 있습니다.

💡 유의 사항 (꼭 읽어주세요!)

• 같은 Wi-Fi 사용: 컴퓨터와 스마트폰이 반드시 같은 공유기(Wi-Fi)에 연결되어 있어야 합니다.(공유기 포트 포워딩등을 사용하여 외부 백업 가능)
• 방화벽 허용: 컴퓨터에서 "이 앱의 네트워크 접근을 허용하시겠습니까?"라는 팝업이 뜨면 반드시 **'허용'**을 눌러주세요.
• 배터리 최적화: 백그라운드에서 끊김 없이 백업되길 원하신다면, 휴대폰 설정에서 이 앱을 '배터리 사용량 최적화 제외 앱'으로 등록하는 것이 좋습니다.
• 정보 확인: 앱 상단의 로고 아이콘을 클릭하면 개발자 정보 및 앱 버전 정보를 확인할 수 있습니다.

---

이제 복잡한 케이블 연결 없이, IvyBackup으로 편리하게 소중한 추억을 컴퓨터에 보관하세요! 사용 중 궁금한 점은 About 팝업의 개발자 이메일로 문의해 주시기 바랍니다.

---

💡 기타 추가사항

🔍 중복 파일 판별 기준: 파일 내용 해시(SHA-256)

파일명이나 경로가 아닌 파일의 내용(바이트)을 SHA-256으로 해싱하여 DB와 비교합니다.

📋 판별 흐름

 

  파일 수신

   │

  ▼

  SHA-256 해시 계산

   │

  ▼

  DB에 동일 해시 존재?

   ├─ NO → 신규 파일 → BackupFiles / PhotoFiles에 저장 + DB 기록

   │

   └─ YES → 물리 파일도 실제로 존재?

   ├─ NO → 고스트 레코드 → DB 삭제 후 신규 처리

   └─ YES → 진짜 중복 → DupBackupFiles / DupPhotoFiles에 저장

✅ 이 방식의 특징

파일명이 달라도 중복 감지	내용이 같으면 중복으로 판정
파일명이 같아도 내용이 다르면 신규	내용 해시 기준이므로 정확함
기기가 달라도 동일 파일이면 중복	기기명을 기준으로 하지 않음
단점	파일이 1바이트라도 다르면(메타데이터 수정 등) 별도 파일로 저장됨

⚠️ 주의사항 (현재 구조)

• 1차(클라이언트): 파일명 기준으로 이미 있는 파일은 전송 자체를 건너뜀 → 대부분의 재전송 방지
• 2차(서버): 전송된 파일의 SHA-256 해시로 최종 중복 판정 → 파일명 변경 등의 엣지케이스 처리