GitHub로 Obsidian 노트 저장소 동기화 방법: 사설 저장소를 위한 설정 가이드

1. 준비사항

다음 사항들을 미리 준비하세요:

  1. Obsidian 설치: 이미 컴퓨터 또는 모바일 기기에서 Obsidian가 설치되어 있습니다.
  2. Git 설치:
  • Windows: 에서 Git을 설치합니다.
  • Mac: Homebrew를 통해 설치 (brew install git).
  • Linux: 패키지 관리자를 통해 설치 (sudo apt-get install git for Debian/Ubuntu, sudo dnf install git for Fedora).
  1. GitHub 계정: GitHub 계정에 로그인할 수 있고 2FA가 활성화 되어 있습니다.
  2. 기본적인 이해: GitHub와 Obsidian의 기본 사용법에 익숙합니다.

2. 사설 GitHub 저장소 만들기

  1. GitHub에 로그인합니다.
  2. 새로운 저장소를 만듭니다:
  • 상단 우측의 "+" 아이콘을 클릭하고 New repository를 선택합니다.
  • 저장소 이름을 입력합니다. 예를 들어 my-private-notes라고 입력합니다.
  • Private을 선택하여 저장소를 사설로 설정합니다.
  • README 파일 등 기타 옵션은 미선택으로 두고 Create repository를 클릭합니다.
  1. 저장소 주소 저장:
  • 저장소가 생성되면 HTTPS 또는 SSH 주소 중 하나를 복사합니다. 예를 들어 https://github.com/your-username/my-private-notes.git와 같이 보입니다. HTTPS를 사용하는 것이 추천됩니다.

3. GitHub 액세스 토큰 생성

  1. GitHub 설정에 들어갑니다:
  • GitHub 페이지 상단 우측에서 프로필 아이콘을 클릭하고 Settings를 선택합니다.
  • 왼쪽 메뉴에서 Developer settings를 선택합니다.
  1. 액세스 토큰 생성:
  • Personal access tokens 섹션에서 Fine-grained tokens를 선택합니다.
  • 토큰 이름을 입력하고 만료일을 설정합니다.
  • Repository access에서 해당 저장소만 선택합니다.
  • Permissions에서 Contents 권한을 활성화합니다.
  • Generate token을 클릭합니다.

4. 로컬 Obsidian 저장소 초기화

  1. Obsidian Vault 선택 또는 생성:
  • Obsidian를 실행하고 Vault 폴더를 선택합니다. 없는 경우 새 Vault를 생성합니다.
  1. Git 저장소 초기화:
  • 터미널을 열고 Vault 폴더로 이동합니다.
cd ~/my-private-notes
git init
git remote add origin https://github.com/your-username/my-private-notes.git
  1. .gitignore 파일 작성(추천):
  • 저장소 루트에 .gitignore 파일을 만듭니다.
.obsidian/cache/
.obsidian/workspace.json
.obsidian/appearance.json
.trash/
  1. 최초 파일 커밋:
git add .
git commit -m "Initial commit"
git branch -m master main
git push -u origin main

5. Obsidian Git 플러그인 설치 및 설정

  1. 플러그인 설치:
  • Obsidian에서 Settings > Community plugins에 들어갑니다.
  • Safe mode를 해제하고 Obsidian Git을 검색한 후 설치하고 활성화합니다.
  1. 플러그인 설정:
  • Settings > Obsidian Git에 들어갑니다.
  • Vault backup interval을 설정합니다.
  • Commit message을 설정하고 Auto push를 활성화합니다.
  • Username과 Password에 GitHub 계정 정보를 입력합니다.

6. 다른 기기에서 동기화

  1. 저장소 클론:
git clone https://github.com/your-username/my-private-notes.git
  1. Vault 열기:
  • Obsidian에서 Open folder as vault를 선택하고 클론된 폴더를 지정합니다.

7. 고급 설정(선택사항)

  1. SSH 인증 사용:
  • SSH 키를 생성하고 GitHub에 등록합니다.
  • 원격 저장소 주소를 SSH 형식으로 변경합니다.
  1. 충돌 해결:
  • git pull --rebase를 사용하여 자동 해결을 시도합니다.
  • 수동으로 파일을 수정하고 커밋합니다.
  1. 성능 최적화:
  • 큰 저장소일 경우 .gitignore를 활용하고 파일을 분리하여 관리합니다.

태그: GitHub Obsidian Git Notes Synchronization

5월 28일 16:49에 게시됨

인기 태그

©2026 괴물 클럽