Fast Note Sync 이용 가이드

Fast Note Sync는 Obsidian 노트와 첨부파일을 여러 기기에서 동기화하는 서비스입니다.

로그인

1. jiminbox.com에 로그인합니다.
2. 왼쪽 사이드바의 서비스를 누릅니다.
3. Fast Note Sync를 누릅니다.
4. 로그인 화면에서 Login with Authentik을 누릅니다.

권장 로그인 방식

별도의 Fast Note Sync 비밀번호를 만들기보다 Jiminbox 통합 계정으로 로그인하는 Login with Authentik을 권장합니다.

로그인하면 대시보드가 열립니다. 왼쪽 메뉴에는 노트 저장소, 노트 관리, 휴지통, 백업 및 동기화, Git 자동화 설정이 있습니다.

시작 전 준비

Fast Note Sync는 Obsidian용 Fast Note Sync 플러그인과 Jiminbox의 Fast Note Sync 서비스가 함께 동작해야 합니다. 처음 연결할 때는 기존 볼트 전체를 여러 기기에 한꺼번에 열지 않고, 한 기기에서 작은 테스트부터 진행합니다.

1. 동기화하려는 볼트를 Obsidian에서 닫고, 볼트 폴더 전체를 다른 위치에 복사하거나 압축해 백업합니다. .obsidian 폴더를 포함한 전체 폴더를 보관해야 합니다.
2. 백업이 실제로 열리는지 확인하려면 복사본을 별도 이름의 테스트 볼트로 Obsidian에 추가합니다. 원본 볼트와 백업 폴더를 헷갈리지 않도록 이름을 구분합니다.
3. 같은 볼트 폴더를 iCloud, Dropbox, OneDrive, Obsidian Sync, 다른 동기화 플러그인 또는 Git 자동화로 동시에 동기화하고 있다면 첫 테스트 동안에는 해당 동기화를 일시 중지합니다. 여러 동기화 도구가 같은 파일을 동시에 바꾸면 충돌 원인을 구분하기 어렵습니다.
4. 첫 테스트에 사용할 기기 한 대만 남기고, 다른 기기의 Obsidian에서는 해당 볼트를 닫습니다. 첫 번째 테스트 노트와 첨부파일이 서버에 보이는 것을 확인한 뒤에만 다른 기기를 연결합니다.

백업과 충돌 방지

동기화는 백업을 대신하지 않습니다. 첫 동기화 전에는 볼트 전체를 별도로 보관하고, 같은 파일을 여러 기기에서 동시에 수정하지 마세요. 동기화가 끝났다는 표시를 확인하기 전에는 다음 기기에서 편집을 시작하지 않는 것이 안전합니다.

1. Obsidian 플러그인 설치

Obsidian 공식 안내의 커뮤니티 플러그인 설치 절차를 따라 설치합니다.

1. Obsidian에서 동기화할 볼트를 엽니다.
2. 설정을 열고 커뮤니티 플러그인으로 이동합니다.
3. 제한 모드가 켜져 있으면 커뮤니티 플러그인 켜기를 선택합니다. 커뮤니티 플러그인은 제3자 코드이므로, 신뢰할 수 있는 플러그인만 설치하세요.
4. 찾아보기를 선택하고 Fast Note Sync를 검색합니다.
5. Fast Note Sync 플러그인을 선택한 뒤 설치, 설치가 끝나면 활성화를 선택합니다.

현재 공개된 Fast Note Sync 플러그인 페이지에 플러그인이 표시되지 않거나 검색되지 않는 경우에만 수동 설치를 검토합니다.

1. 공식 Fast Note Sync 릴리스 페이지에서 릴리스를 확인합니다.
2. 릴리스에 포함된 main.js, styles.css, manifest.json을 내려받습니다. 출처가 불분명한 파일은 사용하지 마세요.
3. Obsidian 볼트의 .obsidian/plugins/fast-note-sync 폴더를 만들고 세 파일을 그 폴더에 넣습니다.
4. Obsidian을 다시 연 뒤 설정 → 커뮤니티 플러그인 → 설치된 플러그인에서 Fast Note Sync를 활성화합니다.

설치 화면이 다를 때

Obsidian 버전과 모바일·데스크톱 환경에 따라 메뉴 위치나 한국어 번역이 달라질 수 있습니다. 화면에 보이지 않는 버튼을 추측해 누르지 않고, 현재 화면의 메뉴명과 플러그인 이름을 먼저 확인합니다.

