格姆金库

Gmvault：备份和恢复您的 Gmail 帐户

Gmvault 是一款用于备份您的 Gmail 帐户并永远不会丢失电子邮件通信的工具。 Gmvault 是开源的并且在 GNU-AGPL-3.0 下。

欲了解更多信息，请访问 [gmvault.org] (http://gmvault.org)

贡献

• 检查未解决的问题或打开新问题以围绕功能想法或错误开始讨论。对于那些还不太熟悉代码库的人来说，问题将会有一个贡献者友好的标签。
• 在 Github 上分叉存储库以开始对master分支（或其分支）进行更改。
• 编写一个测试，显示错误已修复或功能按预期工作。
• 发送拉取请求并向维护者发出错误，直到它被合并并发布。 :) 确保将您自己添加为作者。

快速入门

安装

您可以从 (http://gmvault.org/download.html) 下载适合您选择的平台的“二进制”发行版之一。您还可以从 (github.com/gaubert/gmvault) 的源代码安装该软件。

Windows安装

安装后启动 gmvault-shell.bat （桌面上应该有一个快捷方式）。 shell 设置环境，以便您可以无缝启动 gmvault。

前往 gmvault 2 分钟开始学习如何驾驶 gmvault。

Linux 和 Mac OS X 安装

解压二进制 tarball 发行版并转到 GMVAULT_HOME/bin 目录以启动 gmvault。

从源安装

python setup.py 安装

从 PyPi 安装

 pip install gmvault

或者

 easy_install gmvault

gmvault 2 分钟开始

Gmvault 是一个用户友好的命令行工具。它试图将所有必要的默认值设置为不言自明的。

验证

Gmvault 允许用户使用 XOAuth 令牌或您的 Gmail 登录密码。 XOAuth 身份验证是访问您帐户的推荐方式。该方法默认激活。对给定帐户进行首次身份验证后，XOAuth 令牌存储在 $HOME/.gmvault 中，并将用于后续身份验证。

以下示例使用 XOAuth 访问 [email protected] $>gmvaultsync [email protected]

使用 --passwd 选项，您可以使用 Gmail 登录名和密码进行快速测试，或者如果您无法使用 XOAuth。然后，您将进入交互式会话以输入密码。默认情况下，您的密码不会保存，但您可以使用该选项来保存。您的密码将被加密存储，但请尽可能避免使用此选项。

备份您的电子邮件

完全同步：

$>gmvault 同步 [email protected]

增量同步：

$>gmvault 同步 -t 快速 [email protected]

默认情况下，电子邮件备份在 $HOME/gmvault-db （或 %HOME%/gmvault-db for Win）中。使用 -d DB_DIR, --db-dir DB_DIR 更改本地电子邮件存储库的位置

恢复 Gmail 帐户中的电子邮件

$>gmvault 恢复 [email protected]

将在 [email protected] 中恢复 $HOME/gmvault-db （或 %HOME%/gmvault-db for Win）

$>gmvault 恢复 [email protected] -d /backup/emails-db

将在 [email protected] 中恢复 /backup/emails-db

使用 --resume 或 --restart 从最后一个致命错误重新启动，并且不再重新上传已处理的电子邮件。

$>gmvault 恢复 [email protected] --restart