B_미디어자료정리 — 04. 운영 관리 메뉴얼

04. 운영 관리 메뉴얼

대상: PhotoView 설치 후 일상 운영 운영자: 아빠 (기본), 루키/하늘 (기술 지원) 설치 위치: 맥미니 (루키)

📋 일상 운영 체크리스트

매일

#	작업	방법	담당
—	특별한 작업 없음	PhotoView 자동 동작	—

매주

#	작업	방법	담당
1	새 사진 업로드 확인	NAS에 파일 추가 → PhotoView 자동 인식	아빠
2	PhotoView 접속 확인	`http://맥미니-tailnet:8000`	아빠

매월

#	작업	방법	담당
1	DB 백업	`database/photoview.db` 파일 복사	루키
2	캐시 정리 (용량 부족 시)	`cache/` 폴더 내 오래된 썸네일 확인	루키
3	Tailscale 연결 상태 점검	`tailscale status`	루키

🔧 백업 절차

1. PhotoView DB 백업 (매월 권장)

# 맥미니에서
mkdir -p ~/photoview-backup/$(date +%Y%m)
cp ~/photoview/database/photoview.db \
   ~/photoview-backup/$(date +%Y%m)/photoview.db.$(date +%Y%m%d)

# NAS로도 복사 권장
cp ~/photoview/database/photoview.db \
   /Volumes/photos/_photoview-backup/

2. 전체 설정 백업 (설치/설정 변경 시)

cd ~/photoview
tar czf ~/photoview-backup/photoview-config-$(date +%Y%m%d).tar.gz \
    docker-compose.yml .env database/ photoview.db

3. NAS 사진 원본 백업

NAS 시놀로지 자체 Snapshot 기능 활용
또는 Hyper Backup으로 외장하드 백업
PhotoView DB/캐시는 별도 백업 필요 (NAS 백업에 포함 안 됨)

🔧 복구 절차

시나리오 1: PhotoView DB 손상

cd ~/photoview

# 1. 컨테이너 중지
docker compose down

# 2. DB 복원 (백업본으로)
cp ~/photoview-backup/202505/photoview.db.20250503 \
   ./database/photoview.db

# 3. 컨테이너 재기동
docker compose up -d

# 4. 인덱싱 재실행 (PhotoView UI → Settings → Scan)

시나리오 2: 맥미니 교체/재설치

# 1. 새 맥미니에 Docker 설치
# 2. NAS SMB 마운트
# 3. ~/photoview 폴더 복원 (백업 tar.gz 풀기)
# 4. docker compose up -d
# 5. PhotoView가 자동으로 NAS 사진 재스캔

시나리오 3: 캐시만 손상 (DB는 정상)

cd ~/photoview

# 1. 캐시 폴더 삭제
rm -rf cache/*

# 2. 컨테이너 재시작
docker compose restart photoview

# 3. PhotoView가 자동으로 썸네일 재생성

🔧 업데이트 절차

PhotoView 이미지 업데이트

cd ~/photoview

# 1. 최신 이미지 다운로드
docker compose pull photoview

# 2. 컨테이너 재시작 (무중단)
docker compose up -d photoview

# 3. 이전 이미지 정리
docker image prune -f

⚠️ 주의사항

업데이트 전 반드시 DB 백업
주요 버전 업데이트 시 릴리즈 노트 확인

문제 발생 시 즉시 이전 버전으로 롤백 가능:

docker compose down
# docker-compose.yml에서 image 태그를 이전 버전으로 수정
# 예: photoview/photoview:2 → photoview/photoview:2.3.1
docker compose up -d

🔧 장애 대응

PhotoView 접속 안 됨

단계	확인	명령
1	맥미니 전원/네트워크	`ping 맥미니-IP`
2	Docker 동작 중?	`docker ps`
3	PhotoView 컨테이너 상태	`docker compose ps`
4	로그 확인	`docker compose logs --tail 50 photoview`
5	Tailscale 연결	`tailscale status`
6	재시작	`docker compose restart photoview`

사진 안 보임 / 썸네일 깨짐

단계	확인	조치
1	NAS 마운트 상태	`ls /Volumes/photos`
2	Docker 볼륨 마운트	`docker inspect photoview
3	캐시 삭제 후 재시작	`rm -rf cache/* && docker compose restart`
4	PhotoView 재인덱싱	UI → Settings → Scan

속도가 너무 느림

원인	확인	조치
NAS SMB 속도	`time dd if=/Volumes/photos/test.jpg of=/dev/null`	유선 연결 확인
맥미니 CPU	`top` 또는 Activity Monitor	Docker 리소스 제한 해제
썸네일 생성 중	PhotoView UI	기다리기 (시간 소요)
DB 크기	`ls -lh database/photoview.db`	DB 최적화 (불필요)

📊 주요 파일/경로 정리

용도	경로 (맥미니)	백업 필요
Docker 구성	`~/photoview/docker-compose.yml`	✅
PhotoView DB	`~/photoview/database/photoview.db`	✅ 필수
썸네일 캐시	`~/photoview/cache/`	❌ (재생성 가능)
백업본	`~/photoview-backup/`	✅
NAS 사진 원본	`/Volumes/photos/`	✅ (NAS 자체 백업)

🔗 관련 문서

[[01_프로젝트계획서]] — 4단계: 검증기, 5단계: 정리기
[[02_PhotoView설치메뉴얼]] — 설치 절차
[[03_데이터이전계획]] — 데이터 이전

[!note] 수정이력 | 2026-05-03 18:50, 하늘 (hermes)

운영 관리 메뉴얼 신규 작성

백업/복구/업데이트/장애대응 4개 절차 포함

주요 파일 경로 정리표 추가