클라우드 의존성 극복: 유도우노트 노트를 안전하게 로컬에 보관하는 방법

클라우드 노트 서비스의 편리함은 분명하지만, 서비스 정책 변경이나 서버 장애로 인해 소중한 데이터를 잃을 위험은 항상 존재합니다. 특히 유도우노트(Youdao Note)가 일괄 내보내기 기능을 제거하면서 많은 사용자가 데이터 백업에 어려움을 겪고 있습니다. 이 문제를 해결하기 위해 등장한 오픈소스 도구 youdaonote-pull은 파이썬 스크립트를 활용해 계정 내 모든 콘텐츠를 자동으로 다운로드하고, 로컬 환경에서 완전히 독립적으로 작동함으로써 개인정보 유출 없이 안전한 백업을 가능하게 합니다.

왜 로컬 백업이 중요한가?

• 서비스 중단 리스크 대응: 클라우드 제공업체가 예고 없이 서비스를 종료하거나 API를 변경할 경우, 접근 불가 상태가 될 수 있습니다.
• 데이터 포터블성 확보: 마크다운 형식으로 변환된 데이터는 Obsidian, Typora, VS Code 등 다양한 에디터에서 즉시 활용 가능합니다.
• 지식 자산의 영속적 관리: 개인의 학습 및 업무 기록은 장기적으로 통합 관리되어야 하며, 특정 플랫폼에 종속되어서는 안 됩니다.

핵심 기능 요약

이 도구는 다음과 같은 기술적 특징을 갖추고 있습니다:

• 브라우저 세션 정보(Cookie 기반)를 이용한 비밀번호 없는 인증
• 계층형 폴더 구조 유지하며 로컬 디렉터리에 동기화
• 노트 본문을 일반화된 Markdown(.md) 형식으로 변환
• 첨부 이미지 처리 — 로컬 저장 또는 선택적으로 SM.MS 무료 이미지 호스팅으로 업로드

사용 절차 가이드

1단계: 실행 환경 설정

시스템에 Python 3와 Git이 설치되어 있어야 합니다. 이후 다음 명령어로 프로젝트를 복제합니다:

git clone https://gitcode.com/gh_mirrors/yo/youdaonote-pull.git
cd youdaonote-pull
pip install -r requirements.txt

2단계: 인증 및 옵션 구성

cookies.json 파일에 브라우저에서 추출한 유효한 세션 쿠키를 입력합니다. 아래는 예시입니다:

{
  "YNOTE_LOGIN_USER": "your_user_id",
  "YNOTE_SESS": "your_session_token"
}

또한 config.json에서 출력 경로 및 이미지 처리 방식을 지정할 수 있습니다:

{
  "local_dir": "/Users/name/Documents/youdao_backup",
  "ydnote_dir": "/",
  "image_handler": "local",  // 혹은 "smms"
  "relative_path_in_link": true
}

3단계: 백업 실행

설정 완료 후 단 한 줄의 명령어로 전체 데이터 동기화를 시작합니다:

python pull.py

실행 중에는 각 폴더와 노트의 다운로드 상태가 실시간으로 출력되며, 네트워크 오류 시 재시도 메커니즘이 자동으로 작동합니다.

개발자 관점에서의 가치

이 프로젝트는 다음과 같은 기술 요소를 포함하고 있어 학습용으로도 매우 유용합니다:

• HTTP 세션 유지 및 쿠키 기반 인증 구현
• RESTful API 역분석을 통한 웹 자동화
• XML/HTML 파싱과 마크다운 생성 로직 (lxml 및 html2text 활용)
• 파일 시스템 트리 구조 재현 알고리즘

장기적 활용 전략

이 도구는 단순한 일회성 내보내기가 아니라, 정기적인 동기화 작업으로 설정하여 자동화된 백업 시스템으로 발전시킬 수 있습니다. 예를 들어 Linux/macOS에서는 cron을, Windows에서는 작업 스케줄러를 통해 매주 자동 실행하도록 구성할 수 있습니다. 이를 통해 클라우드와 로컬 간 이중 저장소 구조를 구축함으로써 진정한 의미의 데이터 안정성을 확보할 수 있습니다.