Mail Importer for Gmail 使用教程
1、项目介绍
Mail Importer for Gmail 是一个开源项目,旨在将 Thunderbird 邮件存档上传到 Gmail,并尽可能保留邮件的阅读状态、标记状态和文件夹结构。该项目由 Google 维护,虽然它不是一个官方的 Google 产品,但它提供了一个方便的工具,帮助用户将旧的 Thunderbird 邮件迁移到 Gmail。
2、项目快速启动
环境准备
- Java 运行环境
- Maven 构建工具
- 一个 Google 开发者账号,用于获取 OAuth2 客户端密钥
快速启动步骤
-
克隆项目仓库
git clone https://github.com/google/mail-importer.git cd mail-importer
-
构建项目
mvn clean package assembly:single
-
获取客户端密钥
在 Google 开发者控制台创建一个项目,配置 OAuth2 客户端,下载生成的 JSON 文件(例如
client_secret_729820383-898athoe9t33ntohuoc.apps.googleusercontent.com.json
),并将其复制到src/main/resources/client_secret.json
。 -
运行 Mail Importer
java -jar target/mail-importer-1.0-SNAPSHOT-jar-with-dependencies.jar \ --mailbox /Users/me/Library/Thunderbird/my_profile/Mail/pop.csi.com
3、应用案例和最佳实践
应用案例
- 迁移旧邮件:如果你有从 AOL 或其他服务通过 POP3 下载的旧 Thunderbird 邮件存档,可以使用 Mail Importer 将这些邮件迁移到 Gmail。
- 备份和恢复:定期使用 Mail Importer 将 Thunderbird 邮件上传到 Gmail,作为邮件数据的备份。
最佳实践
- 定期运行:建议定期运行 Mail Importer,以确保所有新邮件都被上传到 Gmail。
- 错误处理:如果上传过程中出现问题,可以重新运行 Mail Importer,它会跳过已经上传的邮件。
4、典型生态项目
- import-mailbox-to-gmail:如果你需要批量导入 mbox 格式的文件到 Google Workspace,可以考虑使用这个工具。
- Thunderbird:Mail Importer 的主要输入源,确保你的 Thunderbird 邮件存档格式正确。
通过以上步骤和案例,你可以快速上手并有效使用 Mail Importer for Gmail 项目。