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 자체 백업)

---

🔗 관련 문서

• [[MiniCITY(A.R)/20-29 Efforts/28_미디어자료정리/v0.1_구상/01_프로젝트계획서]] — 4단계: 검증기, 5단계: 정리기
• [[백업자료_이전예정/MiniCITY(v0.5_PARA_0502-)/20-29 Efforts/28_미디어자료정리/v0.1_구상/02_PhotoView설치메뉴얼]] — 설치 절차
• [[MiniCITY(A.R)/20-29 Efforts/28_미디어자료정리/v0.1_구상/03_데이터이전계획]] — 데이터 이전

---

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

• 운영 관리 메뉴얼 신규 작성
• 백업/복구/업데이트/장애대응 4개 절차 포함
• 주요 파일 경로 정리표 추가