2. Jiminbox 서비스에서 연결 정보 확인

1. jiminbox.com에 로그인합니다.
2. 왼쪽 사이드바의 서비스에서 Fast Note Sync를 엽니다.
3. Fast Note Sync 로그인 화면이 나오면 Login with Authentik을 선택합니다.

로그인한 뒤 서비스의 볼트 관리 화면으로 이동합니다. Fast Note Sync의 공개 플러그인 안내에서는 이 화면을 Note Vaults라고 부르고, 볼트 화면에서 One-click Authorization for Obsidian을 선택해 Obsidian으로 인증 정보를 전달하도록 안내합니다.

가능하면 One-click Authorization for Obsidian을 사용합니다. 브라우저가 Obsidian을 열거나 인증 정보를 전달하면, Obsidian의 설정 → 커뮤니티 플러그인 → 설치된 플러그인에서 Fast Note Sync의 설정 화면을 열어 연결 완료 여부를 확인합니다.

원클릭 전달이 되지 않는 경우에는 서비스 화면에서 제공하는 인증 정보 복사 기능을 사용합니다. 복사한 값을 플러그인 설정의 서비스 인증 정보 입력란에 붙여 넣습니다. 서버 주소, 사용자 이름, 토큰을 임의로 조합하거나 직접 입력하지 않고, 현재 화면에 보이는 필드명과 안내에 따라 필요한 값만 입력합니다.

연결 정보 보호

인증 정보와 비밀번호는 화면 캡처, 공개 노트, Git 저장소, 이슈나 채팅에 넣지 마세요. 복사한 인증 정보가 노출되었다고 의심되면 동기화를 중단하고 서비스 화면에서 해당 인증 정보를 폐기하거나 다시 발급하는 방법을 현재 화면에서 확인하세요. 운영자에게 문의할 때는 인증 정보 대신 오류 메시지와 발생 시각만 전달합니다.

3. 첫 동기화 검증

연결을 저장한 뒤 바로 전체 볼트를 여러 기기에 열지 말고, 첫 번째 기기에서 아래 순서로 확인합니다.

1. 동기화할 볼트 안에 Fast Note Sync 연결 테스트처럼 식별하기 쉬운 테스트 노트를 새로 만듭니다. 테스트 내용에는 비밀번호, API 키, 개인 주소와 같은 민감한 정보를 넣지 않습니다.
2. 테스트 노트를 저장하고, 플러그인의 현재 상태 표시나 동기화 로그에서 업로드가 완료되었는지 확인합니다. 상태 아이콘, 문구, 로그 위치는 플러그인 버전에 따라 달라질 수 있으므로 현재 화면의 완료 표시를 확인합니다.
3. Jiminbox Fast Note Sync 웹 화면에서 같은 볼트를 열고 노트 관리 또는 노트 목록 화면에 테스트 노트가 나타나는지 확인합니다. 서버 화면의 실제 메뉴명과 검색 방법은 현재 화면에서 확인합니다.
4. 작은 이미지나 첨부파일 하나를 테스트 노트에 추가하고, 첨부파일도 서버 화면에 표시되거나 첫 번째 기기에서 동기화 완료로 확인되는지 점검합니다. 공개되면 안 되는 이미지는 사용하지 않습니다.
5. 첫 테스트 노트와 첨부파일이 서버에서 확인된 뒤에만 첫 번째 기기의 테스트 노트를 짧게 수정합니다. 수정 내용이 서버에 반영되는지 한 번 더 확인합니다.

첫 동기화 통과 기준

한 기기에서 만든 테스트 노트가 서버 화면에 보이고, 작은 첨부파일도 확인되며, 테스트 노트의 수정 내용이 다시 서버에 반영되면 첫 연결 검증을 통과한 것으로 봅니다. 상태 아이콘만 보고 성공으로 판단하지 않고 서버 화면에서도 파일을 확인합니다.

4. 다른 기기 연결과 충돌 방지

첫 번째 기기의 테스트가 통과한 뒤에만 두 번째 기기를 연결합니다.

