이 글의 목적은 한컴스페이스 동기화 오류를 신속하고 체계적으로 해결할 수 있도록 원인 진단 절차, 운영체제별 조치, 파일 규칙, 네트워크 점검, 데이터 복구 전략을 전문가 수준으로 정리하여 현장에서 즉시 활용 가능하게 하는 것이다.
1. 동기화 오류의 핵심 구조 이해
클라우드 동기화는 클라이언트(PC·모바일 앱) ↔ 전송 계층(네트워크·프록시·TLS) ↔ 백엔드(저장소·버전·권한) 세 축으로 동작한다. 오류는 대부분 입력값(파일·경로·권한), 연결성(네트워크·시간·인증), 상태관리(캐시·DB·잠금) 중 하나에서 발생한다. 따라서 아래 세 단계 점검이 효율적이다.
- 입력 검증 : 파일명, 경로 길이, 크기 제한, 잠금 상태, 권한 확인을 선행한다.
- 연결성 검증 : 계정 인증, 시간 동기화, TLS 신뢰, 방화벽·프록시·DNS를 확인한다.
- 상태 리셋 : 캐시·로컬 인덱스 재구성, 충돌 정리, 선택 동기화 재설정, 앱 재설치 순으로 진행한다.
주의 : 동기화 트러블슈팅은 항상 원본 보존이 우선이다. 로컬 폴더와 클라우드 폴더의 최신본을 별도 안전 위치에 복제한 뒤 조치한다.
2. 가장 빠른 원인 진단 체크리스트
| 점검항목 | 확인 방법 | 정상 기준 | 문제 발생 시 조치 |
|---|---|---|---|
| 계정 인증 | 앱에서 로그아웃 후 재로그인 | 토큰 재발급 완료 | 비밀번호 재설정, 기기 인증 이력 정리 |
| 스토리지 용량 | 클라우드 사용량 확인 | 남은 용량 > 10% | 불필요 파일 정리, 휴지통 비우기 |
| 시간 동기화 | 시스템 시간 자동 설정 | NTP 동기화됨 | 시간 자동설정 활성화, NTP 강제 동기화 |
| 네트워크 | 사설망/기업망 전환 테스트 | 패킷 손실 0~1% | 방화벽·프록시 예외 등록, DNS 변경 |
| 파일 이름/경로 | 금칙문자·경로길이 점검 | 규칙 준수 | 규칙 위반 항목 일괄 수정 |
| 파일 잠금 | 편집 프로그램 종료, 임시파일 제거 | 잠금 해제 | 백그라운드 프로세스 종료, 재부팅 |
| 로컬 캐시/인덱스 | 앱 설정에서 재구성 | 인덱스 재생성 완료 | 캐시 초기화 후 재로그인 |
3. 파일·폴더 규칙으로 해결하는 즉시 치료
3.1 파일명 금칙·권장 규칙
- 허용 ASCII 외 특수문자 사용을 지양한다. 특히
/ \ : * ? " < > |및 제어문자는 금지한다. - 끝에 공백·마침표가 오는 파일명은 피한다.
- 대소문자 구분 충돌을 피하기 위해 OS 혼합 환경에서는 소문자+하이픈을 권장한다.
- 확장자 중복(예:
.hwp.pdf)은 분리한다.
3.2 경로 길이 제한
Windows 호환을 위해 전체 경로 240자 이하를 권장한다. 폴더를 3단계 이내로 평탄화하고 공통 접두사를 줄인다.
3.3 대용량·대량 파일 전략
- 단일 파일 크기가 큰 경우 업로드를 개별 분리하여 수행한다.
- 수천 개 소파일은 압축 후 업로드하고 서버 측에서 해제한다.
- 동시 편집이 잦은 문서는 버전 충돌을 줄이기 위해 잠금 후 편집한다.
주의 : HWP·DOCX·PPTX 등 패키지형 문서는 열려 있는 동안 잠금파일이 생성된다. 동기화가 대기 상태로 보이면 모든 편집기를 종료한 뒤 30초 후 재시도한다.
4. 운영체제별 즉시 해결 절차
4.1 Windows
- 작업관리자에서 한컴스페이스 관련 프로세스를 종료한다.
- 네트워크 초기화를 수행한다.
ipconfig /flushdns netsh winsock reset netsh int ip reset - 시간 동기화를 강제한다.
w32tm /resync /force - 보안 소프트웨어에서 클라우드 클라이언트를 신뢰 목록에 추가한다.
- 동기화 루트 폴더의 경로를 짧게 재지정한다(예:
C:\HancomSpace). - 캐시 재구성 후 재로그인한다.
4.2 macOS
- 앱 완전 종료 후 라이브러리 캐시를 초기화한다(앱 제공 메뉴 또는 설정에서 수행한다).
- 키체인에 저장된 이전 토큰을 제거한 뒤 재로그인한다.
- 시스템 설정 > 날짜와 시간에서 자동으로 설정을 활성화한다.
- 네트워크 위치를 새로 만들어 프록시 자동 설정을 해제한 상태로 테스트한다.
4.3 모바일(iOS/Android)
- 셀룰러 데이터 허용, 백그라운드 동기화 허용을 켠다.
- 앱 저장공간 캐시를 정리하고 다시 로그인한다.
- 배터리 절약 모드를 해제하고 화면 잠금 중 동기화 제한을 해제한다.
5. 네트워크·보안 환경 점검
5.1 방화벽·프록시
- 기업망에서는 SSL 검사 기능이 토큰 교환을 방해할 수 있다. 예외 정책을 요청한다.
- 프록시를 사용할 경우 OS 시스템 프록시와 앱 프록시 설정이 일치해야 한다.
5.2 DNS·라우팅
- 공용 DNS로 교차 테스트한다.
- VPN 사용 시 분할 터널링에서 클라우드 도메인 경로를 제외한다.
5.3 TLS·인증서
- 루트 인증서 스토어가 최신인지 확인한다.
- 중간 인증서를 필수로 설치하는 보안 장비 사용 시, 앱이 신뢰할 수 없게 되는 경우가 있다. 해당 정책을 제외한다.
주의 : 인증서·프록시 문제는 웹 접속은 정상이나 앱만 실패하는 패턴으로 흔히 나타난다. 동일 PC에서 브라우저와 앱을 각각 로그인 테스트하여 원인을 분리한다.
6. 동기화 충돌 처리 표준 절차
- 충돌 목록을 내림차순으로 정렬한다(최근 변경 우선).
- 파일별로 다음 규칙을 적용한다.
- 둘 다 최신 수정이 있으면 사본 유지(
_conflict접미사 부여) 후 내용 병합한다. - 한쪽만 변경이면 변경본을 기준으로 버전 고정한다.
- 바이너리 파일은 해시 비교로 결정하고 기록을 남긴다.
- 둘 다 최신 수정이 있으면 사본 유지(
- 병합 완료 후 불필요한 사본은 아카이브 폴더로 이동한다.
| 상황 | 판정 기준 | 처리 권장 | 비고 |
|---|---|---|---|
| 동시 편집 충돌 | 수정 타임스탬프·편집자 상이 | 사본 유지 후 수동 병합 | 히스토리 스냅샷 보관 |
| 삭제-생성 경합 | 서버 삭제, 로컬 신규 | 로컬 유지 후 서버 복구 | 정책에 따라 승인 필요 |
| 이동-수정 경합 | 경로 변경과 내용 변경 동시 | 경로 우선 반영, 내용 병합 | 리네임 로그 확인 |
7. 캐시·인덱스·데이터베이스 재구성
동기화 엔진은 로컬에 인덱스 DB와 파일 해시 캐시를 유지한다. 손상 또는 불일치 시 다음 순서로 재구성한다.
- 앱 종료 후 동기화 루트 폴더를 안전 위치에 백업한다.
- 앱 설정의 캐시 초기화 또는 계정 재연결 기능을 실행한다.
- 필요 시 앱을 제거 후 재설치하고 선택 동기화로 범위를 작게 시작한다.
- 문제 없는 하위 폴더부터 단계적으로 범위를 확장한다.
주의 : 로컬 삭제가 클라우드 삭제로 전파될 수 있다. 재연결 시 초기 동기화 방향을 서버 기준으로 시작하거나 읽기 전용으로 시험하고 확인 후 해제한다.
8. 자동화 점검 명령 모음(Windows)
관리자 권한 PowerShell을 사용하여 기본 점검을 일괄 수행한다.
# 1) 네트워크 기본 점검 Test-NetConnection -ComputerName 8.8.8.8 -InformationLevel Detailed ipconfig /flushdns netsh winsock reset # 2) 시간 동기화 w32tm /resync /force # 3) 프록시 확인 netsh winhttp show proxy # 4) 디스크 검사(파일시스템 오류) chkdsk C: /scan 9. 조직 환경에서의 정책 조정 포인트
- SSL 가시화 장비 사용 시 앱 도메인 예외를 적용한다.
- 실행 파일 차단 정책이 앱 자동업데이트를 차단하는지 점검한다.
- 스토리지 할당량 초과 경보를 관리자 알림으로 연동한다.
- 데이터 분류에 따라 외부 반출 금지 폴더는 동기화 제외 규칙으로 관리한다.
10. 복구 시나리오별 플레이북
10.1 “로그인은 되는데 파일이 안 올라감”
- 업로드 대기 목록에서 금칙문자·경로 초과 항목을 우선 수정한다.
- 대용량 파일은 개별 업로드로 분리한다.
- 보안 소프트웨어 실시간 감시를 일시 해제하고 비교한다.
10.2 “일부 폴더만 동기화 안 됨”
- 선택 동기화에서 해당 폴더를 제외했다가 다시 포함한다.
- 문제 폴더를 새 경로로 이동 후 동기화를 재개한다.
10.3 “웹은 최신인데 PC만 오래된 버전”
- 앱 캐시 초기화 후 재로그인한다.
- 시간 동기화와 DNS 변경을 적용한다.
10.4 “계정·권한 문제 의심”
- 공유받은 폴더 권한을 재확인한다.
- 조직 정책 변경 이력과 연동된 시점을 비교한다.
11. 운영 상 베스트 프랙티스
- 폴더 구조 표준화 : 팀 공통 네이밍 규칙을 문서화한다.
- 변경 이력 관리 : 대량 이동·삭제 전 스냅샷을 만든다.
- 오프라인 정책 : 출장·무선 환경에 대비해 오프라인 우선 폴더를 지정한다.
- 분할 배포 : 대규모 조직은 파일 확장자별 동기화 정책을 구분한다.
12. 자가 진단 흐름도(텍스트 버전)
[시작] ├─ 스토리지 용량 확인 → 부족? 정리 후 재시도 → 충분 ├─ 시간 동기화 확인 → 불일치? NTP 재동기화 → 일치 ├─ 네트워크/프록시 확인 → 제한? 예외 구성 → 정상 ├─ 파일 규칙 확인 → 위반? 이름·경로 수정 → 준수 ├─ 캐시/인덱스 재구성 → 성공? 종료 → 실패 ├─ 선택 동기화 축소 시작 → 점진 확대 └─ 앱 재설치 및 재연결 → 정상화 [끝] 13. 문제 재발 방지 설정 체크리스트
| 영역 | 설정 | 권장값 | 검증 주기 |
|---|---|---|---|
| 선택 동기화 | 중요 폴더 우선 | 핵심 3폴더만 상시 | 월 1회 |
| 네트워크 | DNS·프록시 | 자동+예외 정책 | 분기 1회 |
| 보안 | 실시간 검사 예외 | 앱·동기화 폴더 예외 | 반기 1회 |
| 버전 관리 | 충돌 사본 보존 | 30일 이상 | 월 1회 |
| 로그 | 오류 스냅샷 | 주요 이벤트 보관 | 상시 |
14. 데이터 안전 확보 전략
- 3-2-1 규칙 : 사본 3개, 미디어 2종, 오프사이트 1곳을 유지한다.
- 임시보호 : 트러블슈팅 중에는 삭제 동기화를 잠시 중단한다.
- 검증 복원 : 중요 문서는 복원 리허설을 분기별로 수행한다.
15. 현장에서 자주 묻는 질문(FAQ)
동기화가 멈춘 것처럼 보이는데 CPU·디스크 사용량이 낮다. 무엇을 먼저 확인해야 하나?
편집 중인 문서의 잠금파일과 보안 소프트웨어 예외 여부를 먼저 본다. 이어서 대기열에서 이름·경로 규칙 위반 항목을 정리한다. 이후 캐시 재구성 순으로 진행한다.
웹에서는 최신인데 PC는 오래된 버전이다. 재설치가 필요한가?
재설치 전에 캐시 초기화와 선택 동기화 재지정을 먼저 수행한다. 문제가 있는 폴더만 제외 후 다시 포함하여 인덱스를 재구성한다. 그래도 실패하면 재설치를 고려한다.
기업망에서만 로그인 실패가 반복된다. 원인은 무엇인가?
SSL 가시화 또는 프록시 인증이 토큰 발급을 차단하는 경우가 많다. 보안 장비 정책에서 클라우드 서비스 예외를 적용하고, 시스템 프록시와 앱 프록시 설정을 일치시킨다.
대량 파일 업로드 시 자주 실패한다. 어떻게 안정화하나?
수천 개의 소파일은 압축 후 업로드한다. 대용량 단일 파일은 단계 업로드로 나누고, 업로드 전 실시간 검사 제외를 설정한다. 네트워크 혼잡 시간대를 피한다.
동기화 루프가 발생한다. 어떤 패턴을 의심해야 하나?
리네임 반복, 삭제-생성 경합, 대소문자만 다른 파일명의 충돌을 우선 의심한다. 규칙대로 정규화하고 충돌 사본을 병합한다.
복구 후 누락 파일이 있는지 빠르게 점검하려면?
로컬 루트와 클라우드 목록을 해시 또는 크기/시간 기준으로 비교한다. 차이 목록을 만들어 결손만 동기화한다.
16. 실행 요약
- 남은 용량·시간 동기화·네트워크를 3분 내 점검한다.
- 금칙문자·경로 길이를 즉시 교정한다.
- 잠금파일 제거 후 재시도한다.
- 캐시 초기화→선택 동기화 축소→점진 확대 순으로 재구성한다.
- 기업망은 프록시·SSL 예외를 확인한다.
- 항상 원본 사본을 확보한다.