gdrive

<img src="https://yellow-cdn.veclightyear.com/ab5030c0/028e9ab5-c0fd-4c37-af1f-bd5ba3909c94.png" width="100">

概览

gdrive是一个命令行应用程序,用于与Google Drive进行交互。这是gdrive2的继任者,尽管目前只实现了最基本的功能。

社区

加入我们的discord服务器讨论所有关于gdrive的话题。

赞助

帮助保持这个项目的活跃。通过赞助gdrive等级,你将帮助支持:

• 跟上API的更新
• 新功能的开发
• 修复和回答问题
• 编写指南和文档

入门

要求

• Google OAuth客户端凭证,参见文档

安装可执行文件

• 从发行版部分下载最新的可执行文件
• 解压缩并将可执行文件放在PATH目录中(即Linux和macOS上的/usr/local/bin)
• 注意,该可执行文件没有代码签名,在Windows和macOS上运行时会引起警告。稍后会解决这个问题,但现在可以通过您最喜欢的搜索引擎找到解决方法。

将Google帐户添加到gdrive

• 运行gdrive account add
• 这将提示您输入Google客户端ID和客户端密钥(请参见要求)
• 接下来您将看到一个URL
• 访问该URL并授予gdrive访问您的Drive的权限
• 您将被重定向到http://localhost:8085(gdrive启动了一个临时Web服务器),这完成了设置
• 现在gdrive可以使用了!

在远程服务器上使用gdrive

将帐户添加到gdrive的过程的一部分要求您的Web浏览器访问运行gdrive的机器上的localhost:8085。 这使得在远程服务器上设置帐户变得很困难。 建议的解决方法是在本地机器上添加帐户,然后在远程服务器上导入:

1. [本地] 运行gdrive account add
2. [本地] 运行gdrive account export <ACCOUNT_NAME>
3. [本地] 将导出的存档复制到远程服务器
4. [远程] 运行gdrive account import <ARCHIVE_PATH>

凭据

Gdrive将您的帐户凭据和令牌保存在$HOME/.config/gdrive3/下。 通常您不需要直接使用这些文件,但如果有人访问这些文件,他们也将能够访问您的Google Drive。请妥善保管这些文件。

在云中的虚拟机上使用gdrive

从某些云提供商那里与Drive API通信存在一些问题。 例如,在AWS实例上上传时,API会返回大量的429 Too Many Requests/503 Service Unavailable/502 Bad Gateway错误。 而同样的文件在Linode实例上却可以没有任何错误地上传。 Gdrive内置了重试逻辑来处理这些错误,但这可能会显著减慢上传速度。 要检查您是否受到这些错误的影响,可以运行upload命令并加上这些标志:--print-chunk-errors --print-chunk-info。