# 260307 외부 NAS -> 내부 NAS 컴퍼니엑스 동기화 리서치

tags: [nas, companyx, sync, research]

상위 원칙:
- [Writing Principles](https://github.com/happybell80/0_VALUE/blob/main/02_Governance/writing-principles.md)
- [Infra Project Identity](../../00_Philosophy/00_IDENTITY/Infra_Project_Identity.md)
- [Core Infrastructure Principles](../../00_Philosophy/01_PRINCIPLES/Core_Infrastructure_Principles.md)

## 목적

- 컴퍼니엑스 외부 NAS 파일을 내부 NAS로 옮기는 운영 경로를 검증한다.
- 자동 동기화 스크립트를 만들기 전에 필요한 사실과 실험 항목을 정리한다.

## 현재 기준

- 외부 NAS 접근 경로: 시놀로지 기본 웹 관리자 API
- 내부 저장 경로: 51123의 `/mnt/nas`
- 내부 NAS 기준 주소: `192.168.0.101`
- 스크립트 저장소: `infra/scripts`

## 이미 검증된 사실

1. 외부 NAS DSM 로그인 가능
2. 외부 NAS 파일 1건 다운로드 가능
3. 내부 NAS 저장 가능
4. 저장 후 SHA256 일치 확인
5. 외부 NAS 폴더 구조 일부를 내부 NAS에 미러링 가능

관련 근거:
- [260307_external_nas_to_internal_nas_sync_probe.md](../../260307_external_nas_to_internal_nas_sync_probe.md)

## 2026-03-07 실측 결과

실행 스크립트:
- `infra/scripts/bin/companyx_external_nas_sync_probe.sh`

실행 시각:
- 2026-03-07 16:22 KST

테스트 저장 경로:
- `/mnt/nas/backup/current/external-nas-timing-test/20260307_162237`

측정값:
1. DSM 로그인
- 약 `0.683초`

2. 상위 폴더 목록 조회
- 대상: `/6.Company X`
- 결과: `16개 엔트리`
- 약 `0.067초`

3. 사진 하위 폴더 목록 조회
- 대상: `/6.Company X/7. 사진/220308_X코스_5기 발표 사진`
- 결과: `20개 엔트리`
- 약 `0.061초`

4. 샘플 파일 다운로드 및 내부 NAS 저장
- `Thumbs.db` `12,288B`: 약 `0.094초`
- `2410_투자기업 DB_컴퍼니엑스_LP추가, 컨택포인트 추가.xlsx` `151,832B`: 약 `0.103초`
- `KakaoTalk_20220322_121550595_03.jpg` `457,889B`: 약 `0.121초`
- `221028_회사소개서_디지털용.pdf` `20,147,273B`: 약 `0.571초`

관찰:
- 이 시점 실측에서는 대략 `20MB 파일 1개도 1초 이내`에 내부 NAS까지 저장됐다.
- 병목은 현재 테스트 범위에서는 내부 NAS 쓰기보다 외부 DSM 응답과 전송 구간으로 보인다.
- HTTPS 인증서는 만료 상태라 현재 스크립트는 `-k` 옵션으로 우회하고 있다. 운영 자동화 전 인증서 정리 여부를 판단해야 한다.

보수적 해석:
- “문서 파일 위주” 폴더는 `5분~10분 간격 증분 동기화`도 현실적으로 가능해 보인다.
- 다만 사진 대량 폴더나 전체 재귀 동기화는 파일 수가 많아질수록 API 호출 수가 늘어나므로, 지금 수치만으로 전체 완료 시간을 단정할 수는 없다.
- 따라서 다음 검증은 “샘플 폴더 1개 전체 동기화”와 “같은 작업 재실행 시 중복 건너뛰기”다.

## 이번 리서치에서 확인할 항목

1. 외부 NAS에서 디렉터리 목록을 안정적으로 재귀 조회할 수 있는가
2. 다운로드 단위를 파일별로 관리할 때 속도와 실패 복구가 충분한가
3. 수정시각과 크기만으로 증분 동기화가 가능한가
4. 해시 검증을 전건에 적용할지 샘플 검증으로 줄일지
5. 실패 파일 재시도와 중단 지점을 어떻게 기록할지

## 실험 순서

### 1. 목록 조회 실험

- 컴퍼니엑스 상위 폴더 목록 조회
- 하위 폴더 재귀 조회 가능 여부 확인
- 파일 수, 폴더 수, 메타데이터 제공 범위 확인

### 2. 샘플 동기화 실험

- 작은 폴더 1개를 골라 내부 NAS로 동기화
- 다운로드 시간, 저장 시간, 재실행 시 중복 처리 확인

### 3. 검증 실험

- 파일 크기, 수정시각, SHA256 비교 기준 정리
- 실패 파일 재시도 방식 기록

## 예상 산출물

1. `infra/scripts/bin/companyx_external_nas_sync_probe.sh` 개선본
2. 동기화 정책 초안 문서
3. 운영 주기 제안
4. 실패 처리 기준

## 보수적 결론

- 현재 구조로 단방향 동기화는 가능성이 높다.
- 다만 아직 자동 운영 주기와 증분 처리 기준은 검증되지 않았다.
- 따라서 다음 단계는 “전체 동기화 구현”이 아니라 “목록 조회 + 샘플 폴더 동기화 + 재실행 검증”이다.

## 관련 문서

- [260307_external_nas_companyx_sync_아이디어.md](../ideas/260307_external_nas_companyx_sync_아이디어.md)
- [260307_companyx_mobile_file_portal_research.md](./260307_companyx_mobile_file_portal_research.md)