Mount App 도움말

Mount App은 원격 스토리지(SFTP·WebDAV·S3·Google Drive·Dropbox)를 macOS Finder에 일반 드라이브처럼 마운트합니다. 파일을 열고 저장하면 백그라운드로 원격에 동기화됩니다.

💡 처음이라면 빠른 시작부터 보세요. 3분이면 NAS를 Finder에 띄울 수 있습니다.

설치

Mount App을 설치하고 실행합니다. 메뉴바에 구름 아이콘 ☁️이 나타납니다.
실제 마운트에는 FUSE-T가 필요합니다(커널 익스텐션이 없는 NFS 기반, 재부팅 불필요). 설치되어 있지 않으면 마운트 시 안내됩니다.

빠른 시작

북마크 추가 — 사이드바의 + 추가 → 종류 선택 → 주소·계정 입력 → 저장.
(클라우드만) 계정 연결 — Google Drive·Dropbox는 계정 연결로 브라우저 로그인.
마운트 — 북마크 선택 후 마운트. Finder에 드라이브로 나타납니다.
사용 — Finder에서 파일을 열고/저장하면 자동으로 원격에 동기화됩니다.

북마크 추가

사이드바 + 추가에서 종류를 고르고 정보를 입력합니다. 비밀번호·토큰은 macOS Keychain에만 저장되며, 폼 → 앱 내부 → Keychain 외 다른 곳으로 나가지 않습니다.

종류	필요한 정보
SFTP	호스트, 포트(기본 22), 사용자, 비밀번호, 루트
WebDAV (HTTPS)	엔드포인트 URL, 사용자, 비밀번호, 루트
Amazon S3	버킷, 리전, (선택)엔드포인트, 액세스 키, 시크릿 키
Google Drive	Client ID — 추가 후 `계정 연결`로 OAuth 로그인
Dropbox	Client ID — 추가 후 `계정 연결`로 OAuth 로그인

예: Synology WebDAV → 엔드포인트 https://<호스트>:5006(또는 8006), 루트 /.

지원 스토리지

SFTP, WebDAV(HTTPS), Amazon S3 호환, Google Drive, Dropbox. HTTPS 백엔드는 rustls로 안전하게 연결합니다. 한글 등 유니코드 폴더명은 NFC로 정규화되어 그대로 표시됩니다.

마운트 / 해제

북마크를 선택하고 마운트를 누르면 Finder에 드라이브로 나타납니다. 메뉴바 구름 아이콘에서도 북마크별로 마운트/해제하거나 Finder에서 열기를 쓸 수 있습니다.

● 마운트됨 · ○ 연결됨(미마운트) · ◌ 연결 필요
해제는 같은 토글 또는 Finder에서 디스크 꺼내기로 가능합니다.

동기화 (업로드)

파일을 저장하면 즉시 로컬에 반영되고, 백그라운드 write-back 워커가 원격에 업로드합니다(보통 수 초). 일시적 네트워크 오류는 지수 백오프로 재시도하며, 끊긴 동안의 변경은 durable 큐에 안전하게 보관됐다가 재개됩니다.

메뉴바 헤더에 동기화 상태가 요약됩니다. 서버가 응답하지 않으면 ⏸ 동기화 일시정지로 표시되고, 복구되면 자동 재개됩니다.

충돌 해결

내가 편집하는 동안 같은 파일이 원격에서도 바뀌면 충돌로 감지됩니다. Mount App은 원격을 덮어쓰기 전에 원격본을 <파일>.conflict-<시각>으로 백업해 어느 쪽도 잃지 않게 합니다.

내 변경 유지 — 내 버전을 원격에 올립니다(백업된 원격본은 그대로 보존).
원격 유지 — 내 변경을 버리고 원격을 따릅니다.

충돌은 상세 화면의 충돌 카드 또는 메뉴바에서 확인·해결합니다.

메뉴바(트레이)

메뉴바 구름 아이콘을 클릭하면: 상단에 동기화 상태 요약, 북마크별 서브메뉴(마운트/해제 · Finder에서 열기), 그리고 열기 · 도움말 · 환경설정 · 정보 · 끝내기 푸터가 있습니다.

설정 · 캐시

우상단 톱니(⚙) → 설정에서 테마(시스템/라이트/다크), 캐시 한도(MB), 메타데이터 신선도(초)를 조정합니다. 상세 화면의 캐시 카드에서 사용량과 적중률(빠른 Finder의 핵심 지표)을 볼 수 있습니다.

CLI (mountapp)

GUI 없이 헤드리스로도 쓸 수 있습니다(GUI와 북마크 공유).

mountapp list                 # 북마크 목록
mountapp add sftp --name 내NAS --host h --user u   # 추가(비밀=MOUNTAPP_SECRET 환경변수)
mountapp mount 내NAS          # 마운트(Ctrl+C로 해제)
mountapp status               # 마운트 상태
mountapp sync 내NAS           # 대기·충돌·실패 건수
mountapp retry 내NAS          # 실패한 업로드 재시도
mountapp unmount 내NAS        # 해제

문제 해결

마운트해도 Finder에 안 보여요: FUSE-T가 설치돼 있는지 확인하세요. 처음 마운트는 연결에 수 초 걸릴 수 있습니다.
HTTPS 서버에 연결이 안 돼요: 엔드포인트 URL·포트·인증서를 확인하세요. 자체 서명 인증서는 현재 지원되지 않습니다(유효한 인증서 필요).
폴더 안 파일이 안 보여요 / 한글 폴더가 사라져요: 최신 버전으로 업데이트하세요(유니코드 정규화 개선 포함).
업로드가 멈춘 것 같아요: 메뉴바에서 ⏸ 일시정지 또는 충돌/실패 표시를 확인하세요. 실패 항목은 설정·CLI(mountapp retry)로 재시도할 수 있습니다.

보안 · 개인정보

비밀번호·토큰은 macOS Keychain에만 저장되고 로그에 남지 않습니다. 통신은 각 프로토콜의 암호화(SFTP/HTTPS)를 사용합니다. 파일 내용은 본인 기기와 본인이 지정한 원격 사이에서만 오갑니다.