소개
Gmvault은 Gmail 계정의 메일을 로컬에 백업하고 필요할 때 복구할 수 있도록 돕는 오픈소스 명령줄 도구입니다. 개발자는 Guillaume Aubert이며, GNU AGPL v3 라이선스로 배포되고 Python으로 작성되었습니다. winget 패키지 매니페스트에는 gaubert.gmvault 패키지로 등재되어 있으며, 공식 홈페이지는 gmvault.org 입니다.
상세정보
Gmail 계정 전체 동기화
gmvault sync 계정@gmail.com 명령으로 계정의 모든 메일을 내려받습니다. 기본 저장 위치는 Linux/macOS에서 $HOME/gmvault-db, Windows에서 %HOME%/gmvault-db 입니다. 저장 경로는 -d 또는 --db-dir 옵션으로 변경할 수 있습니다.
증분 백업(빠른 동기화)
전체 백업 이후에는 gmvault sync -t quick 계정@gmail.com 형태로 증분 동기화를 수행하여 새 메일과 변경분만 빠르게 반영합니다.
XOAuth 및 비밀번호 인증 지원
기본 인증 방식은 XOAuth 토큰이며, 최초 인증 후에는 토큰이 $HOME/.gmvault에 저장되어 이후 실행 시 자동으로 재사용됩니다. XOAuth를 사용할 수 없는 환경에서는 --passwd 옵션으로 Gmail 로그인 비밀번호를 사용할 수 있으며, 비밀번호는 옵션에 따라 암호화 저장됩니다.
다른 Gmail 계정으로 복원
gmvault restore 새계정@gmail.com 명령으로 로컬 백업본을 다른 Gmail 계정에 업로드합니다. 다른 경로의 백업본을 복원할 때는 -d 옵션으로 저장소 위치를 지정합니다. --resume 또는 --restart 옵션으로 오류 발생 시 이어서 복원을 재개할 수 있습니다.
IMAP 기반 메일 접근
Gmail에 IMAP으로 접속하여 메시지를 가져오며, 별도의 데이터베이스 없이 파일 기반 저장소로 메일과 메타데이터를 보관합니다.
Windows 설치
winget을 사용하는 경우 winget install --id gaubert.gmvault --exact 명령으로 설치할 수 있습니다. 또는 Nullsoft 인스톨러를 내려받은 뒤 설치 후 데스크톱에 생성되는 gmvault-shell.bat을 실행하면 환경이 자동 설정됩니다.
Linux 및 macOS 설치
바이너리 tarball을 내려받아 압축을 해제하고 GMVAULT_HOME/bin 디렉터리에서 gmvault를 실행합니다.
소스 및 PyPI 설치
소스로 설치할 때는 저장소를 받은 뒤 python setup.py install을 실행합니다. PyPI에서는 pip install gmvault 또는 easy_install gmvault로 설치할 수 있습니다.
Gmvault은 어떤 라이선스로 배포되나요?
GNU AGPL-3.0 라이선스로 배포됩니다. 라이선스 전문은 GitHub 저장소의 LICENSE.txt에서 확인할 수 있습니다.
Windows에서 어떻게 설치하나요?
winget 매니페스트 gaubert.gmvault를 이용하거나 공식 사이트에서 배포하는 Windows 인스톨러를 내려받아 설치할 수 있습니다. 설치 후에는 gmvault-shell.bat을 실행해 환경을 맞춥니다.
백업한 메일을 다른 Gmail 계정으로 옮길 수 있나요?
gmvault restore 새계정@gmail.com 명령으로 로컬 백업본을 다른 Gmail 계정에 복원할 수 있습니다.
기본 인증 방식은 무엇인가요?
XOAuth 토큰 인증이 기본이며, 최초 인증 후에는 $HOME/.gmvault에 저장된 토큰이 이후 실행에서 자동으로 사용됩니다.
시스템 요구사항
- 설치 및 사용을 위해 Gmail 계정과 인터넷 연결이 필요합니다.
- 인증 방식은 XOAuth 토큰이 기본이며, 필요 시 --passwd 옵션으로 Gmail 로그인 비밀번호를 사용할 수 있습니다.
- Python으로 작성된 소스 기반 설치에는 Python 및 setuptools가 필요합니다.
- 라이선스: GNU AGPL-3.0.
- Windows용 설치 패키지는 Nullsoft(NSIS) 형식의 인스톨러로 제공됩니다.