1. 두 번째 기기에 Obsidian과 Fast Note Sync 플러그인을 설치합니다.
2. 두 번째 기기에서는 기존 볼트를 동기화 폴더로 바로 열지 않고, 별도의 새 볼트 또는 백업 복사본으로 시작할지 현재 플러그인 안내와 화면을 확인합니다. 원본과 백업을 구분할 수 있는 이름을 사용하고, 서비스에서는 첫 번째 기기에서 검증한 것과 같은 볼트를 선택했는지 확인합니다. 새 서비스 볼트를 만드는 절차와 버튼명은 현재 화면에서 확인합니다.
3. 첫 번째 기기에서 확인한 것과 같은 연결 정보를 두 번째 기기에 전달합니다. 인증 정보가 일반 텍스트로 노출된 경우에는 복사 후 클립보드와 임시 메모에서 즉시 지웁니다.
4. 두 번째 기기에서 서버의 테스트 노트가 내려온 것을 확인한 뒤에만 편집합니다. 한 기기에서 편집한 뒤에는 동기화 완료를 확인하고 다음 기기에서 편집합니다.
5. 두 기기에서 같은 노트를 동시에 열어 편집하지 않습니다. 오프라인 상태에서 여러 기기가 같은 파일을 바꾼 경우에는 충돌 파일을 임의로 삭제하거나 덮어쓰지 말고 먼저 동기화를 멈춥니다.

문제가 생겼을 때 중단하고 복원하기

노트가 사라지거나, 같은 파일의 복사본이 생기거나, 동기화가 계속 실패하면 다음 순서로 진행합니다.

1. 모든 기기에서 해당 볼트의 편집을 멈춥니다. 플러그인 설정에 동기화 일시 중지 또는 비활성화가 보이면 사용하고, 표시되지 않으면 Obsidian을 종료해 추가 변경을 막습니다.
2. 현재 상태의 볼트 전체를 별도 폴더에 한 번 더 복사합니다. 이 복사본은 복원 작업용으로 보관하고 바로 수정하지 않습니다.
3. 오류 메시지, 발생 시각, Obsidian 버전, 플러그인 버전, 사용한 기기와 운영체제를 기록합니다. 토큰, 비밀번호, 개인 주소, 실제 노트 본문은 기록하거나 보내지 않습니다.
4. 서버의 백업, 버전 기록, 휴지통에서 복원할 수 있는지 현재 화면에서 확인합니다. 복원 전에 목록과 날짜를 확인하고, 서버 파일을 일괄 삭제하거나 최신 파일로 덮어쓰지 마세요.
5. 로컬 백업으로 되돌려야 한다면 Obsidian을 종료한 상태에서 백업 복사본을 별도의 테스트 볼트로 먼저 열어 내용을 확인합니다. 확인이 끝난 뒤에만 작업용 볼트를 교체하고, 원래 문제가 발생한 폴더는 별도로 보관합니다.
6. 인증 정보가 노출되었거나 다른 사람이 볼 수 있었다면 동기화를 재개하지 말고 해당 인증 정보를 폐기·재발급할 수 있는 방법을 현재 서비스 화면에서 확인합니다.

임의 삭제 금지

충돌이 발생했을 때 서버의 노트나 휴지통을 먼저 비우거나, 어느 쪽이 최신인지 모르는 파일을 덮어쓰지 마세요. 중단한 뒤 백업과 오류 기록을 남기면 복원 가능성을 보존할 수 있습니다.

첫 연결 체크리스트

• .obsidian 폴더를 포함한 볼트 전체를 별도로 백업했습니다.
• 같은 볼트를 사용하는 다른 동기화 도구를 첫 테스트 동안 중지했습니다.
• Obsidian에 Fast Note Sync 플러그인을 설치하고 활성화했습니다.
• Jiminbox의 Fast Note Sync에서 연결 정보를 원클릭 전달하거나 현재 화면의 수동 입력 절차로 등록했습니다.
• 한 기기에서 민감하지 않은 테스트 노트가 서버 화면에 나타나는 것을 확인했습니다.
• 작은 테스트 첨부파일도 동기화되는지 확인했습니다.
• 테스트 노트의 수정 내용이 서버에 반영되는지 확인했습니다.
• 첫 번째 검증이 끝난 뒤에만 다른 기기를 연결하고, 동시 편집을 피하기로 했습니다.

다음 단계: Jiminbox 서비스 포털 이용 가이드 · Jiminbox 사용 정책