Joplin(https://joplinapp.org) 바로가기

Joplin 공식 FAQ가 밝힌 한계 — 잠금·백그라운드 동기화

Joplin은 무료 오픈소스 앱이고 라이선스는 AGPL-3.0 이상입니다. 다만 공식 FAQ가 직접 '지원하지 않는다', '불가능하다'고 적은 것들이 있어 먼저 알아야 합니다.

공식 FAQ는 휴대폰에서 일부 노트·노트북·태그가 안 보이는 원인으로 이 백그라운드 동기화 문제를 듭니다. 앱을 열어 둔 채로 동기화가 끝날 때까지 두어야 합니다.

동기화 폴더는 열린 형식이지만 공식 FAQ의 표현대로 '사실상 데이터베이스'입니다. 노트 제목으로 된 마크다운 파일이 차곡차곡 쌓이는 구조가 아니고, 이 방식은 바꾸지 않겠다고 밝혔습니다. 노트를 일반 파일로 꺼내려면 앱의 내보내기 기능을 씁니다.

데스크톱 앱을 비밀번호로 잠그는 기능은 아직 없고, 관련 요청은 공개 이슈로 열려 있습니다.

Joplin 설치 파일 고르기 — 데스크톱·포터블·모바일·터미널

Joplin은 데스크톱, 모바일, 터미널 세 종류가 있고 화면 구성이 비슷하며 서로 동기화됩니다. 최신 정식판은 3.7.21(2026년 9월 25일)입니다.

• Windows — 설치판 Joplin-Setup-버전.exe, 32·64비트
• Windows 포터블 — JoplinPortable.exe, USB에 복사해 실행
• macOS — 인텔용과 애플 칩(arm64)용 따로
• 리눅스 — 설치 스크립트 권장, AppImage·deb 파일도 있음
• 모바일 — 안드로이드(APK 직접 받기 가능), iOS
• 터미널 — Node 12 이상에서 npm으로 설치

포터블판은 실행 파일 옆에 JoplinProfile 폴더를 만들어 그 안에 자료를 둡니다.

리눅스에서 설치하는 순서는 이렇습니다.

1. 공식 설치 안내 화면의 설치 스크립트 명령을 터미널에 붙여 넣습니다.
2. 스크립트가 앱과 바탕화면 아이콘을 함께 설치합니다.
3. AppImage를 직접 받았다면 파일에 실행 권한을 줍니다.
4. 그래도 안 열리면 AppImage에 필요한 libfuse2 라이브러리가 있는지 확인합니다.

공식 FAQ는 예전 버전이 제대로 지워지지 않으면 Windows 설치가 멈출 수 있다고 보고, 레지스트리의 Uninstall 항목에서 DisplayName이 'Joplin x.x.x'인 폴더를 지우고 다시 설치하라고 안내합니다. 2.12 버전부터 애플 칩을 기본 지원하면서, 이 버전으로 올린 맥에서는 동기화·암호화 비밀번호를 다시 입력해야 합니다.

Joplin 동기화 대상과 WebDAV 주소 변경 주의

Joplin은 특정 회사에 묶이지 않도록 동기화 대상을 직접 고르게 되어 있습니다. 실행 중에는 내용이 바뀔 때마다 자동으로 동기화합니다.

• Joplin Cloud — 공식 유료 서비스, 웹 앱 포함
• WebDAV — 직접 운영하는 서버나 WebDAV 저장소
• S3 — S3 호환 저장소
• 클라우드 드라이브 — 앱이 지원하는 드라이브 서비스
• 로컬 폴더 — 컴퓨터의 파일 시스템
• 터미널 예약 — joplin sync 명령을 주기적으로 실행

가장 위험한 것은 WebDAV 주소 변경입니다. 새 주소에 기존 자료가 없으면 Joplin은 사용자가 모든 노트를 지웠다고 판단하고 컴퓨터에 있는 노트까지 지웁니다. 주소를 바꾸는 순서는 공식 FAQ에 이렇게 나옵니다.

1. JEX 형식으로 내보내 백업합니다.
2. 한 기기에서 마지막으로 동기화하고 앱을 닫습니다.
3. WebDAV에서 옛 위치의 Joplin 파일을 새 위치로 모두 복사합니다. 첨부가 든 .resource 폴더도 함께 복사합니다.
4. 앱을 열어 주소를 바꾸고 동기화해 확인합니다. 나머지 기기도 똑같이 합니다.

WebDAV 주소에는 노트를 둘 폴더 이름까지 붙여야 하고, 그 폴더는 직접 만들어 둬야 합니다. 저장소 쪽에 2단계 인증을 켜 두었다면 Joplin용 앱 비밀번호를 따로 만들어 넣습니다.

Joplin 종단간 암호화 켜는 순서와 비밀번호

Joplin은 모든 앱에서 종단간 암호화(E2EE)를 지원합니다. 켜면 개발자나 저장소 회사도 노트를 읽을 수 없습니다. 다만 켜는 순서가 정해져 있습니다.

• 처음 켜는 기기 — 한 대만, 데스크톱·터미널 권장
• 마스터 비밀번호 — 복구 불가
• 첫 동기화 — 전체를 다시 올려 오래 걸림, 취소 금지
• 다른 기기 — 동기화하면 마스터 키를 받아 비밀번호 입력
• 동시에 켜기 — 금지, 키가 여러 개 생김
• 끄기 — 기기마다 하나씩 끄고 동기화

암호화를 켜는 순서는 이렇습니다.

1. 첫 기기의 암호화 설정 화면(Encryption Configuration)에서 Enable encryption을 누릅니다.
2. 마스터 비밀번호를 정합니다. 보안상 다시 찾을 수 없습니다.
3. 진행 중인 동기화가 끝나면 Synchronise를 눌러 전체를 암호화해 올립니다. 멈춘 것처럼 보여도 취소하지 않습니다.
4. 다음 기기에서 동기화하고, 마스터 키 비밀번호를 넣은 뒤 한 번 더 동기화합니다. 기기마다 반복합니다.

암호화와 복호화를 계속하므로 약간의 부담이 생긴다고 공식 문서가 적고 있습니다. 모든 기기가 맞춰진 뒤에도 가끔 암호화된 항목이 보이는데, 백그라운드에서 풀린다고 안내합니다.

Joplin Cloud 요금제와 14일 무료체험

Joplin Cloud는 Joplin 전용 동기화 서비스입니다. 요금은 유로로 표시되고, 연 결제가 조금 쌉니다.

• Basic — 월 2.99유로 · 연 28.69유로 · 2GB · 파일당 10MB
• Pro — 월 5.99유로 · 연 57.48유로 · 30GB · 파일당 200MB
• Pro 100GB — 월 9.99유로 · 연 95.88유로 · 100GB
• Teams — 사용자당 월 7.99유로 · 최소 2명 · 50GB
• 무료체험 — 14일, 체험 중 해지하면 청구 없음
• 교육 할인 — 학생·교사 50%, 학교 이메일로 문의

모든 요금제에서 기기 수 제한 없이 동기화하고, 노트를 인터넷에 공개하고, 웹 앱(app.joplincloud.com)으로 볼 수 있습니다. Basic은 내 노트북을 남에게 공유할 수 없고, 남이 공유한 노트북을 함께 편집하는 것만 됩니다. 이메일을 노트로 저장하는 기능도 Pro 이상입니다.

노트 하나나 첨부 하나가 Basic은 10MB, 나머지 요금제는 200MB까지입니다. 서버는 프랑스 파리에 있습니다. 교육 할인은 1년 동안 유효하고, 재학·재직 중이면 다시 연락해 연장합니다.

회사가 직접 서버를 두는 Joplin Server Business는 연 결제로, 2~10명은 사용자당 월 3.33유로입니다.

Joplin 지운 노트 복구와 동기화 상태 확인

노트를 실수로 지웠거나 동기화가 끝났는지 헷갈릴 때 쓰는 기능입니다.

• 동기화 상태(데스크톱) — 도움말 → Synchronisation Status
• 동기화 상태(모바일) — Configuration → Tools → SYNC STATUS
• 완료 기준 — total items와 synced items가 같음
• 기기끼리 비교 — 모든 기기의 total items가 같아야 함
• 지운 노트 복구 — 노트 기록 켜져 있으면 restoreNoteRevision
• 복구 위치 — 'Restored Note' 노트북

지운 노트를 되살리는 순서는 이렇습니다.

1. 노트 기록(note history) 기능이 켜져 있었는지 확인합니다.
2. 명령 팔레트를 열고 restoreNoteRevision 뒤에 노트 ID를 붙여 실행합니다.
3. 성공하면 'Restored Note' 노트북에 노트가 생깁니다.
4. 노트 ID를 모르면 데이터베이스 사본을 만든 뒤 deleted_items·revisions 표에서 찾습니다.

데이터베이스를 직접 볼 때는 실제 파일을 건드리지 말고 사본을 먼저 만들라고 공식 FAQ가 적고 있습니다. 다른 메모 앱에서 노트를 많이 가져오면 첫 동기화가 매우 오래 걸릴 수 있습니다.