개요
Syncthing은 중앙 서버 없이 로컬 장치 간 파일을 자동으로 동기화해주는 오픈소스 도구입니다.
이번 글에서는 macOS와 안드로이드 간에 Syncthing을 사용해 Logseq 데이터를 자동으로 동기화하는 방법을 단계별로 정리했습니다.
1. Syncthing 개념 이해
Syncthing은 다음과 같은 구조로 작동합니다.
- P2P 방식: 클라우드 서버를 거치지 않고, 장치 간 직접 연결
- 자동 동기화: 파일 변경 즉시 감지 및 전송
- 보안 연결: TLS 기반 암호화 통신, Device ID를 통한 승인된 장치만 연결 가능
즉, 같은 네트워크가 아니더라도 인터넷만 연결되어 있으면 언제든 파일을 동기화할 수 있습니다.
2. macOS에서 Syncthing 설치 및 실행
1) 설치
Homebrew를 이용해 Syncthing을 설치합니다.
brew install syncthing
2) 실행
syncthing
처음 실행하면 브라우저에서 Syncthing Web UI가 자동으로 열립니다.
기본 주소는 다음과 같습니다:
http://localhost:8384
3) 자동 실행 설정
맥을 켤 때 Syncthing이 자동으로 시작되게 하려면 아래 명령을 실행합니다.
brew services start syncthing
상태 확인은 아래와 같이 합니다.
brew services list
3. 안드로이드에서 Syncthing 설치 및 설정
1) 설치
Google Play 스토어나 F-Droid에서 Syncthing-Fork를 설치합니다.
(공식 Syncthing 앱보다 안정적이며 업데이트가 꾸준합니다.)
2) 권한 설정
앱 실행 후 다음 항목을 모두 허용합니다.
- 저장소 접근 허용
- 배터리 최적화 해제
- 백그라운드 실행 허용
- 부팅 시 자동 실행
이 과정을 거쳐야 장치가 꺼졌다 켜져도 동기화가 유지됩니다.
3) Device ID 등록
- 안드로이드 Syncthing 앱 → 메뉴 → “Show Device ID”
- macOS Web UI → “Add Remote Device” → 안드로이드 Device ID 입력
등록 후, 반대로 안드로이드에서도 macOS의 Device ID를 추가합니다.
4. Logseq 폴더 동기화 설정
1) Logseq 기본 폴더 확인
안드로이드에서 Logseq 앱을 실행하고 “Open local graph”를 선택해 현재 사용 중인 폴더 경로를 확인합니다.
일반적으로 아래와 같습니다.
/storage/emulated/0/Logseq
2) Syncthing 동기화 폴더 맞추기
macOS Syncthing Web UI에서 “Add Folder”를 클릭하고, 동기화할 폴더를 지정합니다.
예를 들어:
~/Documents/Logseq
안드로이드 Syncthing에서도 같은 Folder ID를 사용하고
동기화 경로를 Logseq이 사용하는 폴더(/storage/emulated/0/Logseq)로 설정합니다.
5. 권한 및 구조 점검
1) 권한 확인
안드로이드 설정에서 아래 항목을 모두 허용합니다.
- Syncthing → “모든 파일 접근 허용”
- Logseq → “모든 파일 접근 허용”
2) 폴더 구조 확인
Logseq 폴더는 아래처럼 되어 있어야 합니다.
/Logseq
├── config.edn
├── journals/
└── pages/
Syncthing이 상위 폴더 전체를 복제해서 /Logseq_sync/Logseq/pages/처럼 중첩되어 있으면 Logseq이 인식하지 못하니 주의해야 합니다.
6. 동기화 확인
양쪽 장치가 모두 실행 중이라면 Syncthing Web UI에서 다음 상태를 확인할 수 있습니다.
- Device Status → Connected
- Folder Status → Up to Date
안드로이드에서 Logseq을 열면 바로 macOS에서 작성한 내용이 반영되어 있을 것입니다.
반대로 모바일에서 편집한 노트도 자동으로 맥에 동기화됩니다.
7. 참고: 연결 구조
연결 형태가능 여부특징
| 같은 Wi-Fi | ✅ | LAN 직연결, 매우 빠름 |
| 다른 네트워크 | ✅ | 인터넷 경유, 자동 relay |
| 오프라인 | ❌ | 연결 복구 시 자동 재동기화 |
Syncthing은 글로벌 릴레이 서버를 통해 자동으로 경로를 찾아 연결하므로
별도의 포트 포워딩 없이도 대부분 자동 연결됩니다.
8. 동기화 오류 해결 팁
문제원인해결 방법
| “Disconnected” | 한쪽 기기 꺼짐 / 앱 중지 | 앱 실행 상태 확인 |
| 폴더 안 보임 | Folder ID 불일치 | 두 폴더의 ID 통일 |
| Logseq이 파일 인식 안 함 | 경로 불일치 | /storage/emulated/0/Logseq로 통일 |
| 느림 | Relay 연결 중 | 같은 Wi-Fi에서 최초 연결 후 재시도 |
마무리
Syncthing은 별도의 클라우드 없이 완전 자동으로 장치 간 파일을 맞춰줍니다.
Logseq 폴더를 정확히 맞춰두면, 언제 어디서나
맥에서 작성한 노트가 안드로이드에서도 그대로 이어집니다.
✔️ 정리:
- Syncthing은 자동 동기화
- 다른 네트워크에서도 작동
- Logseq은 폴더 권한 및 구조만 정확히 맞추면 인식됨
이제 인터넷만 연결되어 있으면 Logseq 노트를 양쪽에서 완벽히 이어 쓸 수 있습니다.