macOS에 LocalSynapse 설치하기 (Gatekeeper 우회 방법)
LocalSynapse는 macOS 12 이상, Intel과 Apple Silicon Mac 모두에서 동작합니다. 다만 Apple Developer 인증서로 서명되지 않아서, 첫 실행 시 macOS Gatekeeper가 "LocalSynapse가 손상되어 열 수 없습니다" 또는 "개발자를 확인할 수 없습니다" 같은 메시지로 막을 수 있습니다. 안전하게 설치하는 방법을 정리합니다.
1단계 — 올바른 .dmg 다운로드
localsynapse.com에서 이메일을 입력하면 두 가지 macOS 다운로드 링크가 표시됩니다:
- macOS (Apple Silicon) — M1, M2, M3, M4 Mac (2020년 말 이후 판매된 대부분의 Mac).
- macOS (Intel) — 그 이전의 Intel Mac.
어느 쪽인지 모르겠다면 Apple 메뉴 → 이 Mac에 관하여를 누르세요. "Chip" 항목에 "Apple M1/M2/M3/M4"가 있으면 Apple Silicon 빌드, "Intel Core..."가 있으면 Intel 빌드입니다.
2단계 — .dmg 마운트 후 Applications로 드래그
다운로드한 .dmg 파일을 더블클릭하면 LocalSynapse 앱 아이콘과 Applications 폴더 단축키가 있는 창이 열립니다. 앱을 Applications 폴더로 드래그한 뒤 .dmg를 꺼내세요.
3단계 — 첫 실행: Gatekeeper 우회
여기서 많은 분이 막힙니다. 일반 앱처럼 더블클릭하면 macOS가 차단합니다. 두 가지 방법이 있습니다:
방법 A: Control+클릭 → 열기 (간단)
- Finder에서 Applications 폴더를 엽니다.
- LocalSynapse 아이콘을 Control+클릭 (또는 우클릭).
- 메뉴에서 열기를 선택.
- 경고 다이얼로그가 나오면 다시 열기를 클릭.
끝났습니다. macOS가 이제 앱을 신뢰하므로 다음부터는 일반적으로 실행할 수 있습니다.
방법 B: 터미널 (한 줄)
방법 A가 안 되거나 명령줄을 선호한다면, 터미널을 열고 실행하세요:
xattr -cr /Applications/LocalSynapse.app이 명령은 macOS가 인터넷에서 다운로드한 앱에 붙이는 quarantine 속성을 제거합니다. 실행 후에는 더블클릭으로 일반 실행이 가능합니다.
왜 Gatekeeper 경고가 뜨나요?
macOS Gatekeeper는 새로운 앱마다 두 가지를 확인합니다: 유효한 Developer ID 서명, 그리고 notarization (Apple이 멀웨어를 스캔). LocalSynapse는 현재 ad-hoc 코드 사이닝을 사용합니다 — 서명은 되어 있지만 Apple Developer ID가 아니어서, Gatekeeper가 첫 실행 시 신뢰하지 않은 것으로 처리합니다.
Apple Developer notarization은 연 99달러입니다. 우리는 무료 오픈소스 프로젝트이고, 그 비용을 사용자가 실제로 체감할 수 있는 곳에 쓰고 싶습니다. 위 방법들은 Gatekeeper가 자동으로 하는 일을 사용자가 직접 확인하고 신뢰하는 것과 기능적으로 동일합니다.
안전한가요?
LocalSynapse는 Apache 2.0 오픈소스입니다. 모든 코드를 github.com/LocalSynapse/LocalSynapse에서 확인할 수 있습니다. GitHub 릴리즈에는 SHA-256 체크섬 (SHA256SUMS-macOS.txt)이 포함되어 있어 다운로드한 파일이 빌드/배포된 것과 일치하는지 검증할 수 있습니다. 설치 후 검색 중에는 외부 네트워크 호출이 0건입니다.
시스템 요구사항
- macOS 12 (Monterey) 이상
- Apple Silicon (M1+) 또는 Intel (x64)
- RAM 8GB 권장 (4GB 최소)
- AI 모델 포함 약 500MB 디스크
설치 후에는 LocalSynapse가 홈 디렉토리를 스캔하여 백그라운드에서 검색 인덱스를 만듭니다. 파일명 검색은 즉시 가능하고, 내용 검색은 인덱싱 진행에 따라 사용 가능해집니다.